Websydian v6.1 online documentationOnline documentation - WebsydianExpress v3.5

ServiceHandler

Scoped name

Abstract.ServiceHandler

Purpose

The ServiceHandler is the function that is custom developed to handle the data for a specific type of request.

It is in your implementation of ServiceHandler functions you will code your own business logic to handle specific types of request.

The function is called by the service processor. This is done as a dynamic call. To keep this as simple as possible, all parameters are transferred using a memory store, the ServiceHandler contains code that reads this memory store, and populates local variables with the data.

The ServiceHandler does not have any assumptions of the type of data that are being handled.

Usage

This is the most abstract of the ServiceHandler functions. You should only inherit from this if you can't use one of the more specialized ServiceHandlers:

Examples

To investigate how you can implement a function based on this abstract function, you can look at the functions:

In WSYAPI:

Abstract.FileServiceHandler

In WSYAPIWS:

Abstract.XMLServiceHandler

Special considerations

Please note that all ServiceHandler functions are called dynamically based on the entries specified in the service structure tree. This means that you may not change the interface of the implemented function.

More information

Background: Handling web service requests

Background: Service handlers

Background: Memory Parameter APIs