<- Installation of the JWIG System Contents Constructing XHTML Documents ->

Compilation and Installation of JWIG Services

The jwig tool makes it easy to compile and install JWIG services. As an example, copy the Hello.jwig service shown below to a directory named test and follow the steps described below. This tool can also be used to update an installed service and to analyze a service to check for errors related to construction of XHTML and receiving of form input. See also the manual page (man jwig) for more documentation.

The Hello.jwig example program:

    package test;
    import dk.brics.jwig.runtime.*;

    public class Hello extends Service {
        public class Test extends Session {
            public void main() {
                exit [[ <html><head><title>JWIG</title></head><body>
                        <h1>Hello World!</h1>
                        </body></html> ]];

Compiling a Service

To compile a JWIG program, run

     jwig compile files

where files is the list of .jwig and .java files constituting the program source. This will translate the JWIG files into Java code and then compile all the Java code to class files. The command must be executed from the root of the directory structure containing the source files, and the source files must appear in subdirectories matching the package names. The CLASSPATH environment variable can be used to specify the classpath.

For the Hello.jwig example, run

     jwig compile test/Hello.jwig

This will generate the files test/Hello.class and test/Hello$Test.class.

Installing a Compiled Service

To install a compiled service, run

     jwig install dir files

where dir is a subdirectory of ~/jwig-bin and files is the list of class files and extra files used by the service. For each file in the list, the relative path is preserved in the installation. The path to each class file in the list must match the package name of the class. All jar files placed in the install directory are automatically included in the classpath when the service is started.

(The directory ~/jwig-bin is determined by the configuration of the Apache module. It can be changed in /etc/httpd/conf/bigwig.conf, assuming a typical JWIG install configuation.)

For the Hello.jwig example, run

     jwig install ~/jwig-bin/demo test/Hello.class test/Hello$Test.class

This will install the service in the service directory ~/jwig-bin/demo. The class files are placed in ~/jwig-bin/demo/test to match the package name.

Running an Installed Service

To run an installed service from a browser, open the following URL:


where host is your server host name, user is your user name, subdir is the directory where the service is installed relative to ~/jwig-bin, and class is the name of a class defining a service thread. The class name must be fully qualified with package name.

For the Hello.jwig example, view


Note that "." is used in the package name of the class, and that "*" is used instead of $ (because $ should not appear unescaped in URLs).

(The mapping from URLs to files on the file system is determined by the configuration of the Apache module mentioned above. Normally, the URL part /jwig-user/* is mapped to ~user/jwig-bin/* on the file system. More details of what is happening when services are running are described in the runtime system section.)

Uninstalling a Service

To uninstall a service, run

     jwig uninstall dir

where dir is the directory containing the installed service.

For the Hello.jwig example, run

      jwig uninstall ~/jwig-bin/demo

This will uninstall the service and remove ~/jwig-bin/demo entirely.

<- Installation of the JWIG System Contents Constructing XHTML Documents ->