Package org.glassfish.grizzly.osgi.httpservice

Class HttpServiceImpl

java.lang.Object

org.glassfish.grizzly.osgi.httpservice.HttpServiceImpl

All Implemented Interfaces:

HttpServiceExtension, org.osgi.service.http.HttpService

public class HttpServiceImpl
extends Object
implements HttpServiceExtension

Grizzly OSGi HttpService implementation.

Since:

Jan 20, 2009

Author:

Hubert Iwaniuk

Constructor Summary

Constructors

Constructor	Description
HttpServiceImpl(org.osgi.framework.Bundle bundle, Logger logger)	HttpService constructor.

Method Summary

Modifier and Type	Method	Description
org.osgi.service.http.HttpContext	createDefaultHttpContext()
void	registerFilter(javax.servlet.Filter filter, String urlPattern, Dictionary initParams, org.osgi.service.http.HttpContext context)	Registers a Filter and with the HttpService.
void	registerResources(String alias, String prefix, org.osgi.service.http.HttpContext httpContext)
void	registerServlet(String alias, javax.servlet.Servlet servlet, Dictionary initparams, org.osgi.service.http.HttpContext httpContext)
void	unregister(String alias)
void	unregisterFilter(javax.servlet.Filter filter)	Removes the specified Filter from the service.

Methods inherited from class java.lang.Object

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

Constructor Details

HttpServiceImpl

public HttpServiceImpl(org.osgi.framework.Bundle bundle,
 Logger logger)

HttpService constructor.

Parameters:

bundle - Bundle that got this instance of HttpService.

logger - Logger utility to be used here.

Method Details

createDefaultHttpContext

public org.osgi.service.http.HttpContext createDefaultHttpContext()

Specified by:

createDefaultHttpContext in interface org.osgi.service.http.HttpService

registerServlet

public void registerServlet(String alias,
 javax.servlet.Servlet servlet,
 Dictionary initparams,
 org.osgi.service.http.HttpContext httpContext)
                     throws javax.servlet.ServletException,
org.osgi.service.http.NamespaceException

Specified by:

registerServlet in interface org.osgi.service.http.HttpService

Throws:

javax.servlet.ServletException

org.osgi.service.http.NamespaceException

registerResources

public void registerResources(String alias,
 String prefix,
 org.osgi.service.http.HttpContext httpContext)
                       throws org.osgi.service.http.NamespaceException

Specified by:

registerResources in interface org.osgi.service.http.HttpService

Throws:

org.osgi.service.http.NamespaceException

unregister

public void unregister(String alias)

Specified by:

unregister in interface org.osgi.service.http.HttpService

registerFilter

public void registerFilter(javax.servlet.Filter filter,
 String urlPattern,
 Dictionary initParams,
 org.osgi.service.http.HttpContext context)
                    throws javax.servlet.ServletException

Registers a Filter and with the HttpService. As this is an extension to the standard HttpService and there are no clear rules on how the mapping of filters should occur, this implementation follows the mapping rules as defined by the Servlet specification. Additionally, it should be noted that the registered Filters are effectively associated with a particular HttpContext. Therefore, if you wish to have multiple filters associated with a particular Servlet, then you should use the same HttpContext instance to perform the registration. Filters will be invoked in registration order. This method will invoke Filter.init(javax.servlet.FilterConfig) during the registration process. When registering a Filter, take care not to reuse the same Filter instance across multiple registration invocations. This could cause issues when removing the Filter as it may remove more url matching possibilities than intended.

Specified by:

registerFilter in interface HttpServiceExtension

Parameters:

filter - the Filter to register.

urlPattern - the url pattern that will invoke this Filter.

initParams - the initialization params that will be passed to the filter when Filter.init(javax.servlet.FilterConfig) is invoked.

context - the HttpContext associated with this Filter.

Throws:

javax.servlet.ServletException - if an error occurs during Filter initialization.

unregisterFilter

public void unregisterFilter(javax.servlet.Filter filter)

Removes the specified Filter from the service.

Specified by:

unregisterFilter in interface HttpServiceExtension

Parameters:

filter - the Filter to remove.