The restart function allows URL rewriting within the server without sending an HTTP redirect to the client. The restart function replaces the uri and query values in rq->reqpb with the URI and query string specified by the uri parameter and restarts the request by returning REQ_RESTART.
If the uri parameter contains a ? character, the value following ? is used as the query string. Otherwise, the restarted request will not have a query string. Because the new request URI will be passed through the AuthTrans and NameTrans stages again, avoid creating infinite loops.
The following table describes parameters for the restart function.
Table 7–115 restart Parameters
Parameter |
Description |
---|---|
(Optional) Wildcard pattern that specifies the path of requests that should be restarted. The default is to match all paths. |
|
URI and query string to use for the restarted request. |
|
bucket |
(Optional) Common to all obj.conf functions. Adds a bucket to monitor performance. For more information, see The bucket Parameter. |
The following obj.conf code causes the server to service requests for /index.html as though they were requests for /index.jsp:
NameTrans fn="restart" from="/index.html" uri="/index.jsp"