Netty3CorsConfigBuilder (transport-netty3 5.0.0-beta1 API)

java.lang.Object
- org.elasticsearch.http.netty3.cors.Netty3CorsConfigBuilder

```
public final class Netty3CorsConfigBuilder
extends java.lang.Object
```
Builder used to configure and build a Netty3CorsConfig instance. This class was lifted from the Netty project: https://github.com/netty/netty

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Netty3CorsConfigBuilder`	`allowCredentials()` By default cookies are not included in CORS requests, but this method will enable cookies to be added to CORS requests.
`Netty3CorsConfigBuilder`	`allowedRequestHeaders(java.util.Set<java.lang.String> headers)` Specifies the if headers that should be returned in the CORS 'Access-Control-Allow-Headers' response header.
`Netty3CorsConfigBuilder`	`allowedRequestMethods(java.util.Set<org.jboss.netty.handler.codec.http.HttpMethod> methods)` Specifies the allowed set of HTTP Request Methods that should be returned in the CORS 'Access-Control-Request-Method' response header.
`Netty3CorsConfig`	`build()` Builds a `Netty3CorsConfig` with settings specified by previous method calls.
`Netty3CorsConfigBuilder`	`disable()` Disables CORS support.
`static Netty3CorsConfigBuilder`	`forAnyOrigin()` Creates a Builder instance with it's origin set to '*'.
`static Netty3CorsConfigBuilder`	`forOrigin(java.lang.String origin)` Creates a `Netty3CorsConfigBuilder` instance with the specified origin.
`static Netty3CorsConfigBuilder`	`forOrigins(java.lang.String... origins)` Creates a `Netty3CorsConfigBuilder` instance with the specified origins.
`static Netty3CorsConfigBuilder`	`forPattern(java.util.regex.Pattern pattern)` Create a `Netty3CorsConfigBuilder` instance with the specified pattern origin.
`Netty3CorsConfigBuilder`	`maxAge(long max)` When making a preflight request the client has to perform two request with can be inefficient.
`Netty3CorsConfigBuilder`	`noPreflightResponseHeaders()` Specifies that no preflight response headers should be added to a preflight response.
`<T> Netty3CorsConfigBuilder`	`preflightResponseHeader(java.lang.CharSequence name, java.util.concurrent.Callable<T> valueGenerator)` Returns HTTP response headers that should be added to a CORS preflight response.
`<T> Netty3CorsConfigBuilder`	`preflightResponseHeader(java.lang.CharSequence name, java.lang.Iterable<T> value)` Returns HTTP response headers that should be added to a CORS preflight response.
`Netty3CorsConfigBuilder`	`preflightResponseHeader(java.lang.CharSequence name, java.lang.Object... values)` Returns HTTP response headers that should be added to a CORS preflight response.
`Netty3CorsConfigBuilder`	`shortCircuit()` Specifies that a CORS request should be rejected if it's invalid before being further processing.

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

- Method Detail
  - forAnyOrigin
```
public static Netty3CorsConfigBuilder forAnyOrigin()
```
    Creates a Builder instance with it's origin set to '*'.
    
    Returns:
    
    Builder to support method chaining.
  - forOrigin
```
public static Netty3CorsConfigBuilder forOrigin(java.lang.String origin)
```
    Creates a Netty3CorsConfigBuilder instance with the specified origin.
    
    Returns:
    
    Netty3CorsConfigBuilder to support method chaining.
  - forPattern
```
public static Netty3CorsConfigBuilder forPattern(java.util.regex.Pattern pattern)
```
    Create a Netty3CorsConfigBuilder instance with the specified pattern origin.
    
    Parameters:
    
    pattern - the regular expression pattern to match incoming origins on.
    
    Returns:
    
    Netty3CorsConfigBuilder with the configured origin pattern.
  - forOrigins
```
public static Netty3CorsConfigBuilder forOrigins(java.lang.String... origins)
```
    Creates a Netty3CorsConfigBuilder instance with the specified origins.
    
    Returns:
    
    Netty3CorsConfigBuilder to support method chaining.
  - disable
```
public Netty3CorsConfigBuilder disable()
```
    Disables CORS support.
    
    Returns:
    
    Netty3CorsConfigBuilder to support method chaining.
  - allowCredentials
```
public Netty3CorsConfigBuilder allowCredentials()
```
    By default cookies are not included in CORS requests, but this method will enable cookies to be added to CORS requests. Calling this method will set the CORS 'Access-Control-Allow-Credentials' response header to true. Please note, that cookie support needs to be enabled on the client side as well. The client needs to opt-in to send cookies by calling:
```
 xhr.withCredentials = true;
 
```
    The default value for 'withCredentials' is false in which case no cookies are sent. Setting this to true will included cookies in cross origin requests.
    Returns:
    
    Netty3CorsConfigBuilder to support method chaining.
  - maxAge
```
public Netty3CorsConfigBuilder maxAge(long max)
```
    When making a preflight request the client has to perform two request with can be inefficient. This setting will set the CORS 'Access-Control-Max-Age' response header and enables the caching of the preflight response for the specified time. During this time no preflight request will be made.
    
    Parameters:
    
    max - the maximum time, in seconds, that the preflight response may be cached.
    
    Returns:
    
    Netty3CorsConfigBuilder to support method chaining.
  - allowedRequestMethods
```
public Netty3CorsConfigBuilder allowedRequestMethods(java.util.Set<org.jboss.netty.handler.codec.http.HttpMethod> methods)
```
    Specifies the allowed set of HTTP Request Methods that should be returned in the CORS 'Access-Control-Request-Method' response header.
    
    Parameters:
    
    methods - the HttpMethods that should be allowed.
    
    Returns:
    
    Netty3CorsConfigBuilder to support method chaining.
  - allowedRequestHeaders
```
public Netty3CorsConfigBuilder allowedRequestHeaders(java.util.Set<java.lang.String> headers)
```
    Specifies the if headers that should be returned in the CORS 'Access-Control-Allow-Headers' response header. If a client specifies headers on the request, for example by calling:
```
 xhr.setRequestHeader('My-Custom-Header', "SomeValue");
 
```
    the server will receive the above header name in the 'Access-Control-Request-Headers' of the preflight request. The server will then decide if it allows this header to be sent for the real request (remember that a preflight is not the real request but a request asking the server if it allow a request).
    Parameters:
    
    headers - the headers to be added to the preflight 'Access-Control-Allow-Headers' response header.
    
    Returns:
    
    Netty3CorsConfigBuilder to support method chaining.
  - preflightResponseHeader
```
public Netty3CorsConfigBuilder preflightResponseHeader(java.lang.CharSequence name,
                                                       java.lang.Object... values)
```
    Returns HTTP response headers that should be added to a CORS preflight response. An intermediary like a load balancer might require that a CORS preflight request have certain headers set. This enables such headers to be added.
    
    Parameters:
    
    name - the name of the HTTP header.
    
    values - the values for the HTTP header.
    
    Returns:
    
    Netty3CorsConfigBuilder to support method chaining.
  - preflightResponseHeader
```
public <T> Netty3CorsConfigBuilder preflightResponseHeader(java.lang.CharSequence name,
                                                           java.lang.Iterable<T> value)
```
    Returns HTTP response headers that should be added to a CORS preflight response. An intermediary like a load balancer might require that a CORS preflight request have certain headers set. This enables such headers to be added.
    
    Type Parameters:
    
    T - the type of values that the Iterable contains.
    
    Parameters:
    
    name - the name of the HTTP header.
    
    value - the values for the HTTP header.
    
    Returns:
    
    Netty3CorsConfigBuilder to support method chaining.
  - preflightResponseHeader
```
public <T> Netty3CorsConfigBuilder preflightResponseHeader(java.lang.CharSequence name,
                                                           java.util.concurrent.Callable<T> valueGenerator)
```
    Returns HTTP response headers that should be added to a CORS preflight response. An intermediary like a load balancer might require that a CORS preflight request have certain headers set. This enables such headers to be added. Some values must be dynamically created when the HTTP response is created, for example the 'Date' response header. This can be accomplished by using a Callable which will have its 'call' method invoked when the HTTP response is created.
    
    Type Parameters:
    
    T - the type of the value that the Callable can return.
    
    Parameters:
    
    name - the name of the HTTP header.
    
    valueGenerator - a Callable which will be invoked at HTTP response creation.
    
    Returns:
    
    Netty3CorsConfigBuilder to support method chaining.
  - noPreflightResponseHeaders
```
public Netty3CorsConfigBuilder noPreflightResponseHeaders()
```
    Specifies that no preflight response headers should be added to a preflight response.
    
    Returns:
    
    Netty3CorsConfigBuilder to support method chaining.
  - shortCircuit
```
public Netty3CorsConfigBuilder shortCircuit()
```
    Specifies that a CORS request should be rejected if it's invalid before being further processing. CORS headers are set after a request is processed. This may not always be desired and this setting will check that the Origin is valid and if it is not valid no further processing will take place, and a error will be returned to the calling client.
    
    Returns:
    
    Netty3CorsConfigBuilder to support method chaining.
  - build
```
public Netty3CorsConfig build()
```
    Builds a Netty3CorsConfig with settings specified by previous method calls.
    
    Returns:
    
    Netty3CorsConfig the configured CorsConfig instance.

Class Netty3CorsConfigBuilder

Method Summary

Methods inherited from class java.lang.Object

Method Detail

forAnyOrigin

forOrigin

forPattern

forOrigins

disable

allowCredentials

maxAge

allowedRequestMethods

allowedRequestHeaders

preflightResponseHeader

preflightResponseHeader

preflightResponseHeader

noPreflightResponseHeaders

shortCircuit

build