com.opmath.test.dmldoc
Class UploadServlet

java.lang.Object
  |
  +--javax.servlet.GenericServlet
        |
        +--javax.servlet.http.HttpServlet
              |
              +--com.opmath.util.http.HttpServlet
                    |
                    +--com.opmath.test.dmldoc.UploadServlet

All Implemented Interfaces:

ParamIndex, Serializable, Servlet, ServletConfig

public class UploadServlet

extends HttpServlet

Example - a Servlet making use of DMLDoc and Jakarta Tomcat: File upload utility. Demonstrates the use of DMLDoc, as contained within Open Math Utilities v010 with Jakarta Tomcat 4.0 / Servlet 2.3 API.

Copyright: (c) 2002 The Open Math Company Limited

The Terms of Distribution of this software are stipulated in the javadoc Overview for this project.

Since:

J2SE 1.3.0, Java Servlet 2.3

Version:

ExpDMLDoc v1.0

Author:

Bruno Beloff bruno.beloff@opmath.com

See Also:

Serialized Form

Field Summary

static String	IMG_DIR The absolute local file path for uploaded images.
static String	IMG_REF The relative location of uploaded images.
static String	TPL_DIR The absolute local file path to the HTML templates used by the servlet.

Fields inherited from class com.opmath.util.http.HttpServlet

EOL, LOGON_DONE, LOGON_TARGET

Constructor Summary

UploadServlet()

Method Summary

void	destroy() Release the servlet's resources, including the mail client.
String	doGetDispatch(HttpServletRequest req) Respond to an HTTP GET request.
String	doPostDispatch(HttpServletRequest req) Respond to an HTTP POST request.
String	getServletInfo() Reports a summary of the servlet's identity.
void	init() Initialise the servlet.

Methods inherited from class com.opmath.util.http.HttpServlet

, doGet, doPost, getIndex, getParamIndex, getValueCount, paramIndices, paramMappings, paramNames, paramValues, registerIndex, registerIndices, report, setConfig, setConfig

Methods inherited from class javax.servlet.http.HttpServlet

doDelete, doHead, doOptions, doPut, doTrace, getLastModified, service, service

Methods inherited from class javax.servlet.GenericServlet

getInitParameter, getInitParameterNames, getServletConfig, getServletContext, getServletName, init, log, log

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

TPL_DIR

public static String TPL_DIR

The absolute local file path to the HTML templates used by the servlet. Should be initialised using web.xml.

Since:

J2SE 1.3

IMG_DIR

public static String IMG_DIR

The absolute local file path for uploaded images. Should be initialised using web.xml.

Since:

J2SE 1.3

IMG_REF

public static String IMG_REF

The relative location of uploaded images. Should be initialised using web.xml.

Since:

J2SE 1.3

Constructor Detail

UploadServlet

public UploadServlet()

Method Detail

init

public void init()
          throws ServletException,
                 UnavailableException

Initialise the servlet. Involked only by the servlet container.

Overrides:

init in class GenericServlet

Throws:

ServletException - not explicitly thrown within this method.

UnavailableException - if the servlet could not be initialised.

Since:

J2SE 1.3

doGetDispatch

public String doGetDispatch(HttpServletRequest req)
                     throws Exception

Respond to an HTTP GET request. Involked by doGet(..) on the servlet's superclass.

In this case, the servlet is responding to a GET request for the upload request form.

Overrides:

doGetDispatch in class HttpServlet

Parameters:

request - a com.opmath.util.http.HttpServletRequest instantiated by the container.

Throws:

Exception - if the request could not be satisfied.

Since:

J2SE 1.3

doPostDispatch

public String doPostDispatch(HttpServletRequest req)
                      throws Exception

Respond to an HTTP POST request. Involked by doPost(..) on the servlet's superclass.

In this case, the servlet is responding to a POST request carrying the uploaded data, and requesting the response form.

Overrides:

doPostDispatch in class HttpServlet

Parameters:

request - a com.opmath.util.http.HttpServletRequest instantiated by the container.

Throws:

Exception - if the request could not be satisfied.

Since:

J2SE 1.3

destroy

public void destroy()

Release the servlet's resources, including the mail client. (Involked only by the servlet container.)

Overrides:

destroy in class GenericServlet

Since:

J2SE 1.3

getServletInfo

public String getServletInfo()

Reports a summary of the servlet's identity.

Overrides:

getServletInfo in class HttpServlet

Returns:

A String describing this servlet.

Since:

J2SE 1.3