<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
"http://www.w3.org/TR/REC-html40/loose.dtd">
<html>
<head>
<title>libservlet</title>
<!-- thanks perldoc.com! -->
<link rel="stylesheet" href="./libservlet.css">
</head>
<body>
<h1>libservlet</h1>
<p>
The Servlet API for Perl (<code>libservlet</code>) is a formulation of
the Java (TM) Servlet API in Perl. The current version of the API is
<strong>2.3</strong>.
</p>
<p>
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.
</p>
<p>
The current release of <code>libservlet</code> is version <a
href="http://prdownloads.sourceforge.net/libservlet/libservlet-0.9.2.tar.gz">
<strong>0.9.2</strong></a>.
</p>
<p>
The web site for libservlet is <a
href="http://libservlet.sourceforge.net/">
http://libservlet.sourceforge.net/</a>,
and the project development site is <a
href="http://www.sourceforge.net/projects/libservlet/">
http://www.sourceforge.net/projects/libservlet/</a>.
</p>
<ul>
<li><a href="#installation">Installation</a>
<li><a href="#documentation">Documentation</a>
<li><a href="#mailing lists">Mailing Lists</a>
<li><a href="#references">References</a>
</ul>
<hr noshade>
<h2><a name="installation">Installation</a></h2>
<p>
The easiest way to install libservlet is by using the
<strong>CPAN</strong> module to bring down the entire bundle at once:
</p>
<pre>
perl -MCPAN -e 'install Bundle::libservlet'
</pre>
<p>
The long way is to download the tarball and run through the process
manually:
</p>
<pre>
lwp-download http://prdownloads.sourceforge.net/libservlet/libservlet-0.9.2.tar.gz
tar xzvf libservlet-0.9.2.tar.gz
cd libservlet-0.9.2
perl Makefile.PL
make
make test
make install
</pre>
<h2><a name="documentation">Documentation</a></h2>
<ul>
<li><a href="./conversion_details.html">API conversion details</a>
<li><a href="./api/">Class docs</a>
<li><a href="./writing_applications.html">Writing servlet
applications</a>
<li><a href="./TODO.html">TODO</a>
</ul>
<h2><a name="mailing lists">Mailing Lists</a></h2>
<p>
Subscription instructions and archives of the following lists are
available at <a href="http://sourceforge.net/mail/?group_id=31210">the
SourceForge project site</a>:
</p>
<ul>
<li>
<p>
<code>libservlet-announce@lists.sourceforge.net</code> - read-only
moderated announcements
</p>
<li>
<p>
<code>libservlet-bugs@lists.sourceforge.net</code> - bug notifications
</p>
<li>
<p>
<code>libservlet-commits@lists.sourceforge.net</code> - CVS commit
notifications
</p>
<li>
<p>
<code>libservlet-devel@lists.sourceforge.net</code> - servlet
application and container developer discussion
</p>
</ul>
<h2><a name="references">References</a></h2>
<p>
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.
</p>
<ul>
<li>
<a href="http://jcp.org/aboutJava/communityprocess/first/jsr053/index.html">
Java (TM) Servlet 2.3 Specification</a> (currently a Proposed Final Draft)
<li>
<a href="http://java.sun.com/products/servlet/">Java (TM) Servlets web
site</a>
<li>
<a href="http://java.sun.com/docs/books/tutorial/servlets/index.html">
The Java (TM) Tutorial</a>
</ul>
</body>
</html>