Interface ElementRequestHandler

All Superinterfaces:
Serializable
All Known Subinterfaces:
DownloadHandler, UploadHandler
All Known Implementing Classes:
AbstractDownloadHandler, AbstractFileUploadHandler, ClassDownloadHandler, FileDownloadHandler, FileUploadHandler, InMemoryUploadHandler, InputStreamDownloadHandler, ServletResourceDownloadHandler, TemporaryFileUploadHandler
Functional Interface:
This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface public interface ElementRequestHandler extends Serializable
Request handler callback for handing client-server or server-client data transfer scoped to a specific (owner) element.
  • Method Summary

    Modifier and Type
    Method
    Description
    Controls whether request handler is invoked when the owner element is disabled.
    default String
    Optional URL postfix allows appending an application-controlled string, e.g.
    void
    handleRequest(VaadinRequest request, VaadinResponse response, VaadinSession session, Element owner)
    Request handler callback for handing client-server or server-client data transfer scoped to a specific (owner) element.
    default boolean
    Whether to invoke this request handler even if the owning element is currently inert.
  • Method Details

    • handleRequest

      void handleRequest(VaadinRequest request, VaadinResponse response, VaadinSession session, Element owner) throws IOException
      Request handler callback for handing client-server or server-client data transfer scoped to a specific (owner) element. Note: when handling requests via this API, you need to take care of typical stream handling issues, e.g. exceptions yourself. However, you do not need to close the stream yourself, Flow will handle that for you when needed.
      Parameters:
      request - VaadinRequest request to handle
      response - VaadinResponse response to handle
      session - VaadinSession current VaadinSession
      owner - Element owner element
      Throws:
      IOException - if an IO error occurred during data transfer
    • getUrlPostfix

      default String getUrlPostfix()
      Optional URL postfix allows appending an application-controlled string, e.g. the logical name of the target file, to the end of the otherwise random-looking download URL. If defined, requests that would otherwise be routable are still rejected if the postfix is missing or invalid. Postfix changes the last segment in the resource url.
      Returns:
      String optional URL postfix, or null for "".
    • isAllowInert

      default boolean isAllowInert()
      Whether to invoke this request handler even if the owning element is currently inert.
      Returns:
      true to invoke for inert elements, false otherwise. Defaults to false.
    • getDisabledUpdateMode

      default DisabledUpdateMode getDisabledUpdateMode()
      Controls whether request handler is invoked when the owner element is disabled.
      Returns:
      the currently set DisabledUpdateMode for this request handler. Defaults to ONLY_WHEN_ENABLED.