Package 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	Description
VirtualHostBuilder	accessLogger(String loggerName)	Sets the Logger named loggerName of this VirtualHost, which is used for writing access logs.
VirtualHostBuilder	accessLogger(Function<? super VirtualHost,? extends Logger> mapper)	Sets the access logger mapper of this VirtualHost.
VirtualHostBuilder	accessLogger(Logger logger)	Sets the Logger 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, Object... exceptionHandlersAndConverters)	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(String pathPrefix, Object service)	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	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	annotatedServiceExtensions(Iterable<? extends RequestConverterFunction> requestConverterFunctions, Iterable<? extends ResponseConverterFunction> responseConverterFunctions, Iterable<? extends ExceptionHandlerFunction> exceptionHandlerFunctions)	Sets the RequestConverterFunctions, ResponseConverterFunction and ExceptionHandlerFunctions for creating an AnnotatedServiceExtensions.
VirtualHostBuilder	blockingTaskExecutor(int numThreads)	Uses a newly created BlockingTaskExecutor with the specified number of threads dedicated to the execution of blocking tasks or invocations.
VirtualHostBuilder	blockingTaskExecutor(ScheduledExecutorService blockingTaskExecutor, boolean shutdownOnStop)	Sets the ScheduledExecutorService dedicated to the execution of blocking tasks or invocations.
VirtualHostBuilder	decorator(DecoratingHttpServiceFunction decoratingHttpServiceFunction)	Decorates all HttpServices with the specified DecoratingHttpServiceFunction.
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	decorator(Function<? super HttpService,? extends HttpService> decorator)	Decorates all HttpServices with the specified decorator.
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	defaultServiceNaming(ServiceNaming defaultServiceNaming)	Sets the default naming rule for the name of services.
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, Iterable<? extends Function<? super HttpService,? extends HttpService>> decorators)	Decorates and binds the specified HttpServiceWithRoutes at multiple Routes of the default VirtualHost.
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(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	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, @Nullable String keyPassword)	Configures SSL or TLS of this VirtualHost with the specified keyCertChainFile, keyFile and keyPassword.
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, @Nullable String keyPassword)	Configures SSL or TLS of this VirtualHost with the specified keyCertChainInputStream, keyInputStream and keyPassword.
VirtualHostBuilder	tls(PrivateKey key, @Nullable 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, @Nullable String keyPassword, X509Certificate... keyCertChain)	Configures SSL or TLS of this VirtualHost with the specified cleartext PrivateKey, keyPassword and X509Certificate chain.
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, X509Certificate... keyCertChain)	Configures SSL or TLS of this VirtualHost with the specified cleartext PrivateKey and X509Certificate chain.
VirtualHostBuilder	tls(KeyManagerFactory keyManagerFactory)	Configures SSL or TLS of this VirtualHost with the specified KeyManagerFactory.
VirtualHostBuilder	tlsAllowUnsafeCiphers()	Deprecated. It's not recommended to enable this option.
VirtualHostBuilder	tlsAllowUnsafeCiphers(boolean tlsAllowUnsafeCiphers)	Deprecated. It's not recommended to enable this option.
VirtualHostBuilder	tlsCustomizer(Consumer<? super 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 Details

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. If the hostname pattern contains a port number such *.example.com:8080, the returned virtual host will be bound to the 8080 port. Otherwise, the virtual host will allow all active ports.

Throws:

UnsupportedOperationException - if this is the default VirtualHostBuilder

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

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

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

See Also:

tlsCustomizer(Consumer)

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,
 @Nullable
 @Nullable 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,
 @Nullable
 @Nullable 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,
 @Nullable
 @Nullable 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)

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 SslContextBuilder> tlsCustomizer)

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

tlsAllowUnsafeCiphers

@Deprecated
public VirtualHostBuilder tlsAllowUnsafeCiphers()

Deprecated.

It's not recommended to enable this option. Use it only when you have no other way to communicate with an insecure peer than this.

Allows the bad cipher suites listed in RFC7540 for TLS handshake.

Note that enabling this option increases the security risk of your connection. Use it only when you must communicate with a legacy system that does not support secure cipher suites. See Section 9.2.2, RFC7540 for more information. This option is disabled by default.

tlsAllowUnsafeCiphers

@Deprecated
public VirtualHostBuilder tlsAllowUnsafeCiphers(boolean tlsAllowUnsafeCiphers)

Deprecated.

It's not recommended to enable this option. Use it only when you have no other way to communicate with an insecure peer than this.

Allows the bad cipher suites listed in RFC7540 for TLS handshake.

Note that enabling this option increases the security risk of your connection. Use it only when you must communicate with a legacy system that does not support secure cipher suites. See Section 9.2.2, RFC7540 for more information. This option is disabled by default.

Parameters:

tlsAllowUnsafeCiphers - Whether to allow the unsafe ciphers

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. The specified decorator(s) is/are executed in reverse order of the insertion.

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. The specified decorator(s) is/are executed in reverse order of the insertion.

Parameters:

decorator - the Function that decorates HttpServices

decorator

public VirtualHostBuilder decorator(DecoratingHttpServiceFunction decoratingHttpServiceFunction)

Decorates all HttpServices with the specified DecoratingHttpServiceFunction. The specified decorator(s) is/are executed in reverse order of the insertion.

Parameters:

decoratingHttpServiceFunction - the DecoratingHttpServiceFunction that decorates HttpServices

decorator

public VirtualHostBuilder decorator(String pathPattern,
 DecoratingHttpServiceFunction decoratingHttpServiceFunction)

Decorates HttpServices whose Route matches the specified pathPattern. The specified decorator(s) is/are executed in reverse order of the insertion.

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. The specified decorator(s) is/are executed in reverse order of the insertion.

decorator

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

Decorates HttpServices whose Route matches the specified Route. The specified decorator(s) is/are executed in reverse order of the insertion.

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. The specified decorator(s) is/are executed in reverse order of the insertion.

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. The specified decorator(s) is/are executed in reverse order of the insertion.

decoratorUnder

public VirtualHostBuilder decoratorUnder(String prefix,
 DecoratingHttpServiceFunction decoratingHttpServiceFunction)

Decorates HttpServices under the specified directory. The specified decorator(s) is/are executed in reverse order of the insertion.

Parameters:

decoratingHttpServiceFunction - the DecoratingHttpServiceFunction that decorates HttpServices

accessLogger

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

Sets the access logger mapper of this VirtualHost.

accessLogger

public VirtualHostBuilder accessLogger(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.

defaultServiceNaming

public VirtualHostBuilder defaultServiceNaming(ServiceNaming defaultServiceNaming)

Sets the default naming rule for the name of services. If not set, the value set via ServerBuilder.defaultServiceNaming(ServiceNaming) is used.

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

blockingTaskExecutor

public VirtualHostBuilder blockingTaskExecutor(ScheduledExecutorService blockingTaskExecutor,
 boolean shutdownOnStop)

Sets the ScheduledExecutorService dedicated to the execution of blocking tasks or invocations. If not set, the common pool is used.

Parameters:

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

blockingTaskExecutor

public VirtualHostBuilder blockingTaskExecutor(int numThreads)

Uses a newly created BlockingTaskExecutor with the specified number of threads dedicated to the execution of blocking tasks or invocations. The worker EventLoopGroup will be shut down when the Server stops.

Parameters:

numThreads - the number of threads in the executor

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