URL Substitution

URL substitution (in combination with host substitution) makes it possible to fully change the URL that a wireless handheld requests without reconfiguring the handheld.

If a wireless handheld is configured to initially send all of its HTTP requests to localhost/home, where localhost is Good Intranet Server, the server can be configured to forward the request to a new location - differenthost/differenthome.

For example, with URL substitution, you can set Good Intranet Server to map the path in a URL that follows the host name to a different (substitute) path that you also specify.

urlsubst.enable  true
urlsubst.sub   localhost/intro.html localhost/demo/docdemo.html

The first line in the example enables URL substitution. The second line specifies that requests to localhost/intro.html are to be redirected to localhost/demo/docdemo.html.

Important: URL substitution is applied before host-name substitution. Therefore, to map the URL http://localhost/intro.html to http://www.gadocs.com/demo/docdemo.html, you need to keep localhost as the host name in URL substitution, as shown in the example above, and configure host-name substitution to map localhost to www.gadocs.com, as described in Host Substitution

You can specify multiple path substitutions by entering pairs of URLs as a space-separated list. For example:

urlsubst.sub localhost/intro.html localhost/demo/docdemo.html \
www.abcdef.com/pubs.html www.abcdef.com/engineering/techdocs.html

In this example, localhost/intro.html is mapped to localhost/demo/docdemo.html and www.abcdef.com/pubs.html is mapped to www.abcdef.com/engineering/techdocs.html.

Properties for URL substitution include:

Property Name	Default	Description
urlsubst.enable	false	If set to true, enables URL substitution.
urlsubst.sub	http://www.Good Intranet.com/testhomedeck.wml http://www.Good Intranet.com/homedeck.wml	The URL substitution that you want to be carried out, specified as: hostname/path  hostname/subsitute_path For example, to redirect requests sent to www.gatenga.com/home/news to www.gatega.com/new_home/info, you would enter:
www.gatega.com/home/news www.gatega.com/new_home/info
		Important: the host name must be the same in both URLs; only the path following the name can be replaced. To change the host name in a URL, you need to use host substitution.
urlsubst.log.enable	false	If set to true, enables logging of URL substitution events.