de.espirit.firstspirit.ui.gadgets.aspects.transfer

Interface HandlerHost

public interface HandlerHost

Host that dispatches transfers to registered handlers in a bulk manner, i.e., if the targeted object is registered, and any of the types to be handled are supported by a transfer, all registered types' data will be resolved and handed to the handler for further processing.

The host provides special treatments to different kind of targets:

• If the target is a gadget object, programmatic transfers will be possible.
• If the target is a graphical component, it will be registered for drop operations.

For validating transfer objects in depth use the aspect TransferValidating.

Since:

4.2.426

See Also:

TransferHandling

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	HandlerHost.Handler A transfer handler.

Method Summary

Methods

Modifier and Type	Method and Description
void	registerGadgetHandler(HandlerHost.Handler handler, Collection<TransferType<?>> types) Registers a handler to the gadget as drop target receiving all transfer type-mapped commodities.
void	registerHandler(Component dropTarget, HandlerHost.Handler handler, Collection<TransferType<?>> types) Registers a handler receiving all transfer type-mapped commodities.
void	registerHandler(Component dropTarget, HandlerHost.Handler handler, TransferType<?>... types) Registers a handler receiving all transfer type-mapped commodities.

Method Detail

registerHandler

void registerHandler(@NotNull
                   Component dropTarget,
                   @NotNull
                   HandlerHost.Handler handler,
                   @NotNull
                   TransferType<?>... types)

Registers a handler receiving all transfer type-mapped commodities.

Parameters:

dropTarget - The component to register as drop target.

handler - The handler to be registered.

types - The transfer types to be handled by the given handler.

Since:

4.2.426

registerHandler

void registerHandler(@NotNull
                   Component dropTarget,
                   @NotNull
                   HandlerHost.Handler handler,
                   @NotNull
                   Collection<TransferType<?>> types)

Registers a handler receiving all transfer type-mapped commodities.

Parameters:

dropTarget - The component to register as drop target.

handler - The handler to be registered.

types - The transfer types to be handled by the given handler.

Since:

4.2.426

registerGadgetHandler

void registerGadgetHandler(@NotNull
                         HandlerHost.Handler handler,
                         @NotNull
                         Collection<TransferType<?>> types)

Registers a handler to the gadget as drop target receiving all transfer type-mapped commodities.

Parameters:

handler - The handler to be registered.

types - The transfer types to be handled by the given handler.

Since:

5.0.12