Description: Add the one-class ALPN API (http://git.eclipse.org/c/jetty/org.eclipse.jetty.alpn.git)
--- /dev/null
+++ b/jetty-alpn/jetty-alpn-api/pom.xml
@@ -0,0 +1,117 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>org.eclipse.jetty.alpn</groupId>
+  <artifactId>alpn-api</artifactId>
+  <version>1.1.2.v20150522</version>
+  <name>Jetty :: ALPN :: API</name>
+
+  <scm>
+    <connection>scm:git:http://git.eclipse.org/gitroot/jetty/org.eclipse.jetty.alpn.git</connection>
+    <developerConnection>scm:git:ssh://git.eclipse.org/gitroot/jetty/org.eclipse.jetty.alpn.git</developerConnection>
+    <url>http://git.eclipse.org/c/jetty/org.eclipse.jetty.alpn.git/tree</url>
+  </scm>
+
+  <properties>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    <bundle-name>${project.artifactId}</bundle-name>
+    <bundle-symbolic-name>org.eclipse.jetty.alpn.api</bundle-symbolic-name>
+    <bundle-doc-url>http://www.eclipse.org/jetty/documentation/current/alpn-chapter.html</bundle-doc-url>
+  </properties>
+
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-enforcer-plugin</artifactId>
+        <version>1.1</version>
+        <executions>
+          <execution>
+            <id>enforce-versions</id>
+            <goals>
+              <goal>enforce</goal>
+            </goals>
+            <configuration>
+              <rules>
+                <requireJavaVersion>
+                  <version>[1.7-40,)</version>
+                  <message>[ERROR] OLD JDK [${java.version}] in use. Jetty ${project.version} requires JDK 1.7.0_40 or newer</message>
+                </requireJavaVersion>
+                <versionOsgiRule implementation="org.eclipse.jetty.toolchain.enforcer.rules.RequireOsgiCompatibleVersionRule" />
+              </rules>
+            </configuration>
+          </execution>
+        </executions>
+        <dependencies>
+           <dependency>
+             <groupId>org.eclipse.jetty.toolchain</groupId>
+             <artifactId>jetty-build-support</artifactId>
+             <version>1.1</version>
+           </dependency>
+        </dependencies>
+      </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <configuration>
+          <source>1.7</source>
+          <target>1.7</target>
+        </configuration>
+      </plugin>
+      <!-- Build helper maven plugin sets the parsedVersion.osgiVersion property -->
+      <plugin>
+        <groupId>org.codehaus.mojo</groupId>
+        <artifactId>build-helper-maven-plugin</artifactId>
+        <executions>
+          <execution>
+            <id>set-osgi-version</id>
+            <phase>validate</phase>
+            <goals>
+              <goal>parse-version</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>
+      <plugin>
+        <groupId>org.apache.felix</groupId>
+        <artifactId>maven-bundle-plugin</artifactId>
+        <extensions>true</extensions>
+        <executions>
+          <execution>
+            <goals>
+              <goal>manifest</goal>
+            </goals>
+            <configuration>
+              <instructions>
+                <_versionpolicy>[$(version;==;$(@)),$(version;+;$(@)))</_versionpolicy>
+                <Bundle-RequiredExecutionEnvironment>J2SE-1.7</Bundle-RequiredExecutionEnvironment>
+                <Bundle-DocURL>${bundle-doc-url}</Bundle-DocURL>
+                <Bundle-Vendor>Eclipse Jetty Project</Bundle-Vendor>
+                <Bundle-Name>${bundle-name}</Bundle-Name>
+                <Bundle-SymbolicName>${bundle-symbolic-name}</Bundle-SymbolicName>
+                <Bundle-Copyright>Copyright (c) 2008-2015 Mort Bay Consulting Pty. Ltd.</Bundle-Copyright>
+                <Export-Package>
+                  org.eclipse.jetty.alpn.*;version="${parsedVersion.majorVersion}.${parsedVersion.minorVersion}.${parsedVersion.incrementalVersion}"
+                </Export-Package>
+                <Import-Package>*</Import-Package>
+                <Bundle-Description>Application Layer Protocol Negotiation API</Bundle-Description>
+              </instructions>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
+      <plugin>
+        <!-- Required for OSGI -->
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-jar-plugin</artifactId>
+        <configuration>
+          <archive>
+            <manifestFile>${project.build.outputDirectory}/META-INF/MANIFEST.MF</manifestFile>
+          </archive>
+        </configuration>
+      </plugin>
+    </plugins>
+  </build>
+
+</project>
--- a/jetty-alpn/pom.xml
+++ b/jetty-alpn/pom.xml
@@ -11,6 +11,7 @@
   <description>Jetty ALPN services parent</description>
   <url>http://www.eclipse.org/jetty</url>
   <modules>
+    <module>jetty-alpn-api</module>
     <module>jetty-alpn-server</module>
     <module>jetty-alpn-client</module>
   </modules>
--- /dev/null
+++ b/jetty-alpn/jetty-alpn-api/src/main/java/org/eclipse/jetty/alpn/ALPN.java
@@ -0,0 +1,249 @@
+//
+//  ========================================================================
+//  Copyright (c) 1995-2015 Mort Bay Consulting Pty. Ltd.
+//  ------------------------------------------------------------------------
+//  All rights reserved. This program and the accompanying materials
+//  are made available under the terms of the Eclipse Public License v1.0
+//  and Apache License v2.0 which accompanies this distribution.
+//
+//      The Eclipse Public License is available at
+//      http://www.eclipse.org/legal/epl-v10.html
+//
+//      The Apache License v2.0 is available at
+//      http://www.opensource.org/licenses/apache2.0.php
+//
+//  You may elect to redistribute this code under either of these licenses.
+//  ========================================================================
+//
+
+package org.eclipse.jetty.alpn;
+
+import java.util.List;
+import java.util.Map;
+import java.util.concurrent.ConcurrentHashMap;
+
+import javax.net.ssl.SSLEngine;
+import javax.net.ssl.SSLException;
+import javax.net.ssl.SSLSocket;
+
+/**
+ * <p>{@link ALPN} provides an API to applications that want to make use of the
+ * <a href="http://tools.ietf.org/html/rfc7301">Application Layer Protocol Negotiation</a>.</p>
+ * <p>The ALPN extension is only available when using the TLS protocol, therefore applications must
+ * ensure that the TLS protocol is used:</p>
+ * <pre>
+ * SSLContext context = SSLContext.getInstance("TLSv1");
+ * </pre>
+ * <p>Refer to the
+ * <a href="http://docs.oracle.com/javase/7/docs/technotes/guides/security/StandardNames.html#SSLContext">list
+ * of standard SSLContext protocol names</a> for further information on TLS protocol versions supported.</p>
+ * <p>Applications must register instances of either {@link SSLSocket} or {@link SSLEngine} with a
+ * {@link ClientProvider} or with a {@link ServerProvider}, depending whether they are on client or
+ * server side.</p>
+ * <p>The ALPN implementation will invoke the provider callbacks to allow applications to interact
+ * with the negotiation of the protocol.</p>
+ * <p>Client side typical usage:</p>
+ * <pre>
+ * final SSLSocket sslSocket = ...;
+ * ALPN.put(sslSocket, new ALPN.ClientProvider()
+ * {
+ *     &#64;Override
+ *     public List&lt;String&gt; protocols()
+ *     {
+ *         return Arrays.asList("spdy/3", "http/1.1");
+ *     }
+ *
+ *     &#64;Override
+ *     public void unsupported()
+ *     {
+ *         ALPN.remove(sslSocket);
+ *     }
+ *
+ *     &#64;Override
+ *     public void selected(String protocol) throws SSLException
+ *     {
+ *         System.out.println("Selected protocol: " + protocol);
+ *         ALPN.remove(sslSocket);
+ *     }
+ *  });
+ * </pre>
+ * <p>Server side typical usage:</p>
+ * <pre>
+ * final SSLSocket sslSocket = ...;
+ * ALPN.put(sslSocket, new ALPN.ServerProvider()
+ * {
+ *     &#64;Override
+ *     public void unsupported()
+ *     {
+ *         ALPN.remove(sslSocket);
+ *     }
+ *
+ *     &#64;Override
+ *     public String select(List&lt;String&gt; protocols) throws SSLException
+ *     {
+ *         ALPN.remove(sslSocket);
+ *         return protocols.get(0);
+ *     }
+ *  });
+ * </pre>
+ * <p>Applications must ensure to deregister {@link SSLSocket} or {@link SSLEngine} instances,
+ * because they are kept in a JVM global map.
+ * Deregistration should typically happen when the application detects the end of the protocol
+ * negotiation, and/or when the associated socket connection is closed.</p>
+ * <p>In order to help application development, you can set the {@link ALPN#debug} field
+ * to {@code true} to have debug code printed to {@link System#err}.</p>
+ */
+public class ALPN
+{
+    /**
+     * Flag that enables printing of debug statements to {@link System#err}.
+     */
+    public static boolean debug = false;
+
+    private static Map<Object, Provider> objects = new ConcurrentHashMap<>();
+
+    private ALPN()
+    {
+    }
+
+    /**
+     * Registers a SSLSocket with a provider.
+     *
+     * @param socket   the socket to register with the provider
+     * @param provider the provider to register with the socket
+     * @see #remove(SSLSocket)
+     */
+    public static void put(SSLSocket socket, Provider provider)
+    {
+        objects.put(socket, provider);
+    }
+
+    /**
+     * @param socket a socket registered with {@link #put(SSLSocket, Provider)}
+     * @return the provider registered with the given socket
+     */
+    public static Provider get(SSLSocket socket)
+    {
+        return objects.get(socket);
+    }
+
+    /**
+     * Unregisters the given SSLSocket.
+     *
+     * @param socket the socket to unregister
+     * @return the provider registered with the socket
+     * @see #put(SSLSocket, Provider)
+     */
+    public static Provider remove(SSLSocket socket)
+    {
+        return objects.remove(socket);
+    }
+
+    /**
+     * Registers a SSLEngine with a provider.
+     *
+     * @param engine   the engine to register with the provider
+     * @param provider the provider to register with the engine
+     * @see #remove(SSLEngine)
+     */
+    public static void put(SSLEngine engine, Provider provider)
+    {
+        objects.put(engine, provider);
+    }
+
+    /**
+     * @param engine an engine registered with {@link #put(SSLEngine, Provider)}
+     * @return the provider registered with the given engine
+     */
+    public static Provider get(SSLEngine engine)
+    {
+        return objects.get(engine);
+    }
+
+    /**
+     * Unregisters the given SSLEngine.
+     *
+     * @param engine the engine to unregister
+     * @return the provider registered with the engine
+     * @see #put(SSLEngine, Provider)
+     */
+    public static Provider remove(SSLEngine engine)
+    {
+        return objects.remove(engine);
+    }
+
+    /**
+     * Base, empty, interface for providers.
+     */
+    public interface Provider
+    {
+    }
+
+    /**
+     * The client-side provider interface that applications must
+     * implement to interact with the negotiation of the protocol.
+     */
+    public interface ClientProvider extends Provider
+    {
+        /**
+         * <p>Callback invoked to let the implementation know the list
+         * of protocols that should be added to the ALPN extension in
+         * a ClientHello TLS message.</p>
+         *
+         * @return the list of protocols supported by the client;
+         * if {@code null} or empty, the ALPN extension is not sent
+         */
+        public List<String> protocols();
+
+        /**
+         * Callback invoked to let the client application know that
+         * the server does not support ALPN.
+         */
+        public void unsupported();
+
+        /**
+         * <p>Callback invoked to let the client application know
+         * the protocol chosen by the server.</p>
+         * <p>The implementation may throw an exception to indicate
+         * that the protocol selected by the server is not acceptable,
+         * causing the connection to be closed with a TLS alert of
+         * type {@code no_application_protocol(120)}.</p>
+         *
+         * @param protocol the protocol selected by the server.
+         * @throws SSLException if the protocol negotiation failed.
+         */
+        public void selected(String protocol) throws SSLException;
+    }
+
+    /**
+     * The server-side provider interface that applications must
+     * implement to interact with the negotiation of the protocol.
+     */
+    public interface ServerProvider extends Provider
+    {
+        /**
+         * Callback invoked to let the server application know that
+         * the client does not support ALPN.
+         */
+        public void unsupported();
+
+        /**
+         * <p>Callback invoked to let the server application select
+         * a protocol among the ones sent by the client.</p>
+         * <p>The implementation may throw an exception to indicate
+         * that the protocol negotiation is not possible,
+         * causing the connection to be closed with a TLS alert of
+         * type {@code no_application_protocol(120)}.</p>
+         *
+         * @param protocols the protocols sent by the client.
+         * @return the protocol selected by the server application.
+         * A {@code null} value will indicate the server will not
+         * include the {@code ALPN extension} message in the {@code ServerHello}
+         * message. This means the server appears as though it doesn't support
+         * ALPN and lets the client decide how to handle the situation.
+         * @throws SSLException if the protocol negotiation failed.
+         */
+        public String select(List<String> protocols) throws SSLException;
+    }
+}
+
