wsb.request-type

function

Library: Web Services Broker (OMWSB)
Import : omwsb.xmd

Returns: a string containing the lowercased service type being requested


Declaration
export external stream function request-type 
  of                       value request request

Argument definitions

request
The wsb.request OMX variable that was returned from a call to wsb.wait-for-request


Purpose

The wsb.request-type function is used in either the server or service program to retrieve the type of service being requested. The request's type is the first HTTP header field that matches a service type added via add-service. This function would typically be used by the server program to determine whether to add a mapping for the unknown request, handle the unknown request itself, or write an error to the client. It may also be used in a service program which is designed to provide more than one type of service.

If the request is not for a recognized service type, then an exception will be thrown. The criteria for whether or not the request will be recognized are outlined in the wsb.has-known-request-type function. That function can thus be used to determine whether or not it's safe to call wsb.request-type.