Class: StaticHandler

vertx-web-js/static_handler~ StaticHandler

new StaticHandler()

A handler for serving static resources from the file system or classpath.
Source:

Methods

handle(event)

Something has happened, so handle it.
Parameters:
Name Type Description
event RoutingContext the event to handle
Source:

setAllowRootFileSystemAccess(allowRootFileSystemAccess) → {StaticHandler}

Enable/Disable access to the root of the filesystem
Parameters:
Name Type Description
allowRootFileSystemAccess boolean whether root access is allowed
Source:
Returns:
a reference to this, so the API can be used fluently
Type
StaticHandler

setAlwaysAsyncFS(alwaysAsyncFS) → {StaticHandler}

Set whether async filesystem access should always be used
Parameters:
Name Type Description
alwaysAsyncFS boolean true for always async FS access
Source:
Returns:
a reference to this, so the API can be used fluently
Type
StaticHandler

setCacheEntryTimeout(timeout) → {StaticHandler}

Set the server cache entry timeout when caching is enabled
Parameters:
Name Type Description
timeout number the timeout, in ms
Source:
Returns:
a reference to this, so the API can be used fluently
Type
StaticHandler

setCachingEnabled(enabled) → {StaticHandler}

Set whether cache header handling is enabled
Parameters:
Name Type Description
enabled boolean true if enabled
Source:
Returns:
a reference to this, so the API can be used fluently
Type
StaticHandler

setDefaultContentEncoding(contentEncoding) → {StaticHandler}

Set the default content encoding for text related files. This allows overriding the system settings default value.
Parameters:
Name Type Description
contentEncoding string the desired content encoding e.g.: "UTF-8"
Source:
Returns:
a reference to this, so the API can be used fluently
Type
StaticHandler

setDirectoryListing(directoryListing) → {StaticHandler}

Set whether directory listing is enabled
Parameters:
Name Type Description
directoryListing boolean true if enabled
Source:
Returns:
a reference to this, so the API can be used fluently
Type
StaticHandler

setDirectoryTemplate(directoryTemplate) → {StaticHandler}

Set the directory template to be used when directory listing
Parameters:
Name Type Description
directoryTemplate string the directory template
Source:
Returns:
a reference to this, so the API can be used fluently
Type
StaticHandler

setEnableFSTuning(enableFSTuning) → {StaticHandler}

Set whether async/sync filesystem tuning should enabled
Parameters:
Name Type Description
enableFSTuning boolean true to enabled FS tuning
Source:
Returns:
a reference to this, so the API can be used fluently
Type
StaticHandler

setEnableRangeSupport(enableRangeSupport) → {StaticHandler}

Set whether range requests (resumable downloads; media streaming) should be enabled.
Parameters:
Name Type Description
enableRangeSupport boolean true to enable range support
Source:
Returns:
a reference to this, so the API can be used fluently
Type
StaticHandler

setFilesReadOnly(readOnly) → {StaticHandler}

Set whether files are read-only and will never change
Parameters:
Name Type Description
readOnly boolean whether files are read-only
Source:
Returns:
a reference to this, so the API can be used fluently
Type
StaticHandler

setHttp2PushMapping(http2PushMappings) → {StaticHandler}

Set the file mapping for http2push and link preload
Parameters:
Name Type Description
http2PushMappings Array.<Object> the mapping for http2 push
Source:
Returns:
a reference to this, so the API can be used fluently
Type
StaticHandler

setIncludeHidden(includeHidden) → {StaticHandler}

Set whether hidden files should be served
Parameters:
Name Type Description
includeHidden boolean true if hidden files should be served
Source:
Returns:
a reference to this, so the API can be used fluently
Type
StaticHandler

setIndexPage(indexPage) → {StaticHandler}

Set the index page
Parameters:
Name Type Description
indexPage string the index page
Source:
Returns:
a reference to this, so the API can be used fluently
Type
StaticHandler

setMaxAgeSeconds(maxAgeSeconds) → {StaticHandler}

Set value for max age in caching headers
Parameters:
Name Type Description
maxAgeSeconds number maximum time for browser to cache, in seconds
Source:
Returns:
a reference to this, so the API can be used fluently
Type
StaticHandler

setMaxAvgServeTimeNs(maxAvgServeTimeNanoSeconds) → {StaticHandler}

Set the max serve time in ns, above which serves are considered slow
Parameters:
Name Type Description
maxAvgServeTimeNanoSeconds number max serve time, in ns
Source:
Returns:
a reference to this, so the API can be used fluently
Type
StaticHandler

setMaxCacheSize(maxCacheSize) → {StaticHandler}

Set the max cache size, when caching is enabled
Parameters:
Name Type Description
maxCacheSize number the max cache size
Source:
Returns:
a reference to this, so the API can be used fluently
Type
StaticHandler

setSendVaryHeader(varyHeader) → {StaticHandler}

Set whether vary header should be sent with response.
Parameters:
Name Type Description
varyHeader boolean true to sent vary header
Source:
Returns:
a reference to this, so the API can be used fluently
Type
StaticHandler

setWebRoot(webRoot) → {StaticHandler}

Set the web root
Parameters:
Name Type Description
webRoot string the web root
Source:
Returns:
a reference to this, so the API can be used fluently
Type
StaticHandler

skipCompressionForMediaTypes(mediaTypes) → {StaticHandler}

Skip compression if the media type of the file to send is in the provided mediaTypes set. Content-Encoding header set to identity for the types present in the mediaTypes set
Parameters:
Name Type Description
mediaTypes Array.<string> the set of mime types that are already compressed
Source:
Returns:
a reference to this, so the API can be used fluently
Type
StaticHandler

skipCompressionForSuffixes(fileSuffixes) → {StaticHandler}

Skip compression if the suffix of the file to send is in the provided fileSuffixes set. Content-Encoding header set to identity for the suffixes present in the fileSuffixes set
Parameters:
Name Type Description
fileSuffixes Array.<string> the set of file suffixes that are already compressed
Source:
Returns:
a reference to this, so the API can be used fluently
Type
StaticHandler