1*cdf0e10cSrcweirServlet for converting documents
2*cdf0e10cSrcweir================================
3*cdf0e10cSrcweir
4*cdf0e10cSrcweirBuild preparation:
5*cdf0e10cSrcweir==================
6*cdf0e10cSrcweirIn the file "ConverterServlet.html", search for the following line:
7*cdf0e10cSrcweir<form action="http://localhost:8080/conversion/servlet/ConverterServlet" method=post enctype="multipart/form-data">
8*cdf0e10cSrcweirReplace the existing IP address (localhost) with your intended IP address.
9*cdf0e10cSrcweir
10*cdf0e10cSrcweirInstallation instructions:
11*cdf0e10cSrcweir==========================
12*cdf0e10cSrcweir1. If no web server is available you should install your favourite web server.
13*cdf0e10cSrcweir   The example was tested with a Tomcat 4.1 server (http://jakarta.apache.org/tomcat/)
14*cdf0e10cSrcweir2. Download the servlet support Java archive (cos.jar) from
15*cdf0e10cSrcweir   http://www.servlets.com/cos/index.html and copy the file to the directory
16*cdf0e10cSrcweir   <OFFICE_HOME>/program/classes. If you don't use the created WAR (WAR = simple web archive file, it
17*cdf0e10cSrcweir   is similar to a normal Jar file) file, please make these classes also known to your web server.
18*cdf0e10cSrcweir3. You need also the Servlet API (servlet.jar). The Tomcat server comes with this Servlet API. Please
19*cdf0e10cSrcweir   copy the file "servlet.jar" to the directory <OFFICE_HOME>/program/classes.
20*cdf0e10cSrcweir   If you don't use the Tomcat server, make sure that the Servlet API is in the classpath of your web
21*cdf0e10cSrcweir   server. You can download the Servlet API from http://java.sun.com/products/servlet/index.html .
22*cdf0e10cSrcweir4. Use your GNU make (http://www.gnu.org) to build the servlet class.
23*cdf0e10cSrcweir5. Make the servlet class known to your web server.
24*cdf0e10cSrcweir   The example creates also a WAR file which can be easy deployed in a Tomcat server.
25*cdf0e10cSrcweir   5.1 Browse the 'Tomcat Web Application Manager'
26*cdf0e10cSrcweir   5.2 Navigate into the section 'Upload a WAR file to install'
27*cdf0e10cSrcweir   5.3 Browse to your generated WAR file and select it
28*cdf0e10cSrcweir   5.4 install it
29*cdf0e10cSrcweir
30*cdf0e10cSrcweir
31*cdf0e10cSrcweirConverting documents with the servlet:
32*cdf0e10cSrcweir======================================
33*cdf0e10cSrcweir1. Browse your web server "http://<your_ip>/conversion/ConverterServlet.html" or
34*cdf0e10cSrcweir   open the file "ConverterServlet.html" in your web browser and select a file.
35*cdf0e10cSrcweir2. Select a type to convert the file to, and the extension for the converted file.
36*cdf0e10cSrcweir3. Press the button. The document will be uploaded to the server, converted and
37*cdf0e10cSrcweir   pushed back to the client. Your browser will open a dialog for saving the
38*cdf0e10cSrcweir   converted document.
39