The forwarding of requests from the web server to tomcat gets configured by defining mapping rules. Such a rule maps requests to workers. The request part of the map is described by a URI pattern, the worker by it's worker name.
The so-called uriworkermap file is a mechanism of defining rules, which works for all web servers. There exist also other web server specific configuration options for defining rules, which will be mostly discussed on the reference pages for configuring tomcat connectors for the individual web servers.
The name of the file is usually uriworkermap.properties, although this is configurable in the web server. Please consult the web server specific documentation pages on how to enable the uriworkermap file.
The main features supported by the uriworkermap file are
- Support for comments in the rule file.
- Exact and wildchar matches, shortcuts to map a directory and all including content.
- Exclusion rules, disabling of rules and rule priorities.
- Rule extensions, modifying worker behaviour per rule.
- Virtual host integration: uri mapping rules can be expressed per virtual host. The details are web server specific though.
- Dynamic reloading: The file gets checked periodically for changes. New versions are automatically reloaded without web server restarts.
- Integration with the status worker.