org.glassfish.grizzly:grizzly-npn-osgi

This empty module allows the bootclasspath classes in org.glassfish.grizzly.npn to be available via the OSGi classloading mechanisms. Using GlassFish as an example: - grizzly-npn-bootstrap.jar goes into the domain's bootclasspath (-Xbootclasspath/p:[PATH TO THE JAR]) - grizzly-npn-osgi and grizzly-spdy JARs go into the $GF_HOME/modules directory.

License	EPL-2.0
Categories	GlassFish Container Application Servers Grizzly Net Networking
GroupId	org.glassfish.grizzly
ArtifactId	grizzly-npn-osgi
Last Version	2.0.0
Release Date	Nov 21, 2020
Type	jar
Description	This empty module allows the bootclasspath classes in org.glassfish.grizzly.npn to be available via the OSGi classloading mechanisms. Using GlassFish as an example: - grizzly-npn-bootstrap.jar goes into the domain's bootclasspath (-Xbootclasspath/p:[PATH TO THE JAR]) - grizzly-npn-osgi and grizzly-spdy JARs go into the $GF_HOME/modules directory.
Project URL	https://projects.eclipse.org/projects/ee4j.grizzly/grizzly-npn-osgi
Project Organization	Oracle Corporation

Download grizzly-npn-osgi

Filename	Size
grizzly-npn-osgi-2.0.0.pom
grizzly-npn-osgi-2.0.0.jar	2 KB
grizzly-npn-osgi-2.0.0-javadoc.jar	342 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.glassfish.grizzly/grizzly-npn-osgi/ -->
<dependency>
    <groupId>org.glassfish.grizzly</groupId>
    <artifactId>grizzly-npn-osgi</artifactId>
    <version>2.0.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.glassfish.grizzly/grizzly-npn-osgi/
implementation 'org.glassfish.grizzly:grizzly-npn-osgi:2.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.glassfish.grizzly/grizzly-npn-osgi/
implementation ("org.glassfish.grizzly:grizzly-npn-osgi:2.0.0")

Apache Buildr

'org.glassfish.grizzly:grizzly-npn-osgi:jar:2.0.0'

Apache Ivy

<dependency org="org.glassfish.grizzly" name="grizzly-npn-osgi" rev="2.0.0">
  <artifact name="grizzly-npn-osgi" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.glassfish.grizzly', module='grizzly-npn-osgi', version='2.0.0')
)

Scala SBT

libraryDependencies += "org.glassfish.grizzly" % "grizzly-npn-osgi" % "2.0.0"

Leiningen

[org.glassfish.grizzly/grizzly-npn-osgi "2.0.0"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

This module interfaces with the TLS implementation of Oracle JDK8 to provide an implementation of ALPN. The module was written for use in Grizzly, but is intended as a general purpose solution to allow JDK8 based software to use ALPN.

How Grizzly Uses This Module

Grizzly has the concept of an AddOn. This facility allows Grizzly to be extended using an implementation of the Chain of Responsibility design pattern. In general, an AddOn implementation will insert one or more Filter implementations into the FilterChain which is used to process HTTP requests and cause HTTP responses to be sent.

Grizzly itself uses this AddOn concept to provide HTTP/2 support, in the form of Http2AddOn In addition to registering filters for HTTP/2 processing, this AddOn implementation registers a callback withthe ALPN extension to insert itself into the SSL Handshake process

Programmatic Configuration

AddOn has a setup method that is called to allow the implementation to do whatever one-time setup is required to make things work. The setup override in the Http2AddOn takes the following actions if the current connection is secure (that is, it is supposed to be using ALPN).

• Use the addHandshakeListener method of the existing SSLBaseFilter to cause an ALPN specific SSL handshake listener to be added to the existing list of listeners that are invoked when an ssl handshake happens.

  Grizzly's handshake listener has several methods, but the only one used is onStart. This obtains the JDK SSLEngine and takes different action depending on the return from its getUseClientMode() method. The grizzly-npn module provides AlpnClientNegotiator and AlpnServerNegotiator interfaces for these two cases. Please see the interfaces for the specification of the required actions.

  If getUseClientMode is true,

  • use the grizzly addCloseListener facility to install a listener that calls NegotiationSupport .removeClientNegotiator(). This will ensure the client negotiator is removed when the connection closes.

  • Call NegotiationSupport.addNegotiator passing the SSLEngine and the client negotiator impl.

  If getUseClientmode is false,

  • do the same as above, but use the server negotiator impl.

  By the time onStart is invoked, the handshake listener will have been initialized with implementations of AlpnClientNegotiator and AlpnServerNegotiator by the Http2AddOn.

Deployment Configuration

The above programmatic configuration steps will make it so the simple act of including the module built from the bootstrap sub-module of this repository in the bootclasspath of the JVM will enable ALPN support in that JVM.

Eclipse EE4J

The Eclipse EE4J Project

Versions

Version
2.0.0 Nov 21, 2020
1.9 Jan 3, 2019
1.8.1 Oct 25, 2018
1.8 Feb 11, 2018
1.7 Feb 23, 2017
1.6 Feb 18, 2017
1.5 Jan 19, 2017
1_4 Jan 18, 2017
1.3 Jun 28, 2016
1.2 Mar 17, 2015
1.1 Dec 3, 2013
1.0 Apr 2, 2013
1.0-beta1 Mar 23, 2013