MuServerBuilder (mu-server 0.19.4 API)

java.lang.Object
- io.muserver.MuServerBuilder

```
public class MuServerBuilder
extends Object
```
A builder for creating a web server.

Use the withXXX() methods to set the ports, config, and request handlers needed.

Constructor Summary

Constructors
Constructor and Description

MuServerBuilder()

Constructors
Constructor and Description
`MuServerBuilder()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`MuServerBuilder`	`addAsyncHandler(AsyncMuHandler handler)` Deprecated. For async handling, add a normal `MuHandler` and call `MuRequest.handleAsync()`
`MuServerBuilder`	`addHandler(Method method, String uriTemplate, RouteHandler handler)` Registers a new handler that will only be called if it matches the given route info
`MuServerBuilder`	`addHandler(MuHandler handler)` Adds a request handler.
`MuServerBuilder`	`addHandler(MuHandlerBuilder handler)` Adds a request handler.
`MuServerBuilder`	`addShutdownHook(boolean stopServerOnShutdown)`
`static MuServerBuilder`	`httpServer()` Creates a new server builder which will run as HTTP on a random port.
`static MuServerBuilder`	`httpsServer()` Creates a new server builder which will run as HTTPS on a random port.
`static MuServerBuilder`	`muServer()` Creates a new server builder.
`MuServer`	`start()` Creates and starts this server.
`MuServerBuilder`	`withGzip(long minimumGzipSize, Set<String> mimeTypesToGzip)` Enables gzip for files of at least the specified size that match the given mime-types.
`MuServerBuilder`	`withGzipEnabled(boolean enabled)` Enables gzip for certain resource types.
`MuServerBuilder`	`withHttpConnection(int port)` Deprecated. Use `withHttpPort(int)` instead
`MuServerBuilder`	`withHttpDisabled()` Deprecated. It is off by default so this is not needed.
`MuServerBuilder`	`withHttpPort(int port)`
`MuServerBuilder`	`withHttpsConfig(SSLContext sslContext)` Sets the HTTPS config.
`MuServerBuilder`	`withHttpsConfig(SSLContextBuilder sslContext)` Sets the HTTPS config.
`MuServerBuilder`	`withHttpsConnection(int port, SSLContext sslEngine)` Deprecated. use `withHttpsPort(int)` and `withHttpsConfig(SSLContext)` instead.
`MuServerBuilder`	`withHttpsPort(int port)` Sets the HTTPS port to use.
`MuServerBuilder`	`withInterface(String host)` Use this to specify which network interface to bind to.
`MuServerBuilder`	`withMaxHeadersSize(int size)` Specifies the maximum size in bytes of the HTTP request headers.
`MuServerBuilder`	`withMaxUrlSize(int size)` The maximum length that a URL can be.

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

- Constructor Detail
  - MuServerBuilder
```
public MuServerBuilder()
```
- Method Detail
  - withHttpPort
```
public MuServerBuilder withHttpPort(int port)
```
    Parameters:
    
    port - The HTTP port to use. A value of 0 will have a random port assigned; a value of -1 will result in no HTTP connector.
    
    Returns:
    
    The current Mu-Server Builder
  - withInterface
```
public MuServerBuilder withInterface(String host)
```
    Use this to specify which network interface to bind to.
    
    Parameters:
    
    host - The host to bind to, for example "127.0.0.1" to restrict connections from localhost only, or "0.0.0.0" to allow connections from the local network.
    
    Returns:
    
    The current Mu-Server Builder
  - addShutdownHook
```
public MuServerBuilder addShutdownHook(boolean stopServerOnShutdown)
```
    Parameters:
    
    stopServerOnShutdown - If true, then a shutdown hook which stops this server will be added to the JVM Runtime
    
    Returns:
    
    The current Mu-Server Builder
  - withHttpConnection
```
@Deprecated
public MuServerBuilder withHttpConnection(int port)
```
    Deprecated. Use withHttpPort(int) instead
    
    Parameters:
    
    port - The HTTP port to use. A value of 0 will have a random port assigned; a value of -1 will result in no HTTP connector.
    
    Returns:
    
    The current Mu-Server Builder
  - withGzipEnabled
```
public MuServerBuilder withGzipEnabled(boolean enabled)
```
    Enables gzip for certain resource types. The default is true. By default, the gzippable resource types are taken from ResourceType.getResourceTypes() where ResourceType.gzip is true.
    
    Parameters:
    
    enabled - True to enable; false to disable
    
    Returns:
    
    The current Mu-Server builder
    
    See Also:
    
    withGzip(long, Set)
  - withGzip
```
public MuServerBuilder withGzip(long minimumGzipSize,
                                Set<String> mimeTypesToGzip)
```
    Enables gzip for files of at least the specified size that match the given mime-types. By default, gzip is enabled for text-based mime types over 1400 bytes. It is recommended to keep the defaults and only use this method if you have very specific requirements around GZIP.
    
    Parameters:
    
    minimumGzipSize - The size in bytes before gzip is used. The default is 1400.
    
    mimeTypesToGzip - The mime-types that should be gzipped. In general, only text files should be gzipped.
    
    Returns:
    
    The current Mu-Server Builder
  - withHttpDisabled
```
@Deprecated
public MuServerBuilder withHttpDisabled()
```
    Deprecated. It is off by default so this is not needed.
    
    Turns off HTTP.
    
    Returns:
    
    The current builder.
  - withHttpsConnection
```
@Deprecated
public MuServerBuilder withHttpsConnection(int port,
                                                        SSLContext sslEngine)
```
    Deprecated. use withHttpsPort(int) and withHttpsConfig(SSLContext) instead.
    
    Parameters:
    
    port - The port
    
    sslEngine - The SSL Context
    
    Returns:
    
    The builder
  - withHttpsConfig
```
public MuServerBuilder withHttpsConfig(SSLContext sslContext)
```
    Sets the HTTPS config. Defaults to SSLContextBuilder.unsignedLocalhostCert()
    
    Parameters:
    
    sslContext - An SSL Context.
    
    Returns:
    
    The current Mu-Server Builder
    
    See Also:
    
    SSLContextBuilder
  - withHttpsConfig
```
public MuServerBuilder withHttpsConfig(SSLContextBuilder sslContext)
```
    Sets the HTTPS config. Defaults to SSLContextBuilder.unsignedLocalhostCert()
    
    Parameters:
    
    sslContext - An SSL Context builder.
    
    Returns:
    
    The current Mu-Server Builder
    
    See Also:
    
    SSLContextBuilder
  - withHttpsPort
```
public MuServerBuilder withHttpsPort(int port)
```
    Sets the HTTPS port to use. To set the SSL certificate config, see withHttpsConfig(SSLContextBuilder)
    
    Parameters:
    
    port - A value of 0 will result in a random port being assigned; a value of -1 will disable HTTPS.
    
    Returns:
    
    The current Mu-Server builder
  - withMaxHeadersSize
```
public MuServerBuilder withMaxHeadersSize(int size)
```
    Specifies the maximum size in bytes of the HTTP request headers. Defaults to 8192.
    
    If a request has headers exceeding this value, it will be rejected and a 431 status code will be returned. Large values increase the risk of Denial-of-Service attacks due to the extra memory allocated in each request.
    
    It is recommended to not specify a value unless you are finding legitimate requests are being rejected with 413 errors.
    
    Parameters:
    
    size - The maximum size in bytes that can be used for headers.
    
    Returns:
    
    The current Mu-Server builder.
  - withMaxUrlSize
```
public MuServerBuilder withMaxUrlSize(int size)
```
    The maximum length that a URL can be. If it exceeds this value, a 414 error is returned to the client. The default value is 8175.
    
    Parameters:
    
    size - The maximum number of characters allowed in URLs sent to this server.
    
    Returns:
    
    The current Mu-Server builder
  - addAsyncHandler
```
@Deprecated
public MuServerBuilder addAsyncHandler(AsyncMuHandler handler)
```
    Deprecated. For async handling, add a normal MuHandler and call MuRequest.handleAsync()
    
    xAdds a new Asynchronous handler. This is for cases where async handling of requests and responses is required; in other cases use addHandler(MuHandler), addHandler(MuHandlerBuilder) or addHandler(Method, String, RouteHandler).
    
    Note that async handlers are executed in the order added to the builder, but all async handlers are executed before synchronous handlers.
    
    Parameters:
    
    handler - An Async Handler
    
    Returns:
    
    The current Mu-Server builder
  - addHandler
```
public MuServerBuilder addHandler(MuHandlerBuilder handler)
```
    Adds a request handler.
    
    Note that handlers are executed in the order added to the builder, but all async handlers are executed before synchronous handlers.
    
    Parameters:
    
    handler - A handler builder. The build() method will be called on this to create the handler. If null, then no handler is added.
    
    Returns:
    
    The current Mu-Server Handler.
    
    See Also:
    
    addHandler(Method, String, RouteHandler)
  - addHandler
```
public MuServerBuilder addHandler(MuHandler handler)
```
    Adds a request handler.
    
    Note that handlers are executed in the order added to the builder, but all async handlers are executed before synchronous handlers.
    
    Parameters:
    
    handler - The handler to add. If null, then no handler is added.
    
    Returns:
    
    The current Mu-Server Handler.
    
    See Also:
    
    addHandler(Method, String, RouteHandler)
  - addHandler
```
public MuServerBuilder addHandler(Method method,
                                  String uriTemplate,
                                  RouteHandler handler)
```
    Registers a new handler that will only be called if it matches the given route info
    
    Parameters:
    
    method - The method to match, or null to accept any method.
    
    uriTemplate - A URL template. Supports plain URLs like /abc or paths with named parameters such as /abc/{id} or named parameters with regexes such as /abc/{id : [0-9]+} where the named parameter values can be accessed with the pathParams parameter in the route handler.
    
    handler - The handler to invoke if the method and URI matches. If null, then no handler is added.
    
    Returns:
    
    Returns the server builder
  - start
```
public MuServer start()
```
    Creates and starts this server. An exception is thrown if it fails to start.
    
    Returns:
    
    The running server.
  - muServer
```
public static MuServerBuilder muServer()
```
    Creates a new server builder. Call withHttpsPort(int) or withHttpPort(int) to specify the port to use, and call start() to start the server.
    
    Returns:
    
    A new Mu-Server builder
  - httpServer
```
public static MuServerBuilder httpServer()
```
    Creates a new server builder which will run as HTTP on a random port.
    
    Returns:
    
    A new Mu-Server builder with the HTTP port set to 0
  - httpsServer
```
public static MuServerBuilder httpsServer()
```
    Creates a new server builder which will run as HTTPS on a random port.
    
    Returns:
    
    A new Mu-Server builder with the HTTPS port set to 0

Class MuServerBuilder

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

MuServerBuilder

Method Detail

withHttpPort

withInterface

addShutdownHook

withHttpConnection

withGzipEnabled

withGzip

withHttpDisabled

withHttpsConnection

withHttpsConfig

withHttpsConfig

withHttpsPort

withMaxHeadersSize

withMaxUrlSize

addAsyncHandler

addHandler

addHandler

addHandler

start

muServer

httpServer

httpsServer