org.webpieces.frontend2.api.HttpFrontendManager Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of http-frontend2 Show documentation

Create a webserver with this library in just 3 lines of code. just register your HttpRequestListener and it feeds you a FrontendSocket that you write HttpResponses to

There is a newer version: 2.1.1

Show newest version

package org.webpieces.frontend2.api;

import org.webpieces.nio.api.SSLEngineFactory;

public interface HttpFrontendManager {

	/**
	 * A Front-end server where you cannot upgrade to SSL with incoming 'CONNECT' message. ie. not used for Proxies
	 * @return
	 */
	HttpServer createHttpServer(HttpSvrConfig config, StreamListener listener);
	
	/**
	 * Creates an https server that gives you requests with isHttps set to true.  IF you pass in a 
	 * null SSLEngineFactory, it will open the port as an http port but isHttps will still be set to 
	 * true.  This is specifically for situations where you terminate SSL at the firewall and then do
	 * http internally(I prefer not do that personally).
	 */
	HttpServer createHttpsServer(HttpSvrConfig config, StreamListener listener, SSLEngineFactory factory);

	/**
	 * A Front-end server where connections can have http OR https come into the port.  This uses more objects
	 * than createHttpServer.  If you are using ust http, createHtpServer is far simpler an easier to trace
	 * through.
	 */
	HttpServer createUpgradableServer(HttpSvrConfig config, StreamListener listener, SSLEngineFactory factory);	
	
	/**
	 * A special server where the only difference is each request will tell you that it came in on the 
	 * Backend server port.  You can have your backend server be http or https BUT all requests will
	 * have isHttps set to TRUE.  Just pass in null for the SSLEngineFactory and it will 
	 * create an http server
	 */
	HttpServer createBackendHttpsServer(HttpSvrConfig config, StreamListener listener, SSLEngineFactory factory);
	
}