HTTP Configuration File

This appendix describes options that you can set in a file used to configure the JWAVE HTTP Web server. The HTTP Web server is active if the property MANAGER_START_HTTP is set to TRUE in the JWAVE Configuration Tool, as described in

Using the JWAVE Configuration Tool

By default, the location of this configuration file is:

VNI_DIR/jwave-3_0/bin/jwave_http.cfg

where VNI_DIR is the main Visual Numerics installation directory.

To change the default location of the jwave_http.cfg file, edit the property HTTP_CONFIG in the JWAVE Configuration Tool.

NOTE: On Windows platforms, you must use two back slashes (\\) as a directory separator, rather than the normal single back slash (\). For example:

C:\\Program Files\\MyDocs

You must stop and restart the JWAVE Manager to make any changes you make to this file take effect. For example:

manager shutdown 
manager start

Or, if you are using the JWAVE Windows NT Service:

net stop jwaveservice 
net start jwaveservice

General Parameters

homeDir

The default directory to serve for the URL of "/".

Default: VNI_DIR/classes

Example: homeDir = c:\\program files\\myWebHome

indexFile The default file to serve for a URL that maps to a directory.

Default: index.html

Example: indexFile = index.html

JWaveURL The URL that serves a JWAVE connection. Set the HTTP connection method to use this URL (for example: http://myhost:8080/JWave). Should start with a slash (/).

Default: /JWave

Example: JWaveURL = /JWave

MimeDefault The default mime type to use for unknown file types.

Default: application/octet-stream

Example: MimeDefault = application/octet-stream

Directory Mapping

To map a URL to a directory (so that when you point your browser to a URL, the server knows the directory in which to find files).

Syntax:

dir.url = full-path-to-directory

Replace url with the top-level URL you wish to map (no slashes are allowed)

Replace full-path-to-directory with the full path to the directory that should map to that URL

For example, if you want the URL http://myhost/someplace/file.html to map to the server's file C:\Program Files\MyDocs\file.html, then use:

dir.someplace = C:\\Program Files\\MyDocs

Default:

dir.classes = VNI_DIR/classes

where VNI_DIR is the JWAVE installation directory.

Mime Types Mapping

To map a file extension (file.ext) to a Mime type.

Syntax:

mime.ext = mime-type

Replace ext with the file extension (whatever follows the last period in the file).
Replace mime-type with the Mime type to use when serving files with the given extension.

For example, to serve a file foo.html as Mime type text/html, use:

mime.html = text/html

The defaults are:

mime.html = text/html
mime.htm = text/html
mime.jpeg = image/jpeg
mime.jpg = image/jpeg
mime.gif = image/gif
mime.png = image/png
mime.txt = text/plain
mime.class = application/octet-stream
mime.jar = application/octet-stream
mime.properties = text/plain