aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorThomas Becker2013-09-18 11:24:32 (EDT)
committerThomas Becker2013-09-19 05:33:12 (EDT)
commitcea01925f78b2c0ab1883ff6c83d84570d2525dc (patch)
treebbcd7a9e0fb796918afa0130ab1f483fdc2310c8
parent317f4b7de186ff6546f281615dae6a8e9ba6ca54 (diff)
downloadorg.eclipse.jetty.project-cea01925f78b2c0ab1883ff6c83d84570d2525dc.zip
org.eclipse.jetty.project-cea01925f78b2c0ab1883ff6c83d84570d2525dc.tar.gz
org.eclipse.jetty.project-cea01925f78b2c0ab1883ff6c83d84570d2525dc.tar.bz2
416453 Add comments to embedded ManyConnectors example
-rw-r--r--examples/embedded/src/main/java/org/eclipse/jetty/embedded/ManyConnectors.java25
1 files changed, 24 insertions, 1 deletions
diff --git a/examples/embedded/src/main/java/org/eclipse/jetty/embedded/ManyConnectors.java b/examples/embedded/src/main/java/org/eclipse/jetty/embedded/ManyConnectors.java
index 92f5ddb..c68c798 100644
--- a/examples/embedded/src/main/java/org/eclipse/jetty/embedded/ManyConnectors.java
+++ b/examples/embedded/src/main/java/org/eclipse/jetty/embedded/ManyConnectors.java
@@ -35,40 +35,63 @@ public class ManyConnectors
{
public static void main(String[] args) throws Exception
{
+ // Since this example shows off SSL configuration, we need a keystore with the appropriate key. These two
+ // lines are purely a hack to get access to a keystore that we use in many unit tests and should probably be
+ // a direct path to your own keystore (used on line 29).
String jetty_home = System.getProperty("jetty.home","../../jetty-distribution/target/distribution");
System.setProperty("jetty.home", jetty_home);
- // The Server
+ // Create a basic jetty server object without declaring the port. Since we are configuring connectors
+ // directly we'll be setting ports on those connectors.
Server server = new Server();
// HTTP Configuration
+ // HttpConfiguration is a collection of configuration information appropriate for http and https. The default
+ // scheme for http is <code>http</code> of course, as the default for secured http is <code>https</code> but
+ // we show setting the scheme to show it can be done. The port for secured communication is also set here.
HttpConfiguration http_config = new HttpConfiguration();
http_config.setSecureScheme("https");
http_config.setSecurePort(8443);
http_config.setOutputBufferSize(32768);
// HTTP connector
+ // The first server connector we create is the one for http, passing in the http configuration we configured
+ // above so it can get things like the output buffer size, etc. We also set the port (8080) and configure an
+ // idle timeout.
ServerConnector http = new ServerConnector(server,new HttpConnectionFactory(http_config));
http.setPort(8080);
http.setIdleTimeout(30000);
// SSL Context Factory for HTTPS and SPDY
+ // SSL requires a certificate so we configure a factory for ssl contents with information pointing to what
+ // keystore the ssl connection needs to know about. Much more configuration is available the ssl context,
+ // including things like choosing the particular certificate out of a keystore to be used.
SslContextFactory sslContextFactory = new SslContextFactory();
sslContextFactory.setKeyStorePath(jetty_home + "/etc/keystore");
sslContextFactory.setKeyStorePassword("OBF:1vny1zlo1x8e1vnw1vn61x8g1zlu1vn4");
sslContextFactory.setKeyManagerPassword("OBF:1u2u1wml1z7s1z7a1wnl1u2g");
// HTTPS Configuration
+ // A new HttpConfiguration object is needed for the next connector and you can pass the old one as an
+ // argument to effectively clone the contents. On this HttpConfiguration object we add a
+ // SecureRequestCustomizer which is how a new connector is able to resolve the https connection before
+ // handing control over to the Jetty Server.
HttpConfiguration https_config = new HttpConfiguration(http_config);
https_config.addCustomizer(new SecureRequestCustomizer());
// HTTPS connector
+ // We create a second ServerConnector, passing in the http configuration we just made along with the
+ // previously created ssl context factory. Next we set the port and a longer idle timeout.
ServerConnector https = new ServerConnector(server,
new SslConnectionFactory(sslContextFactory,"http/1.1"),
new HttpConnectionFactory(https_config));
https.setPort(8443);
https.setIdleTimeout(500000);
+ // Here you see the server having multiple connectors registered with it, now requests can flow into the server
+ // from both http and https urls to their respective ports and be processed accordingly by jetty. A simple
+ // handler is also registered with the server so the example has something to pass requests off to.
+
// Set the connectors
server.setConnectors(new Connector[] { http, https });