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:
  • Method Details

    • registerHandler

      void registerHandler(@NotNull @NotNull Component dropTarget, @NotNull @NotNull HandlerHost.Handler handler, @NotNull @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 @NotNull Component dropTarget, @NotNull @NotNull HandlerHost.Handler handler, @NotNull @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 @NotNull HandlerHost.Handler handler, @NotNull @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