Service Examples

• Assume that the PathCheck directives all succeed.

• The following ObjectType directive tells the server to look up the resource’s MIME type in the MIME types table:

  ObjectType fn="type-by-extension"

• The server finds the following entry in the MIME types table, which sets the type attribute to text/html:

  type=text/html exts=htm,html

• The server invokes the following Service directive. The value of the type parameter matches anything that does not begin with magnus-internal/. This directive sends the requested file, jos.html, to the client.

Service method="(GET|HEAD|POST)" fn="send-file""

            

The following example uses another object:

• The NameTrans directive assigns the name personnel to the request.

NameTrans fn=assign-name name=personnel from=/personnel

            

• As a result of the name assignment, the server switches to processing the directives in the object named personnel. This object is defined as:

<Object name="personnel">
 Service fn="index-simple"
 </Object>

            

• The personnel object has no PathCheck or ObjectType directives, so the server processes the PathCheck and ObjectType directives in the default object. Assume that all PathCheck and ObjectType directives succeed.

• When processing Service directives, the server starts by considering the Service directive in the personnel object, which is:

  Service fn="index-simple"

• The server executes this Service directive, which calls the index-simple function.

  Since a Service directive has now been executed, the server does not process any other Service directives. However, if the matching object had not had a Service directive that was executed, the server would continue looking at Service directives in the default object.