org.glassfish.jersey.netty.httpserver

Class NettyHttpContainerProvider

java.lang.Object

org.glassfish.jersey.netty.httpserver.NettyHttpContainerProvider

All Implemented Interfaces:

ContainerProvider

@Beta
public class NettyHttpContainerProvider
extends Object
implements ContainerProvider

Netty implementation of ContainerProvider.

There is also a few "factory" methods for creating Netty server.

Since:

2.24

Author:

Pavel Bucek

Constructor Summary

Constructors

Constructor and Description
NettyHttpContainerProvider()

Method Summary

Modifier and Type	Method and Description
<T> T	createContainer(Class<T> type, javax.ws.rs.core.Application application)
static io.netty.channel.Channel	createHttp2Server(URI baseUri, ResourceConfig configuration, io.netty.handler.ssl.SslContext sslContext) Create and start Netty HTTP/2 server.
static io.netty.channel.Channel	createServer(URI baseUri, ResourceConfig configuration, boolean block) Create and start Netty server.
static io.netty.channel.Channel	createServer(URI baseUri, ResourceConfig configuration, io.netty.handler.ssl.SslContext sslContext, boolean block) Create and start Netty server.

Methods inherited from class java.lang.Object

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

Constructor Detail

NettyHttpContainerProvider

public NettyHttpContainerProvider()

Method Detail

createContainer

public <T> T createContainer(Class<T> type,
                             javax.ws.rs.core.Application application)
                      throws javax.ws.rs.ProcessingException

Specified by:

createContainer in interface ContainerProvider

Throws:

javax.ws.rs.ProcessingException

createServer

public static io.netty.channel.Channel createServer(URI baseUri,
                                                    ResourceConfig configuration,
                                                    io.netty.handler.ssl.SslContext sslContext,
                                                    boolean block)
                                             throws javax.ws.rs.ProcessingException

Create and start Netty server.

Parameters:

baseUri - base uri.

configuration - Jersey configuration.

sslContext - Netty SSL context (can be null).

block - when true, this method will block until the server is stopped. When false, the execution will end immediately after the server is started.

Returns:

Netty channel instance.

Throws:

javax.ws.rs.ProcessingException - when there is an issue with creating new container.

createServer

public static io.netty.channel.Channel createServer(URI baseUri,
                                                    ResourceConfig configuration,
                                                    boolean block)
                                             throws javax.ws.rs.ProcessingException

Create and start Netty server.

Parameters:

baseUri - base uri.

configuration - Jersey configuration.

block - when true, this method will block until the server is stopped. When false, the execution will end immediately after the server is started.

Returns:

Netty channel instance.

Throws:

javax.ws.rs.ProcessingException - when there is an issue with creating new container.

createHttp2Server

public static io.netty.channel.Channel createHttp2Server(URI baseUri,
                                                         ResourceConfig configuration,
                                                         io.netty.handler.ssl.SslContext sslContext)
                                                  throws javax.ws.rs.ProcessingException

Create and start Netty HTTP/2 server.

The server is capable of connection upgrade to HTTP/2. HTTP/1.x request will be server as they were used to.

Note that this implementation cannot be more experimental. Any contributions / feedback is welcomed.

Parameters:

baseUri - base uri.

configuration - Jersey configuration.

sslContext - Netty SslContext.

Returns:

Netty channel instance.

Throws:

javax.ws.rs.ProcessingException - when there is an issue with creating new container.