Applicable in Service-class directives.
The send-file function sends the contents of the requested file to the client. This function provides the Content-Type, Content-Length, and Last-Modified headers.
Most requests are handled by this function using the following directive (which usually comes last in the list of Service-class directives in the default object, so that it acts as a default):
Service method="(GET|HEAD|POST)" type="*~magnus-internal/*" fn="send-file"
This directive is invoked if the method of the request is GET, HEAD, or POST, and the type does not start with magnus-internal/. Note that the pattern *~ means “does not match.” For a list of characters that can be used in patterns, see the Sun Java System Web Server 6.1 SP6 NSAPI Programmer’s Guide.
The following table describes parameters for the send-file function.
Table 4–60 send-file Parameters
Parameter |
Description |
---|---|
(Optional) Prevents the server from caching responses to static file requests. For example, you can specify that files in a particular directory are not to be cached, which is useful for directories where the files change frequently. The value you assign to this parameter is ignored. If you do not wish to use this parameter, leave it out. |
|
(Optional) Common to all Service-class functions. |
|
(Optional) Common to all Service-class functions. |
|
(Optional) Common to all Service-class functions. |
|
(Optional) Common to all Service-class functions. |
|
(Optional) Common to all Service-class functions. |
|
(Optional) Common to all Service-class functions. |
|
(Optional) Common to all Service-class functions. |
|
bucket |
(Optional) Common to all obj.conf functions. |
Service type="*~magnus-internal/*" method="(GET|HEAD)" fn="send-file" |
In the following example, the server does not cache static files from /export/somedir/ when requested by the URL prefix /myurl.
<Object name=default> ... NameTrans fn="pfx2dir" from="/myurl" dir="/export/mydir", name="myname" ... Service method=(GET|HEAD|POST) type=*~magnus-internal/* fn=send-file ... </Object> <Object name="myname"> Service method=(GET|HEAD) type=*~magnus-internal/* fn=send-file nocache="" </Object>