Http Service Servlets

Identifier:
org.eclipse.equinox.http.registry.servlets

Since:
1.0

Description:
This extension mimics and borrows the semantics of the OSGi HttpService registerServlet method.

Configuration Markup:

<!ELEMENT extension (serviceSelector? , servlet+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED

>


<!ELEMENT servlet (init-param*)>

<!ATTLIST servlet

class           CDATA #REQUIRED

alias           CDATA #REQUIRED

httpcontextId   CDATA #IMPLIED

load-on-startup (true | false)

>


<!ELEMENT init-param EMPTY>

<!ATTLIST init-param

name  CDATA #REQUIRED

value CDATA #REQUIRED

>

Similar to the Servlet Specification and its deployment descriptor's init-param elements.



<!ELEMENT serviceSelector EMPTY>

<!ATTLIST serviceSelector

filter CDATA #IMPLIED

class  CDATA #IMPLIED

>


Examples:
The following is an example of the servlets extension:

     <extension
           id="testServlet"
           point="org.eclipse.equinox.http.registry.servlets">
        <servlet
              alias="/sp_test"
              class="org.eclipse.equinox.http.registry.internal.TestServlet">
           <init-param
                 name="testParam"
                 value="test param value">
           </init-param>
        </servlet>
     </extension>
This equivalent to the OSGi Http Service's registerServlet method.

API Information:
Servlets must be an instance of javax.servlet.Servlet


Copyright (c) 2005-2007 Cognos Incorporated, IBM Corporation and others
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html.
Contributors:
Cognos Incorporated - initial API and implementation
IBM Corporation - bug fixes and enhancements