| 
 |   | ||||||||
| PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES | ||||||||
See:
          Description
| Class Summary | |
| BrazilServlet | This is the Brazil Toolkit Servlet Adapter. | 
| BServletRequest | This is a subclass of Requestthat is used byBrazilServletto map servlet style requests and responses
 to and from Brazil style requests. | 
| BServletRequest.HttpOutputStream | An HttpOutputStreamthat is used by the Brazil Servlet
 adaptor to add the web application
 context path to the front of all response URI's so subsequent requests
 will be mapped to theBrazilServlet's context. | 
| BServletServerSocket | This is a special ServerSocketintended for use by the
 Brazil Servlet Adapter. | 
| BServletSocket | This is a special Socketintended for use by the Brazil
 Servlet Adapter. | 
Run a Brazil application as a Servlet.
This is the Brazil Toolkit Servlet Adapter.  It allows one to run
applications built with the Brazil Toolkit in any web server that
provides a Servlet container that implements
at least the
Servlet
2.2 API 
When running a Brazil application as a servlet, 
sunlabs.brazil.server.Main is not used to start the application;
the servlet container starts the application instead.  The deployment
descriptor parameters config and root
are used to locate the Brazil server configuration
files, and to define the document root, respectively.
To allow identical Brazil configurations to operate unchanged, either standalone or as a servlet, the application context portion of the URL is removed before Brazil handlers access requests. Similarly, any HTML content produced by the Brazil application is re-written to prepend the application context onto any rooted (e.g. starts with '/') URL.
For example, if a brazil application is deployed in the servlet context:
brazil-servlet, then an http request to the server of
the form:
http://www.myhost.com/brazil-servlet/foo.htmlwill appear to the Brazil application with a URL of:
/foo.html. An HTML response from the Brazil application of the form:
<a href="/foo.html"> ...will automatically be rewritten to:
<a href="/brazil-servlet/foo.html"> ...
The servlet should be installed as a web application as specified in
the Java Servlet Specification, v2.2.  The servlet deployment
descriptor should create a configuration that causes the request path
to consist of only the context path and pathInfo elements.  There
should not be a servlet path element.  See section 5 of the
specification for more details (note that the definitions of each path
element are are more accurately stated in the 2.3 specification).  The
deployment descriptor should be similar to the following:
<web-app>
    <display-name>BrazilServlet servlet container for Brazil</display-name>
    <description>
	This servlet wraps the Brazil Toolkit so it can run within
	any web server environment that supports the 2.2 Servlet API
    </description>
    <servlet>
        <servlet-name>BrazilServlet</servlet-name>
        <servlet-class>sunlabs.brazil.server.BrazilServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>BrazilServlet</servlet-name>
        <url-pattern>/*</url-pattern>
    </servlet-mapping>
</web-app>
See
BrazilServlet
for more instructions.
| 
 | Version 2.1, Generated 12/30/04 Copyright (c) 2001-2004, Sun Microsystems. | ||||||||
| PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES | ||||||||