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:
http://host/jwig-user/subdir/class
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
http://host/jwig-user/demo/test.Hello*Test
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.
