VirtualHostServiceBindingBuilder (filter-service-metrics 1.12 1.12 API)

java.lang.Object
- com.linecorp.armeria.server.VirtualHostServiceBindingBuilder

public final class VirtualHostServiceBindingBuilder
extends Object

A builder class for binding an HttpService fluently. This class can be instantiated through VirtualHostBuilder.route(). You can also configure an HttpService using VirtualHostBuilder.withRoute(Consumer).

Call build(HttpService) to build the HttpService and return to the VirtualHostBuilder.


 ServerBuilder sb = Server.builder();
 sb.virtualHost("example.com")
   .route()                                      // Configure the first service in "example.com".
   .post("/foo/bar")
   .consumes(JSON, PLAIN_TEXT_UTF_8)
   .produces(JSON_UTF_8)
   .requestTimeoutMillis(5000)
   .maxRequestLength(8192)
   .verboseResponses(true)
   .contentPreview(500)
   .build((ctx, req) -> HttpResponse.of(OK));    // Return to the VirtualHostBuilder.

 sb.virtualHost("example2.com")                  // Configure the second service "example2.com".
   .withRoute(builder -> builder.path("/baz")
                                .methods(HttpMethod.GET, HttpMethod.POST)
                                .build((ctx, req) -> HttpResponse.of(OK)));

See Also:: ServiceBindingBuilder

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`VirtualHostServiceBindingBuilder`	`accessLogFormat(String accessLogFormat)` Sets the format of this `HttpService`'s access log.
`VirtualHostServiceBindingBuilder`	`accessLogWriter(AccessLogWriter accessLogWriter, boolean shutdownOnStop)` Sets the access log writer of this `HttpService`.
`VirtualHostBuilder`	`build(HttpService service)` Sets the `HttpService` and returns the `VirtualHostBuilder` that this `VirtualHostServiceBindingBuilder` was created from.
`VirtualHostServiceBindingBuilder`	`connect(String pathPattern)` Sets the path pattern that an `HttpService` will be bound to, only supporting `HttpMethod.CONNECT` requests.
`VirtualHostServiceBindingBuilder`	`consumes(Iterable<MediaType> consumeTypes)` Sets `MediaType`s that an `HttpService` will consume.
`VirtualHostServiceBindingBuilder`	`consumes(MediaType... consumeTypes)` Sets `MediaType`s that an `HttpService` will consume.
`VirtualHostServiceBindingBuilder`	`contentPreview(int length)` Sets the `ContentPreviewerFactory` for creating a `ContentPreviewer` which produces the preview with the maximum `length` limit for an HTTP request/response of the `HttpService`.
`VirtualHostServiceBindingBuilder`	`contentPreview(int length, Charset defaultCharset)` Sets the `ContentPreviewerFactory` for creating a `ContentPreviewer` which produces the preview with the maximum `length` limit for an HTTP request/response of an `HttpService`.
`VirtualHostServiceBindingBuilder`	`contentPreviewerFactory(ContentPreviewerFactory factory)` Sets the `ContentPreviewerFactory` for an HTTP request/response of an `HttpService`.
`VirtualHostServiceBindingBuilder`	`decorator(Function<? super HttpService,? extends HttpService> decorator)` Decorates an `HttpService` with the specified `decorator`.
`VirtualHostServiceBindingBuilder`	`delete(String pathPattern)` Sets the path pattern that an `HttpService` will be bound to, only supporting `HttpMethod.DELETE` requests.
`VirtualHostServiceBindingBuilder`	`get(String pathPattern)` Sets the path pattern that an `HttpService` will be bound to, only supporting `HttpMethod.GET` requests.
`VirtualHostServiceBindingBuilder`	`head(String pathPattern)` Sets the path pattern that an `HttpService` will be bound to, only supporting `HttpMethod.HEAD` requests.
`VirtualHostServiceBindingBuilder`	`maxRequestLength(long maxRequestLength)` Sets the maximum allowed length of an HTTP request.
`VirtualHostServiceBindingBuilder`	`methods(HttpMethod... methods)` Sets the `HttpMethod`s that an `HttpService` will support.
`VirtualHostServiceBindingBuilder`	`methods(Iterable<HttpMethod> methods)` Sets the `HttpMethod`s that an `HttpService` will support.
`VirtualHostServiceBindingBuilder`	`options(String pathPattern)` Sets the path pattern that an `HttpService` will be bound to, only supporting `HttpMethod.OPTIONS` requests.
`VirtualHostServiceBindingBuilder`	`patch(String pathPattern)` Sets the path pattern that an `HttpService` will be bound to, only supporting `HttpMethod.PATCH` requests.
`VirtualHostServiceBindingBuilder`	`path(String pathPattern)` Sets the path pattern that an `HttpService` will be bound to.
`VirtualHostServiceBindingBuilder`	`pathPrefix(String prefix)` Sets the specified prefix which is a directory that an `HttpService` will be bound under.
`VirtualHostServiceBindingBuilder`	`pathUnder(String prefix)` Deprecated. Use `pathPrefix(String)`.
`VirtualHostServiceBindingBuilder`	`post(String pathPattern)` Sets the path pattern that an `HttpService` will be bound to, only supporting `HttpMethod.POST` requests.
`VirtualHostServiceBindingBuilder`	`produces(Iterable<MediaType> produceTypes)` Sets `MediaType`s that an `HttpService` will produce to be used in content negotiation.
`VirtualHostServiceBindingBuilder`	`produces(MediaType... produceTypes)` Sets `MediaType`s that an `HttpService` will produce to be used in content negotiation.
`VirtualHostServiceBindingBuilder`	`put(String pathPattern)` Sets the path pattern that an `HttpService` will be bound to, only supporting `HttpMethod.PUT` requests.
`VirtualHostServiceBindingBuilder`	`requestContentPreviewerFactory(ContentPreviewerFactory factory)` Sets the `ContentPreviewerFactory` for an HTTP request of an `HttpService`.
`VirtualHostServiceBindingBuilder`	`requestTimeout(Duration requestTimeout)` Sets the timeout of an HTTP request.
`VirtualHostServiceBindingBuilder`	`requestTimeoutMillis(long requestTimeoutMillis)` Sets the timeout of an HTTP request in milliseconds.
`VirtualHostServiceBindingBuilder`	`responseContentPreviewerFactory(ContentPreviewerFactory factory)` Sets the `ContentPreviewerFactory` for an HTTP response of an `HttpService`.
`VirtualHostServiceBindingBuilder`	`trace(String pathPattern)` Sets the path pattern that an `HttpService` will be bound to, only supporting `HttpMethod.TRACE` requests.
`VirtualHostServiceBindingBuilder`	`verboseResponses(boolean verboseResponses)` Sets whether the verbose response mode is enabled.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - path
```
public VirtualHostServiceBindingBuilder path(String pathPattern)
```
    Sets the path pattern that an HttpService will be bound to. Please refer to the Path patterns in order to learn how to specify a path pattern.
  - pathUnder
```
@Deprecated
public VirtualHostServiceBindingBuilder pathUnder(String prefix)
```
    Deprecated. Use pathPrefix(String).
    
    Sets the specified prefix which is a directory that an HttpService will be bound under. pathUnder("/my/path") is identical to path("prefix:/my/path").
  - pathPrefix
```
public VirtualHostServiceBindingBuilder pathPrefix(String prefix)
```
    Sets the specified prefix which is a directory that an HttpService will be bound under. pathPrefix("/my/path") is identical to path("prefix:/my/path").
  - methods
```
public VirtualHostServiceBindingBuilder methods(HttpMethod... methods)
```
    Sets the HttpMethods that an HttpService will support. If not set, HttpMethod.knownMethods()s are set.
    
    See Also:
    
    path(String), pathPrefix(String)
  - methods
```
public VirtualHostServiceBindingBuilder methods(Iterable<HttpMethod> methods)
```
    Sets the HttpMethods that an HttpService will support. If not set, HttpMethod.knownMethods()s are set.
    
    See Also:
    
    path(String), pathPrefix(String)
  - get
```
public VirtualHostServiceBindingBuilder get(String pathPattern)
```
    Sets the path pattern that an HttpService will be bound to, only supporting HttpMethod.GET requests. Please refer to the Path patterns in order to learn how to specify a path pattern.
  - post
```
public VirtualHostServiceBindingBuilder post(String pathPattern)
```
    Sets the path pattern that an HttpService will be bound to, only supporting HttpMethod.POST requests. Please refer to the Path patterns in order to learn how to specify a path pattern.
  - put
```
public VirtualHostServiceBindingBuilder put(String pathPattern)
```
    Sets the path pattern that an HttpService will be bound to, only supporting HttpMethod.PUT requests. Please refer to the Path patterns in order to learn how to specify a path pattern.
  - patch
```
public VirtualHostServiceBindingBuilder patch(String pathPattern)
```
    Sets the path pattern that an HttpService will be bound to, only supporting HttpMethod.PATCH requests. Please refer to the Path patterns in order to learn how to specify a path pattern.
  - delete
```
public VirtualHostServiceBindingBuilder delete(String pathPattern)
```
    Sets the path pattern that an HttpService will be bound to, only supporting HttpMethod.DELETE requests. Please refer to the Path patterns in order to learn how to specify a path pattern.
  - options
```
public VirtualHostServiceBindingBuilder options(String pathPattern)
```
    Sets the path pattern that an HttpService will be bound to, only supporting HttpMethod.OPTIONS requests. Please refer to the Path patterns in order to learn how to specify a path pattern.
  - head
```
public VirtualHostServiceBindingBuilder head(String pathPattern)
```
    Sets the path pattern that an HttpService will be bound to, only supporting HttpMethod.HEAD requests. Please refer to the Path patterns in order to learn how to specify a path pattern.
  - trace
```
public VirtualHostServiceBindingBuilder trace(String pathPattern)
```
    Sets the path pattern that an HttpService will be bound to, only supporting HttpMethod.TRACE requests. Please refer to the Path patterns in order to learn how to specify a path pattern.
  - connect
```
public VirtualHostServiceBindingBuilder connect(String pathPattern)
```
    Sets the path pattern that an HttpService will be bound to, only supporting HttpMethod.CONNECT requests. Please refer to the Path patterns in order to learn how to specify a path pattern.
  - consumes
```
public VirtualHostServiceBindingBuilder consumes(MediaType... consumeTypes)
```
    Sets MediaTypes that an HttpService will consume. If not set, the HttpService will accept all media types.
  - consumes
```
public VirtualHostServiceBindingBuilder consumes(Iterable<MediaType> consumeTypes)
```
    Sets MediaTypes that an HttpService will consume. If not set, the HttpService will accept all media types.
  - produces
```
public VirtualHostServiceBindingBuilder produces(MediaType... produceTypes)
```
    Sets MediaTypes that an HttpService will produce to be used in content negotiation. See Accept header for more information.
  - produces
```
public VirtualHostServiceBindingBuilder produces(Iterable<MediaType> produceTypes)
```
    Sets MediaTypes that an HttpService will produce to be used in content negotiation. See Accept header for more information.
  - requestTimeout
```
public VirtualHostServiceBindingBuilder requestTimeout(Duration requestTimeout)
```
    Sets the timeout of an HTTP request. If not set, the value set via VirtualHost.requestTimeoutMillis() is used.
    
    Parameters:
    
    requestTimeout - the timeout. 0 disables the timeout.
  - requestTimeoutMillis
```
public VirtualHostServiceBindingBuilder requestTimeoutMillis(long requestTimeoutMillis)
```
    Sets the timeout of an HTTP request in milliseconds. If not set, the value set via VirtualHost.requestTimeoutMillis() is used.
    
    Parameters:
    
    requestTimeoutMillis - the timeout in milliseconds. 0 disables the timeout.
  - maxRequestLength
```
public VirtualHostServiceBindingBuilder maxRequestLength(long maxRequestLength)
```
    Sets the maximum allowed length of an HTTP request. If not set, the value set via VirtualHost.maxRequestLength() is used.
    
    Parameters:
    
    maxRequestLength - the maximum allowed length. 0 disables the length limit.
  - verboseResponses
```
public VirtualHostServiceBindingBuilder verboseResponses(boolean verboseResponses)
```
    Sets whether the verbose response mode is enabled. When enabled, the service response will contain the exception type and its full stack trace, which may be useful for debugging while potentially insecure. When disabled, the service response will not expose such server-side details to the client. If not set, the value set via VirtualHostBuilder.verboseResponses(boolean) is used.
  - requestContentPreviewerFactory
```
public VirtualHostServiceBindingBuilder requestContentPreviewerFactory(ContentPreviewerFactory factory)
```
    Sets the ContentPreviewerFactory for an HTTP request of an HttpService. If not set, the ContentPreviewerFactory set via VirtualHost.requestContentPreviewerFactory() is used.
  - responseContentPreviewerFactory
```
public VirtualHostServiceBindingBuilder responseContentPreviewerFactory(ContentPreviewerFactory factory)
```
    Sets the ContentPreviewerFactory for an HTTP response of an HttpService. If not set, the ContentPreviewerFactory set via VirtualHost.responseContentPreviewerFactory() is used.
  - contentPreview
```
public VirtualHostServiceBindingBuilder contentPreview(int length)
```
    Sets the ContentPreviewerFactory for creating a ContentPreviewer which produces the preview with the maximum length limit for an HTTP request/response of the HttpService. The previewer is enabled only if the content type of an HTTP request/response meets any of the following conditions:
    - when it matches text/* or application/x-www-form-urlencoded
    - when its charset has been specified
    - when its subtype is "xml" or "json"
    - when its subtype ends with "+xml" or "+json"
    Parameters:
    
    length - the maximum length of the preview.
  - contentPreview
```
public VirtualHostServiceBindingBuilder contentPreview(int length,
                                                       Charset defaultCharset)
```
    Sets the ContentPreviewerFactory for creating a ContentPreviewer which produces the preview with the maximum length limit for an HTTP request/response of an HttpService. The previewer is enabled only if the content type of an HTTP request/response meets any of the following conditions:
    - when it matches text/* or application/x-www-form-urlencoded
    - when its charset has been specified
    - when its subtype is "xml" or "json"
    - when its subtype ends with "+xml" or "+json"
    Parameters:
    
    length - the maximum length of the preview
    
    defaultCharset - the default charset used when a charset is not specified in the "content-type" header
  - contentPreviewerFactory
```
public VirtualHostServiceBindingBuilder contentPreviewerFactory(ContentPreviewerFactory factory)
```
    Sets the ContentPreviewerFactory for an HTTP request/response of an HttpService.
  - accessLogFormat
```
public VirtualHostServiceBindingBuilder accessLogFormat(String accessLogFormat)
```
    Sets the format of this HttpService's access log. The specified accessLogFormat would be parsed by AccessLogWriter.custom(String).
  - accessLogWriter
```
public VirtualHostServiceBindingBuilder accessLogWriter(AccessLogWriter accessLogWriter,
                                                        boolean shutdownOnStop)
```
    Sets the access log writer of this HttpService. If not set, the AccessLogWriter set via VirtualHost.accessLogWriter() is used.
    
    shutdownOnStop - whether to shut down the AccessLogWriter when the Server stops
  - decorator
```
public VirtualHostServiceBindingBuilder decorator(Function<? super HttpService,? extends HttpService> decorator)
```
    Decorates an HttpService with the specified decorator.
    
    Parameters:
    
    decorator - the Function that decorates the HttpService
  - build
```
public VirtualHostBuilder build(HttpService service)
```
    Sets the HttpService and returns the VirtualHostBuilder that this VirtualHostServiceBindingBuilder was created from.
    
    Throws:
    
    IllegalStateException - if the path that the HttpService will be bound to is not specified

Class VirtualHostServiceBindingBuilder

Method Summary

Methods inherited from class java.lang.Object

Method Detail

path

pathUnder

pathPrefix

methods

methods

get

post

put

patch

delete

options

head

trace

connect

consumes

consumes

produces

produces

requestTimeout

requestTimeoutMillis

maxRequestLength

verboseResponses

requestContentPreviewerFactory

responseContentPreviewerFactory

contentPreview

contentPreview

contentPreviewerFactory

accessLogFormat

accessLogWriter

decorator

build