Package io.vertx.mutiny.ext.web.handler

Class StaticHandler

java.lang.Object
io.vertx.mutiny.ext.web.handler.StaticHandler
All Implemented Interfaces:
MutinyDelegate, io.vertx.core.Handler<RoutingContext>, Consumer<RoutingContext>
public class StaticHandler extends Object implements MutinyDelegate, io.vertx.core.Handler<RoutingContext>, Consumer<RoutingContext>
A handler for serving static resources from the file system or classpath.

NOTE: This class has been automatically generated from the original non Mutiny-ified interface using Vert.x codegen.

  • Field Details

    • __TYPE_ARG

      public static final TypeArg<StaticHandler> __TYPE_ARG

    • DEFAULT_WEB_ROOT

      public static final String DEFAULT_WEB_ROOT
      Default value of the web-root, where files are served from
      See Also:

    • DEFAULT_FILES_READ_ONLY

      public static final boolean DEFAULT_FILES_READ_ONLY
      Default value of whether files are read -only and never will be updated
      See Also:

    • DEFAULT_MAX_AGE_SECONDS

      public static final long DEFAULT_MAX_AGE_SECONDS
      Default max age for cache headers
      See Also:

    • DEFAULT_CACHING_ENABLED

      public static final boolean DEFAULT_CACHING_ENABLED
      Default of whether cache header handling is enabled

    • DEFAULT_DIRECTORY_LISTING

      public static final boolean DEFAULT_DIRECTORY_LISTING
      Default of whether directory listing is enabled
      See Also:

    • DEFAULT_DIRECTORY_TEMPLATE

      public static final String DEFAULT_DIRECTORY_TEMPLATE
      Default template file to use for directory listing
      See Also:

    • DEFAULT_INCLUDE_HIDDEN

      public static final boolean DEFAULT_INCLUDE_HIDDEN
      Default of whether hidden files can be served
      See Also:

    • DEFAULT_CACHE_ENTRY_TIMEOUT

      public static final long DEFAULT_CACHE_ENTRY_TIMEOUT
      Default cache entry timeout, when caching
      See Also:

    • DEFAULT_INDEX_PAGE

      public static final String DEFAULT_INDEX_PAGE
      The default index page
      See Also:

    • DEFAULT_MAX_CACHE_SIZE

      public static final int DEFAULT_MAX_CACHE_SIZE
      The default max cache size
      See Also:

    • DEFAULT_ALWAYS_ASYNC_FS

      public static final boolean DEFAULT_ALWAYS_ASYNC_FS
      Default of whether async filesystem access should always be used
      See Also:

    • DEFAULT_ENABLE_FS_TUNING

      public static final boolean DEFAULT_ENABLE_FS_TUNING
      Default of whether fs async/sync tuning should be used
      See Also:

    • DEFAULT_MAX_AVG_SERVE_TIME_NS

      public static final long DEFAULT_MAX_AVG_SERVE_TIME_NS
      Default max avg serve time, in ns, over which serving will be considered slow
      See Also:

    • DEFAULT_RANGE_SUPPORT

      public static final boolean DEFAULT_RANGE_SUPPORT
      Default of whether Range request handling support should be used
      See Also:

    • DEFAULT_ROOT_FILESYSTEM_ACCESS

      public static final boolean DEFAULT_ROOT_FILESYSTEM_ACCESS
      Default of whether access to the root of the file system should be allowed or just allow from the current working directory.
      See Also:

    • DEFAULT_SEND_VARY_HEADER

      public static final boolean DEFAULT_SEND_VARY_HEADER
      Default of whether vary header should be sent.
      See Also:

  • Constructor Details

    • StaticHandler

      public StaticHandler(io.vertx.ext.web.handler.StaticHandler delegate)

    • StaticHandler

      public StaticHandler(Object delegate)

  • Method Details

    • getDelegate

      public io.vertx.ext.web.handler.StaticHandler getDelegate()
      Specified by:
      getDelegate in interface MutinyDelegate
      Returns:
      the delegate used by this Mutiny object of generated type

    • toString

      public String toString()
      Overrides:
      toString in class Object

    • equals

      public boolean equals(Object o)
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • handle

      public void handle(RoutingContext arg0)
      Specified by:
      handle in interface io.vertx.core.Handler<RoutingContext>

    • create

      public static StaticHandler create()
      Returns:
      the handler

    • create

      public static StaticHandler create(String root)
      Parameters:
      root - the web-root
      Returns:
      the handler

    • create

      public static StaticHandler create(io.vertx.ext.web.handler.FileSystemAccess handlerVisibility, String root)
      Parameters:
      handlerVisibility - CWD or file system root
      root - the web-root
      Returns:
      the handler

    • setAllowRootFileSystemAccess

      @Deprecated public StaticHandler setAllowRootFileSystemAccess(boolean allowRootFileSystemAccess)
      Deprecated.
      Parameters:
      allowRootFileSystemAccess - whether root access is allowed
      Returns:
      a reference to this, so the API can be used fluently

    • setWebRoot

      @Deprecated public StaticHandler setWebRoot(String webRoot)
      Deprecated.
      Parameters:
      webRoot - the web root
      Returns:
      a reference to this, so the API can be used fluently

    • setFilesReadOnly

      public StaticHandler setFilesReadOnly(boolean readOnly)
      Parameters:
      readOnly - whether files are read-only
      Returns:
      a reference to this, so the API can be used fluently

    • setMaxAgeSeconds

      public StaticHandler setMaxAgeSeconds(long maxAgeSeconds)
      Parameters:
      maxAgeSeconds - maximum time for browser to cache, in seconds
      Returns:
      a reference to this, so the API can be used fluently

    • setCachingEnabled

      public StaticHandler setCachingEnabled(boolean enabled)
      Parameters:
      enabled - true if enabled
      Returns:
      a reference to this, so the API can be used fluently

    • setDirectoryListing

      public StaticHandler setDirectoryListing(boolean directoryListing)
      Parameters:
      directoryListing - true if enabled
      Returns:
      a reference to this, so the API can be used fluently

    • setIncludeHidden

      public StaticHandler setIncludeHidden(boolean includeHidden)
      Parameters:
      includeHidden - true if hidden files should be served
      Returns:
      a reference to this, so the API can be used fluently

    • setCacheEntryTimeout

      public StaticHandler setCacheEntryTimeout(long timeout)
      Parameters:
      timeout - the timeout, in ms
      Returns:
      a reference to this, so the API can be used fluently

    • setIndexPage

      public StaticHandler setIndexPage(String indexPage)
      Parameters:
      indexPage - the index page
      Returns:
      a reference to this, so the API can be used fluently

    • setMaxCacheSize

      public StaticHandler setMaxCacheSize(int maxCacheSize)
      Parameters:
      maxCacheSize - the max cache size
      Returns:
      a reference to this, so the API can be used fluently

    • setHttp2PushMapping

      public StaticHandler setHttp2PushMapping(List<io.vertx.ext.web.Http2PushMapping> http2PushMappings)
      Parameters:
      http2PushMappings - the mapping for http2 push
      Returns:
      a reference to this, so the API can be used fluently

    • skipCompressionForMediaTypes

      public StaticHandler skipCompressionForMediaTypes(Set<String> mediaTypes)
      Parameters:
      mediaTypes - the set of mime types that are already compressed
      Returns:
      a reference to this, so the API can be used fluently

    • skipCompressionForSuffixes

      public StaticHandler skipCompressionForSuffixes(Set<String> fileSuffixes)
      Parameters:
      fileSuffixes - the set of file suffixes that are already compressed
      Returns:
      a reference to this, so the API can be used fluently

    • setAlwaysAsyncFS

      public StaticHandler setAlwaysAsyncFS(boolean alwaysAsyncFS)
      Parameters:
      alwaysAsyncFS - true for always async FS access
      Returns:
      a reference to this, so the API can be used fluently

    • setEnableFSTuning

      public StaticHandler setEnableFSTuning(boolean enableFSTuning)
      Parameters:
      enableFSTuning - true to enabled FS tuning
      Returns:
      a reference to this, so the API can be used fluently

    • setMaxAvgServeTimeNs

      public StaticHandler setMaxAvgServeTimeNs(long maxAvgServeTimeNanoSeconds)
      Parameters:
      maxAvgServeTimeNanoSeconds - max serve time, in ns
      Returns:
      a reference to this, so the API can be used fluently

    • setDirectoryTemplate

      public StaticHandler setDirectoryTemplate(String directoryTemplate)
      Parameters:
      directoryTemplate - the directory template
      Returns:
      a reference to this, so the API can be used fluently

    • setEnableRangeSupport

      public StaticHandler setEnableRangeSupport(boolean enableRangeSupport)
      Parameters:
      enableRangeSupport - true to enable range support
      Returns:
      a reference to this, so the API can be used fluently

    • setSendVaryHeader

      public StaticHandler setSendVaryHeader(boolean varyHeader)
      Parameters:
      varyHeader - true to sent vary header
      Returns:
      a reference to this, so the API can be used fluently

    • setDefaultContentEncoding

      public StaticHandler setDefaultContentEncoding(String contentEncoding)
      Parameters:
      contentEncoding - the desired content encoding e.g.: "UTF-8"
      Returns:
      a reference to this, so the API can be used fluently

    • accept

      public void accept(RoutingContext item)
      Specified by:
      accept in interface Consumer<RoutingContext>

    • newInstance

      public static StaticHandler newInstance(io.vertx.ext.web.handler.StaticHandler arg)