Package com.google.apphosting.runtime.jetty94

Class JettyServletEngineAdapter

java.lang.Object

com.google.apphosting.runtime.jetty94.JettyServletEngineAdapter

All Implemented Interfaces:

ServletEngineAdapter, UPRequestHandler

public class JettyServletEngineAdapter
extends Object
implements ServletEngineAdapter

This is an implementation of ServletEngineAdapter that uses the third-party Jetty servlet engine.

Nested Class Summary

Nested classes/interfaces inherited from interface com.google.apphosting.runtime.ServletEngineAdapter

ServletEngineAdapter.Config

Constructor Summary

Constructors

Constructor	Description
JettyServletEngineAdapter()
JettyServletEngineAdapter(Optional<WebAppContextFactory> contextFactory, Optional<com.google.apphosting.utils.config.AppYaml> appYaml)

Method Summary

Modifier and Type	Method	Description
void	addAppVersion(AppVersion appVersion)	Register the specified application version for future calls to serviceRequest.
void	deleteAppVersion(AppVersion appVersion)	Remove the specified application version and free up any resources associated with it.
void	serviceRequest(com.google.apphosting.base.protos.RuntimePb.UPRequest upRequest, MutableUpResponse upResponse)	Executes the HTTP request specified by upRequest and writes the response to upResponse.
void	setSessionStoreFactory(SessionStoreFactory factory)	Sets the SessionStoreFactory that will be used to create the list of SessionStores to which the HTTP Session will be stored, if sessions are enabled.
void	start(String serverInfo, ServletEngineAdapter.Config runtimeOptions)	Performs whatever setup is necessary for this servlet container.
void	stop()	Perform any shutdown procedures necessary for this servlet container.

Methods inherited from class java.lang.Object

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

Constructor Detail

JettyServletEngineAdapter

public JettyServletEngineAdapter()

JettyServletEngineAdapter

public JettyServletEngineAdapter(Optional<WebAppContextFactory> contextFactory,
                                 Optional<com.google.apphosting.utils.config.AppYaml> appYaml)

Method Detail

start

public void start(String serverInfo,
                  ServletEngineAdapter.Config runtimeOptions)

Description copied from interface: ServletEngineAdapter

Performs whatever setup is necessary for this servlet container. This method waits for setup to complete before returning.

Specified by:

start in interface ServletEngineAdapter

Parameters:

serverInfo - The string that should be returned by ServletContext.getServerInfo().

runtimeOptions - Extra options, currently used for the Jetty HTTP adapter only.

stop

public void stop()

Description copied from interface: ServletEngineAdapter

Perform any shutdown procedures necessary for this servlet container. This method should return once the shutdown has been completed.

Specified by:

stop in interface ServletEngineAdapter

addAppVersion

public void addAppVersion(AppVersion appVersion)
                   throws FileNotFoundException

Description copied from interface: ServletEngineAdapter

Register the specified application version for future calls to serviceRequest.

Specified by:

addAppVersion in interface ServletEngineAdapter

Throws:

FileNotFoundException - If any of the specified files could not be located.

deleteAppVersion

public void deleteAppVersion(AppVersion appVersion)

Description copied from interface: ServletEngineAdapter

Remove the specified application version and free up any resources associated with it.

Specified by:

deleteAppVersion in interface ServletEngineAdapter

setSessionStoreFactory

public void setSessionStoreFactory(SessionStoreFactory factory)

Sets the SessionStoreFactory that will be used to create the list of SessionStores to which the HTTP Session will be stored, if sessions are enabled. This method must be invoked after #start(String).

Specified by:

setSessionStoreFactory in interface ServletEngineAdapter

serviceRequest

public void serviceRequest(com.google.apphosting.base.protos.RuntimePb.UPRequest upRequest,
                           MutableUpResponse upResponse)
                    throws javax.servlet.ServletException,
                           IOException

Description copied from interface: UPRequestHandler

Executes the HTTP request specified by upRequest and writes the response to upResponse.

Finds, and if necessary, instantiates and initializes the appropriate servlet, invokes it, and copies the response into upResponse.

Specified by:

serviceRequest in interface UPRequestHandler

Throws:

IOException - If any error related to the request buffer was detected.

javax.servlet.ServletException