com.linecorp.armeria.server

Class VirtualHostBuilder

java.lang.Object

com.linecorp.armeria.server.VirtualHostBuilder

public final class VirtualHostBuilder
extends Object

Builds a new VirtualHost.

This class can only be instantiated through the ServerBuilder.defaultVirtualHost() or ServerBuilder.virtualHost(String) method of the ServerBuilder.

Call and() method and return to ServerBuilder.

See Also:

ServerBuilder, Route

Method Summary

Modifier and Type	Method and Description
VirtualHostBuilder	accessLogger(Function<? super VirtualHost,? extends org.slf4j.Logger> mapper) Sets the access logger mapper of this VirtualHost.
VirtualHostBuilder	accessLogger(org.slf4j.Logger logger) Sets the Logger of this VirtualHost, which is used for writing access logs.
VirtualHostBuilder	accessLogger(String loggerName) Sets the Logger named loggerName of this VirtualHost, which is used for writing access logs.
VirtualHostBuilder	accessLogWriter(AccessLogWriter accessLogWriter, boolean shutdownOnStop) Sets the access log writer of this VirtualHost.
ServerBuilder	and() Returns the parent ServerBuilder.
VirtualHostAnnotatedServiceBindingBuilder	annotatedService() Returns a new instance of VirtualHostAnnotatedServiceBindingBuilder to build an annotated service fluently.
VirtualHostBuilder	annotatedService(Object service) Binds the specified annotated service object under the path prefix "/".
VirtualHostBuilder	annotatedService(Object service, Function<? super HttpService,? extends HttpService> decorator, Object... exceptionHandlersAndConverters) Binds the specified annotated service object under the path prefix "/".
VirtualHostBuilder	annotatedService(Object service, Object... exceptionHandlersAndConverters) Binds the specified annotated service object under the path prefix "/".
VirtualHostBuilder	annotatedService(String pathPrefix, Object service) Binds the specified annotated service object under the specified path prefix.
VirtualHostBuilder	annotatedService(String pathPrefix, Object service, Function<? super HttpService,? extends HttpService> decorator, Iterable<?> exceptionHandlersAndConverters) Binds the specified annotated service object under the specified path prefix.
VirtualHostBuilder	annotatedService(String pathPrefix, Object service, Function<? super HttpService,? extends HttpService> decorator, Iterable<? extends ExceptionHandlerFunction> exceptionHandlerFunctions, Iterable<? extends RequestConverterFunction> requestConverterFunctions, Iterable<? extends ResponseConverterFunction> responseConverterFunctions) Binds the specified annotated service object under the specified path prefix.
VirtualHostBuilder	annotatedService(String pathPrefix, Object service, Function<? super HttpService,? extends HttpService> decorator, Object... exceptionHandlersAndConverters) Binds the specified annotated service object under the specified path prefix.
VirtualHostBuilder	annotatedService(String pathPrefix, Object service, Iterable<?> exceptionHandlersAndConverters) Binds the specified annotated service object under the specified path prefix.
VirtualHostBuilder	annotatedService(String pathPrefix, Object service, Object... exceptionHandlersAndConverters) Binds the specified annotated service object under the specified path prefix.
VirtualHostBuilder	annotatedServiceExtensions(Iterable<? extends RequestConverterFunction> requestConverterFunctions, Iterable<? extends ResponseConverterFunction> responseConverterFunctions, Iterable<? extends ExceptionHandlerFunction> exceptionHandlerFunctions) Sets the RequestConverterFunctions, ResponseConverterFunction and ExceptionHandlerFunctions for creating an AnnotatedServiceExtensions.
VirtualHostBuilder	decorator(DecoratingHttpServiceFunction decoratingHttpServiceFunction) Decorates all HttpServices with the specified DecoratingHttpServiceFunction.
VirtualHostBuilder	decorator(Function<? super HttpService,? extends HttpService> decorator) Decorates all HttpServices with the specified decorator.
VirtualHostBuilder	decorator(Route route, DecoratingHttpServiceFunction decoratingHttpServiceFunction) Decorates HttpServices whose Route matches the specified Route.
VirtualHostBuilder	decorator(Route route, Function<? super HttpService,? extends HttpService> decorator) Decorates HttpServices whose Route matches the specified Route.
VirtualHostBuilder	decorator(String pathPattern, DecoratingHttpServiceFunction decoratingHttpServiceFunction) Decorates HttpServices whose Route matches the specified pathPattern.
VirtualHostBuilder	decorator(String pathPattern, Function<? super HttpService,? extends HttpService> decorator) Decorates HttpServices whose Route matches the specified pathPattern.
VirtualHostBuilder	decoratorUnder(String prefix, DecoratingHttpServiceFunction decoratingHttpServiceFunction) Decorates HttpServices under the specified directory.
VirtualHostBuilder	decoratorUnder(String prefix, Function<? super HttpService,? extends HttpService> decorator) Decorates HttpServices under the specified directory.
VirtualHostBuilder	defaultHostname(String defaultHostname) Sets the default hostname of this VirtualHost.
VirtualHostBuilder	hostnamePattern(String hostnamePattern) Sets the hostname pattern of this VirtualHost.
VirtualHostBuilder	maxRequestLength(long maxRequestLength) Sets the maximum allowed length of the content decoded at the session layer.
VirtualHostBuilder	rejectedRouteHandler(RejectedRouteHandler handler) Sets the RejectedRouteHandler which will be invoked when an attempt to bind an HttpService at a certain Route is rejected.
VirtualHostBuilder	requestTimeout(Duration requestTimeout) Sets the timeout of a request.
VirtualHostBuilder	requestTimeoutMillis(long requestTimeoutMillis) Sets the timeout of a request in milliseconds.
VirtualHostServiceBindingBuilder	route() Returns a ServiceBindingBuilder which is for binding an HttpService fluently.
VirtualHostDecoratingServiceBindingBuilder	routeDecorator() Returns a VirtualHostDecoratingServiceBindingBuilder which is for binding a decorator fluently.
VirtualHostBuilder	service(HttpServiceWithRoutes serviceWithRoutes, Function<? super HttpService,? extends HttpService>... decorators) Decorates and binds the specified HttpServiceWithRoutes at multiple Routes of the default VirtualHost.
VirtualHostBuilder	service(HttpServiceWithRoutes serviceWithRoutes, Iterable<? extends Function<? super HttpService,? extends HttpService>> decorators) Decorates and binds the specified HttpServiceWithRoutes at multiple Routes of the default VirtualHost.
VirtualHostBuilder	service(Route route, HttpService service) Binds the specified HttpService at the specified Route.
VirtualHostBuilder	service(String pathPattern, HttpService service) Binds the specified HttpService at the specified path pattern. e.g.
VirtualHostBuilder	serviceAt(String pathPattern, HttpService service) Deprecated. Use service(String, HttpService) instead.
VirtualHostBuilder	serviceUnder(String pathPrefix, HttpService service) Binds the specified HttpService under the specified directory.
VirtualHostBuilder	tls(File keyCertChainFile, File keyFile) Configures SSL or TLS of this VirtualHost with the specified keyCertChainFile and cleartext keyFile.
VirtualHostBuilder	tls(File keyCertChainFile, File keyFile, Consumer<io.netty.handler.ssl.SslContextBuilder> tlsCustomizer) Deprecated. Use tls(File, File) and tlsCustomizer(Consumer).
VirtualHostBuilder	tls(File keyCertChainFile, File keyFile, String keyPassword) Configures SSL or TLS of this VirtualHost with the specified keyCertChainFile, keyFile and keyPassword.
VirtualHostBuilder	tls(File keyCertChainFile, File keyFile, String keyPassword, Consumer<io.netty.handler.ssl.SslContextBuilder> tlsCustomizer) Deprecated. Use tls(File, File, String) and tlsCustomizer(Consumer).
VirtualHostBuilder	tls(InputStream keyCertChainInputStream, InputStream keyInputStream) Configures SSL or TLS of this VirtualHost with the specified keyCertChainInputStream and cleartext keyInputStream.
VirtualHostBuilder	tls(InputStream keyCertChainInputStream, InputStream keyInputStream, String keyPassword) Configures SSL or TLS of this VirtualHost with the specified keyCertChainInputStream, keyInputStream and keyPassword.
VirtualHostBuilder	tls(KeyManagerFactory keyManagerFactory) Configures SSL or TLS of this VirtualHost with the specified KeyManagerFactory.
VirtualHostBuilder	tls(KeyManagerFactory keyManagerFactory, Consumer<io.netty.handler.ssl.SslContextBuilder> tlsCustomizer) Deprecated. Use tls(KeyManagerFactory) and tlsCustomizer(Consumer).
VirtualHostBuilder	tls(PrivateKey key, Iterable<? extends X509Certificate> keyCertChain) Configures SSL or TLS of this VirtualHost with the specified cleartext PrivateKey and X509Certificate chain.
VirtualHostBuilder	tls(PrivateKey key, String keyPassword, Iterable<? extends X509Certificate> keyCertChain) Configures SSL or TLS of this VirtualHost with the specified cleartext PrivateKey, keyPassword and X509Certificate chain.
VirtualHostBuilder	tls(PrivateKey key, String keyPassword, X509Certificate... keyCertChain) Configures SSL or TLS of this VirtualHost with the specified cleartext PrivateKey, keyPassword and X509Certificate chain.
VirtualHostBuilder	tls(PrivateKey key, X509Certificate... keyCertChain) Configures SSL or TLS of this VirtualHost with the specified cleartext PrivateKey and X509Certificate chain.
VirtualHostBuilder	tls(io.netty.handler.ssl.SslContext sslContext) Deprecated. This unsafe method has been deprecated because an incorrectly built SslContext can cause a Server to malfunction. Use other tls() methods.
VirtualHostBuilder	tlsCustomizer(Consumer<? super io.netty.handler.ssl.SslContextBuilder> tlsCustomizer) Adds the Consumer which can arbitrarily configure the SslContextBuilder that will be applied to the SSL session.
VirtualHostBuilder	tlsSelfSigned() Configures SSL or TLS of this VirtualHost with an auto-generated self-signed certificate.
VirtualHostBuilder	tlsSelfSigned(boolean tlsSelfSigned) Configures SSL or TLS of this VirtualHost with an auto-generated self-signed certificate.
String	toString()
VirtualHostBuilder	verboseResponses(boolean verboseResponses) Sets whether the verbose response mode is enabled.
VirtualHostBuilder	withRoute(Consumer<? super VirtualHostServiceBindingBuilder> customizer) Configures an HttpService of the VirtualHost with the customizer.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

and

public ServerBuilder and()

Returns the parent ServerBuilder.

Returns:

serverBuilder the parent ServerBuilder.

defaultHostname

public VirtualHostBuilder defaultHostname(String defaultHostname)

Sets the default hostname of this VirtualHost.

hostnamePattern

public VirtualHostBuilder hostnamePattern(String hostnamePattern)

Sets the hostname pattern of this VirtualHost.

Throws:

UnsupportedOperationException - if this is the default VirtualHostBuilder

tls

@Deprecated
public VirtualHostBuilder tls(io.netty.handler.ssl.SslContext sslContext)

Deprecated. This unsafe method has been deprecated because an incorrectly built SslContext can cause a Server to malfunction. Use other tls() methods.

Configures SSL or TLS of this VirtualHost with the specified SslContext.

tls

public VirtualHostBuilder tls(File keyCertChainFile,
                              File keyFile)

Configures SSL or TLS of this VirtualHost with the specified keyCertChainFile and cleartext keyFile.

See Also:

tlsCustomizer(Consumer)

tls

@Deprecated
public VirtualHostBuilder tls(File keyCertChainFile,
                                          File keyFile,
                                          Consumer<io.netty.handler.ssl.SslContextBuilder> tlsCustomizer)

Deprecated. Use tls(File, File) and tlsCustomizer(Consumer).

Configures SSL or TLS of this VirtualHost with the specified keyCertChainFile, cleartext keyFile and tlsCustomizer.

tls

public VirtualHostBuilder tls(File keyCertChainFile,
                              File keyFile,
                              String keyPassword)

Configures SSL or TLS of this VirtualHost with the specified keyCertChainFile, keyFile and keyPassword.

See Also:

tlsCustomizer(Consumer)

tls

@Deprecated
public VirtualHostBuilder tls(File keyCertChainFile,
                                          File keyFile,
                                          String keyPassword,
                                          Consumer<io.netty.handler.ssl.SslContextBuilder> tlsCustomizer)

Deprecated. Use tls(File, File, String) and tlsCustomizer(Consumer).

Configures SSL or TLS of this VirtualHost with the specified keyCertChainFile, keyFile, keyPassword and tlsCustomizer.

tls

public VirtualHostBuilder tls(InputStream keyCertChainInputStream,
                              InputStream keyInputStream)

Configures SSL or TLS of this VirtualHost with the specified keyCertChainInputStream and cleartext keyInputStream.

See Also:

tlsCustomizer(Consumer)

tls

public VirtualHostBuilder tls(InputStream keyCertChainInputStream,
                              InputStream keyInputStream,
                              String keyPassword)

Configures SSL or TLS of this VirtualHost with the specified keyCertChainInputStream, keyInputStream and keyPassword.

See Also:

tlsCustomizer(Consumer)

tls

public VirtualHostBuilder tls(PrivateKey key,
                              X509Certificate... keyCertChain)

Configures SSL or TLS of this VirtualHost with the specified cleartext PrivateKey and X509Certificate chain.

See Also:

tlsCustomizer(Consumer)

tls

public VirtualHostBuilder tls(PrivateKey key,
                              Iterable<? extends X509Certificate> keyCertChain)

Configures SSL or TLS of this VirtualHost with the specified cleartext PrivateKey and X509Certificate chain.

See Also:

tlsCustomizer(Consumer)

tls

public VirtualHostBuilder tls(PrivateKey key,
                              String keyPassword,
                              X509Certificate... keyCertChain)

Configures SSL or TLS of this VirtualHost with the specified cleartext PrivateKey, keyPassword and X509Certificate chain.

See Also:

tlsCustomizer(Consumer)

tls

public VirtualHostBuilder tls(PrivateKey key,
                              String keyPassword,
                              Iterable<? extends X509Certificate> keyCertChain)

Configures SSL or TLS of this VirtualHost with the specified cleartext PrivateKey, keyPassword and X509Certificate chain.

See Also:

tlsCustomizer(Consumer)

tls

public VirtualHostBuilder tls(KeyManagerFactory keyManagerFactory)

Configures SSL or TLS of this VirtualHost with the specified KeyManagerFactory.

See Also:

tlsCustomizer(Consumer)

tls

@Deprecated
public VirtualHostBuilder tls(KeyManagerFactory keyManagerFactory,
                                          Consumer<io.netty.handler.ssl.SslContextBuilder> tlsCustomizer)

Deprecated. Use tls(KeyManagerFactory) and tlsCustomizer(Consumer).

Configures SSL or TLS of this VirtualHost with the specified keyManagerFactory and tlsCustomizer.

tlsSelfSigned

public VirtualHostBuilder tlsSelfSigned()

Configures SSL or TLS of this VirtualHost with an auto-generated self-signed certificate. Note: You should never use this in production but only for a testing purpose.

See Also:

tlsCustomizer(Consumer)

tlsSelfSigned

public VirtualHostBuilder tlsSelfSigned(boolean tlsSelfSigned)

Configures SSL or TLS of this VirtualHost with an auto-generated self-signed certificate. Note: You should never use this in production but only for a testing purpose.

See Also:

tlsCustomizer(Consumer)

tlsCustomizer

public VirtualHostBuilder tlsCustomizer(Consumer<? super io.netty.handler.ssl.SslContextBuilder> tlsCustomizer)

Adds the Consumer which can arbitrarily configure the SslContextBuilder that will be applied to the SSL session.

withRoute

public VirtualHostBuilder withRoute(Consumer<? super VirtualHostServiceBindingBuilder> customizer)

Configures an HttpService of the VirtualHost with the customizer.

route

public VirtualHostServiceBindingBuilder route()

Returns a ServiceBindingBuilder which is for binding an HttpService fluently.

routeDecorator

public VirtualHostDecoratingServiceBindingBuilder routeDecorator()

Returns a VirtualHostDecoratingServiceBindingBuilder which is for binding a decorator fluently.

serviceAt

@Deprecated
public VirtualHostBuilder serviceAt(String pathPattern,
                                                HttpService service)

Deprecated. Use service(String, HttpService) instead.

Binds the specified HttpService at the specified path pattern.

serviceUnder

public VirtualHostBuilder serviceUnder(String pathPrefix,
                                       HttpService service)

Binds the specified HttpService under the specified directory.

service

public VirtualHostBuilder service(String pathPattern,
                                  HttpService service)

Binds the specified HttpService at the specified path pattern. e.g.

• /login (no path parameters)
• /users/{userId} (curly-brace style)
• /list/:productType/by/:ordering (colon style)
• exact:/foo/bar (exact match)
• prefix:/files (prefix match)
• glob:/~*/downloads/** (glob pattern)
• regex:^/files/(?<filePath>.*)$ (regular expression)

Throws:

IllegalArgumentException - if the specified path pattern is invalid

service

public VirtualHostBuilder service(Route route,
                                  HttpService service)

Binds the specified HttpService at the specified Route.

service

public VirtualHostBuilder service(HttpServiceWithRoutes serviceWithRoutes,
                                  Iterable<? extends Function<? super HttpService,? extends HttpService>> decorators)

Decorates and binds the specified HttpServiceWithRoutes at multiple Routes of the default VirtualHost.

Parameters:

serviceWithRoutes - the HttpServiceWithRoutes.

decorators - the decorator functions, which will be applied in the order specified.

service

@SafeVarargs
public final VirtualHostBuilder service(HttpServiceWithRoutes serviceWithRoutes,
                                                     Function<? super HttpService,? extends HttpService>... decorators)

Decorates and binds the specified HttpServiceWithRoutes at multiple Routes of the default VirtualHost.

Parameters:

serviceWithRoutes - the HttpServiceWithRoutes.

decorators - the decorator functions, which will be applied in the order specified.

annotatedService

public VirtualHostBuilder annotatedService(Object service)

Binds the specified annotated service object under the path prefix "/".

annotatedService

public VirtualHostBuilder annotatedService(Object service,
                                           Object... exceptionHandlersAndConverters)

Binds the specified annotated service object under the path prefix "/".

Parameters:

exceptionHandlersAndConverters - the ExceptionHandlerFunctions, the RequestConverterFunctions and/or the ResponseConverterFunctions

annotatedService

public VirtualHostBuilder annotatedService(Object service,
                                           Function<? super HttpService,? extends HttpService> decorator,
                                           Object... exceptionHandlersAndConverters)

Binds the specified annotated service object under the path prefix "/".

Parameters:

exceptionHandlersAndConverters - the ExceptionHandlerFunctions, the RequestConverterFunctions and/or the ResponseConverterFunctions

annotatedService

public VirtualHostBuilder annotatedService(String pathPrefix,
                                           Object service)

Binds the specified annotated service object under the specified path prefix.

annotatedService

public VirtualHostBuilder annotatedService(String pathPrefix,
                                           Object service,
                                           Object... exceptionHandlersAndConverters)

Binds the specified annotated service object under the specified path prefix.

Parameters:

exceptionHandlersAndConverters - the ExceptionHandlerFunctions, the RequestConverterFunctions and/or the ResponseConverterFunctions

annotatedService

public VirtualHostBuilder annotatedService(String pathPrefix,
                                           Object service,
                                           Iterable<?> exceptionHandlersAndConverters)

Binds the specified annotated service object under the specified path prefix.

Parameters:

exceptionHandlersAndConverters - the ExceptionHandlerFunction, RequestConverterFunction and/or ResponseConverterFunction

annotatedService

public VirtualHostBuilder annotatedService(String pathPrefix,
                                           Object service,
                                           Function<? super HttpService,? extends HttpService> decorator,
                                           Object... exceptionHandlersAndConverters)

Binds the specified annotated service object under the specified path prefix.

Parameters:

exceptionHandlersAndConverters - the ExceptionHandlerFunctions, the RequestConverterFunctions and/or the ResponseConverterFunctions

annotatedService

public VirtualHostBuilder annotatedService(String pathPrefix,
                                           Object service,
                                           Function<? super HttpService,? extends HttpService> decorator,
                                           Iterable<?> exceptionHandlersAndConverters)

Binds the specified annotated service object under the specified path prefix.

Parameters:

exceptionHandlersAndConverters - the ExceptionHandlerFunctions, the RequestConverterFunctions and/or the ResponseConverterFunctions

annotatedService

public VirtualHostBuilder annotatedService(String pathPrefix,
                                           Object service,
                                           Function<? super HttpService,? extends HttpService> decorator,
                                           Iterable<? extends ExceptionHandlerFunction> exceptionHandlerFunctions,
                                           Iterable<? extends RequestConverterFunction> requestConverterFunctions,
                                           Iterable<? extends ResponseConverterFunction> responseConverterFunctions)

Binds the specified annotated service object under the specified path prefix.

Parameters:

exceptionHandlerFunctions - the ExceptionHandlerFunctions

requestConverterFunctions - the RequestConverterFunctions

responseConverterFunctions - the ResponseConverterFunctions

annotatedService

public VirtualHostAnnotatedServiceBindingBuilder annotatedService()

Returns a new instance of VirtualHostAnnotatedServiceBindingBuilder to build an annotated service fluently.

decorator

public VirtualHostBuilder decorator(Function<? super HttpService,? extends HttpService> decorator)

Decorates all HttpServices with the specified decorator.

Parameters:

decorator - the Function that decorates HttpServices

decorator

public VirtualHostBuilder decorator(DecoratingHttpServiceFunction decoratingHttpServiceFunction)

Decorates all HttpServices with the specified DecoratingHttpServiceFunction.

Parameters:

decoratingHttpServiceFunction - the DecoratingHttpServiceFunction that decorates HttpServices

decorator

public VirtualHostBuilder decorator(String pathPattern,
                                    DecoratingHttpServiceFunction decoratingHttpServiceFunction)

Decorates HttpServices whose Route matches the specified pathPattern.

Parameters:

decoratingHttpServiceFunction - the DecoratingHttpServiceFunction that decorates HttpServices

decorator

public VirtualHostBuilder decorator(String pathPattern,
                                    Function<? super HttpService,? extends HttpService> decorator)

Decorates HttpServices whose Route matches the specified pathPattern.

decorator

public VirtualHostBuilder decorator(Route route,
                                    Function<? super HttpService,? extends HttpService> decorator)

Decorates HttpServices whose Route matches the specified Route.

Parameters:

route - the route being decorated

decorator - the Function that decorates HttpService

decorator

public VirtualHostBuilder decorator(Route route,
                                    DecoratingHttpServiceFunction decoratingHttpServiceFunction)

Decorates HttpServices whose Route matches the specified Route.

Parameters:

route - the route being decorated

decoratingHttpServiceFunction - the DecoratingHttpServiceFunction that decorates HttpServices

decoratorUnder

public VirtualHostBuilder decoratorUnder(String prefix,
                                         Function<? super HttpService,? extends HttpService> decorator)

Decorates HttpServices under the specified directory.

decoratorUnder

public VirtualHostBuilder decoratorUnder(String prefix,
                                         DecoratingHttpServiceFunction decoratingHttpServiceFunction)

Decorates HttpServices under the specified directory.

Parameters:

decoratingHttpServiceFunction - the DecoratingHttpServiceFunction that decorates HttpServices

accessLogger

public VirtualHostBuilder accessLogger(Function<? super VirtualHost,? extends org.slf4j.Logger> mapper)

Sets the access logger mapper of this VirtualHost.

accessLogger

public VirtualHostBuilder accessLogger(org.slf4j.Logger logger)

Sets the Logger of this VirtualHost, which is used for writing access logs.

accessLogger

public VirtualHostBuilder accessLogger(String loggerName)

Sets the Logger named loggerName of this VirtualHost, which is used for writing access logs.

rejectedRouteHandler

public VirtualHostBuilder rejectedRouteHandler(RejectedRouteHandler handler)

Sets the RejectedRouteHandler which will be invoked when an attempt to bind an HttpService at a certain Route is rejected. If not set, the RejectedRouteHandler set via ServerBuilder.rejectedRouteHandler(RejectedRouteHandler) is used.

requestTimeout

public VirtualHostBuilder requestTimeout(Duration requestTimeout)

Sets the timeout of a request. If not set, the value set via ServerBuilder.requestTimeoutMillis(long) is used.

Parameters:

requestTimeout - the timeout. 0 disables the timeout.

requestTimeoutMillis

public VirtualHostBuilder requestTimeoutMillis(long requestTimeoutMillis)

Sets the timeout of a request in milliseconds. If not set, the value set via ServerBuilder.requestTimeoutMillis(long) is used.

Parameters:

requestTimeoutMillis - the timeout in milliseconds. 0 disables the timeout.

maxRequestLength

public VirtualHostBuilder maxRequestLength(long maxRequestLength)

Sets the maximum allowed length of the content decoded at the session layer. e.g. the content length of an HTTP request. If not set, the value set via ServerBuilder.maxRequestLength(long) is used.

Parameters:

maxRequestLength - the maximum allowed length. 0 disables the length limit.

verboseResponses

public VirtualHostBuilder verboseResponses(boolean verboseResponses)

Sets whether the verbose response mode is enabled. When enabled, the server responses will contain the exception type and its full stack trace, which may be useful for debugging while potentially insecure. When disabled, the server responses will not expose such server-side details to the client. If not set, the value set via ServerBuilder.verboseResponses(boolean) is used.

accessLogWriter

public VirtualHostBuilder accessLogWriter(AccessLogWriter accessLogWriter,
                                          boolean shutdownOnStop)

Sets the access log writer of this VirtualHost. If not set, the AccessLogWriter set via ServerBuilder.accessLogWriter(AccessLogWriter, boolean) is used.

Parameters:

shutdownOnStop - whether to shut down the AccessLogWriter when the Server stops

annotatedServiceExtensions

public VirtualHostBuilder annotatedServiceExtensions(Iterable<? extends RequestConverterFunction> requestConverterFunctions,
                                                     Iterable<? extends ResponseConverterFunction> responseConverterFunctions,
                                                     Iterable<? extends ExceptionHandlerFunction> exceptionHandlerFunctions)

Sets the RequestConverterFunctions, ResponseConverterFunction and ExceptionHandlerFunctions for creating an AnnotatedServiceExtensions.

Parameters:

requestConverterFunctions - the RequestConverterFunctions

responseConverterFunctions - the ResponseConverterFunctions

exceptionHandlerFunctions - the ExceptionHandlerFunctions

toString

public String toString()

Overrides:

toString in class Object