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