MSenHostlet Class Reference

Defines the service constract URI for this hostlet.

Returns:

the URI identifier for the provided service, for example "urn:liberty:id-sis-pp:2003-08". Note that there might be multiple hostlets (local service providers) which all share common service type, that is, they all have same service contract URI.

Each Hostlet implementation may further describes its service via this callback.

Parameters:

aSD

is the description, where service specific attributes can be defined. Default, inline implementation sets the endpoint, contract and framework ID by calling the other, more simple callbacks.

Parameters:

aSD

is the service description into which this hostlet may further define other service specific information, like facets. Note that this call back is "stronger" than Endpoint() and Contract(), and thus any value specified in this method will be in effect for the hostlet connection.

Defines the service endpoint for this hostlet.

Returns:

endpoint that this hostlet has specified. If hostlet implementation does not wish to define any endpoint, but to use contract only, it should return KNullDesC8 (zero-length descriptor). In such case, CSenHostletConnection constructor will attempt to resolve secure identifier (UID3) of the application, and use that to generate a locally unique endpoint. If the UID3 is not available, then the constructor of CSenHostletConnection will leave with the following error code: KErrSenNoContractNoEndPoint

If endpoint is not specified, hostlet connection itself will generate an endpoint from applications secure ID (UID3) if such is available, and consumers can invoke the service via the provided contract ("service type" identifier).

Defines the framework for this hostlet.

Returns:

the framework ID. Default inline implementation returns RESTful service invocation framework ID, KDefaultRestServicesFrameworkID, as defined in SenServiceConnection.h

Hostlet connection calls this method several times, passing a different UID per each call.

If application wants to provide particular interface to hostlet connection (web services stack), it needs to return a pointer to such M-class as a return value of this method. For any interface, that application has not implemented, it is supposed to return NULL.

Parameters:

aUID

is the unique identifier of some interface

Returns:

value should be a valid (void) pointer to any interface implemented by the application. NULL signalizes that application does not provide interface for give UID.

This callback function is invoked each time when any hostlet connection's asynchronous RespondL is completed.

Method can be used to trigger the release of some response releated system resources, as it is invoked after the response has been delivered to the consumer (application may wish to close handles to reserved file or memory).

Parameters:

	aTxnId	identifies what transaction (service message) was completed
	aCompletionCode	indicates whether transaction completed ok (KErrNone) or not (error code).
	aDesc	may provide additional information about completed transaction, typically this description is provided, if an error has occured. It is optional for hostlet implementation to implement this method.

Main method for receiving incoming messages, which are typically SOAP / XML, and for providing service for these requests.

Parameters:

	aRequestUtf8	the request that needs to be be processed by the hostlet application (local service provider).
	aResponse	is where response data is to be set. CSenHostletConnection::ResponsdL should be called in order to send the response back to the requester (service consumer).