Sun Java System Web Server 7.0 Update 3 NSAPI Developer's Guide

Required Behavior of SAFs for Each Directive

When writing a new SAF, you should define it to accomplish certain actions, depending on which stage of the request-handling process will invoke it. For example, SAFs to be invoked during the Init stage must conform to different requirements than SAFs to be invoked during the Service stage.

The rq parameter is the primary mechanism for passing along information throughout the request-response process. On input to a SAF, rq contains whatever values were inserted or modified by previously executed SAFs. On output, rq contains any modifications or additional information inserted by the SAF. Some SAFs depend on the existence of specific information provided at an earlier step in the process. For example, a PathCheck SAF retrieves values in rq->vars that were previously inserted by an AuthTrans SAF.

This section outlines the expected behavior of SAFs used at each stage in the request-handling process. The SAFs are described in the following sections:

For more detailed information about these SAFs, see the Sun Java System Web Server 7.0 Update 3 Administrator’s Configuration File Reference.

Init() SAFs

AuthTrans() SAFs

NameTrans() SAFs

PathCheck() SAFs

ObjectType() SAFs

Input() SAFs

Output() SAFs

Service() SAFs

Error() SAFs

AddLog() SAFs