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