odk/examples/java/ConverterServlet/README

   1 Servlet for converting documents
   2 ================================
   3
   4 Build preparation:
   5 ==================
   6 In the file "ConverterServlet.html", search for the following line:
   7 <form action="http://localhost:8080/conversion/servlet/ConverterServlet" method=post enctype="multipart/form-data">
   8 Replace the existing IP address (localhost) with your intended IP address.
   9
  10 Installation instructions:
  11 ==========================
  12 1. 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/)
  14 2. 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.
  18 3. 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 .
  22 4. Use your GNU make (http://www.gnu.org) to build the servlet class.
  23 5. 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
  31 Converting documents with the servlet:
  32 ======================================
  33 1. 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.
  35 2. Select a type to convert the file to, and the extension for the converted file.
  36 3. 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.