# libservlet

The Servlet API for Perl (`libservlet`) is a formulation of the Java (TM) Servlet API in Perl. The current version of the API is 2.3.

While the servlet concept originated with Java (TM), its component model is quite natural for Perl as well. By writing servlet applications and deploying them in a servlet container, application authors can spare themselves the effort of writing commonly needed web application infrastructure components for each new project. Furthermore, servlet applications are portable between deployment environments; they can be executed in any servlet container using any process model with only a few configuration changes and no application code changes. Servlet applications are insulated from changes in vendor or platform and are able to portably take advantage of standard web infrastructure services offered by any servlet container.

The current release of `libservlet` is version 0.9.1.

- Installation
- Documentation
- Mailing Lists
- References

## Installation

The easiest way to install libservlet is by using the CPAN module to bring down the entire bundle at once:

      perl -MCPAN -e 'install Bundle::libservlet'

The long way is to download the tarball and run through the process manually:

      lwp-download http://www.maz.org/libservlet/dist/libservlet-0.9.1.tar.gz
      tar xzvf libservlet-x.x.x.tar.gz
      cd libservlet-x.x.x
      perl Makefile.PL
      make
      make test
      make install

## Documentation

- API conversion details
- Class docs
- Writing servlet applications
- TODO

## Mailing Lists

- `libservlet@maz.org` - to communicate with others using libservlet to write servlet applications and containers
  [Subscribe] [Unsubscribe]

- `libservlet-cvs@maz.org` - to receive notifications of CVS commits
  [Subscribe] [Unsubscribe]

## References

These documents are written for the Java (TM) language, but they are very useful for learning the design of the API and seeing examples of servlets.

- Java (TM) Servlet 2.3 Specification (currently a Proposed Final Draft)
- Java (TM) Servlets web site
- The Java (TM) Tutorial