To deploy the created application to a web server, you need to create a WAR package. Here we give the instructions for Eclipse.

Open project properties and first set the name and destination of the WAR file in Tomcat Export to WAR settings tab. Exporting to WAR is done by selecting Export to WAR from Tomcat Project in project context menu (just click calc with right mouse button on Package contents tree.

The following files are required in a web application in order to run it.

The deployment descriptor is an XML file with name web.xml in WEB-INF directory of a web application. It is a standard component in Java EE that describes how a web application should be deployed. The structure of the deployment descriptor is illustrated by the following example. You simply deploy applications as servlets implemented by the special com.itmill.toolkit.terminal.gwt.server.ApplicationServlet wrapper class. The class of the actual application is specified by giving the application parameter with the name of the specific application class to the servlet. The servlet is then connected to a URL in a standard way for Java Servlets.

<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_ID" version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
                        http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

    <servlet>
        <servlet-name>myservlet</servlet-name>
        <servlet-class>com.itmill.toolkit.terminal.gwt.server.ApplicationSer
                     vlet</servlet-class>
        <init-param>
            <param-name>application</param-name>
            <param-value>MyApplicationClass</param-value>
        </init-param>
    </servlet>
    <servlet-mapping>
        <servlet-name>myservlet</servlet-name>
        <url-pattern>/*</url-pattern>
    </servlet-mapping>
</web-app>

For a complete example on how to deploy applications, see demo/itmill-toolkit.war that includes demo applications. You can simply deploy this web application to your favorite application server by server specific means. For example, in Apache Tomcat you simply copy the WAR file to the webapps directory.

If you wish to examine the contents of the WAR file, you can decompress it using a standard ZIP or JAR decompressor. For some ZIP implementations, you must rename the file to itmill-toolkit.zip .

Deployment descriptor can have many parameters and options that control the execution of a servlet. You can find a complete documentation of the deployment descriptor in Java Servlet Specification at http://java.sun.com/products/servlet/.

One often needed option is the session timeout. Different servlet containers use varying defaults for timeouts, such as 30 minutes for Apache Tomcat. You can set the timeout with:

<session-config>
    <session-timeout>30</session-timeout>
</session-config>

After the timeout expires, the close() method of the Application class will be called. You should implement it if you wish to handle timeout situations.