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