oracle.svcmsg

Interface Request

All Superinterfaces:

java.io.Serializable

All Known Subinterfaces:

RequestParams

All Known Implementing Classes:

SvcMethodRequest, SvcMsgRequest, SvcMsgRequestParams, SvcMsgResponseRef

public interface Request
extends java.io.Serializable

This interface is used to marshal a service message request between client and middle tier. Request operation ids 0x0001 - 0x00ff -- are reserved by BC4J

Method Summary

Modifier and Type	Method and Description
java.lang.String	getName() Returns the name that identifies this request.
int	getOperation() Returns the id that identifies this request.
java.lang.Object	getSourceId() Returns the object that identifies the object that originated this request.

Method Detail

getOperation

int getOperation()

Returns the id that identifies this request. A request may be identified by its operation id (int) or by a name (String).

In general, an int operation id is more performant because one can use a switch/case construct. A String request name will require string compare which can be more costly. However, string request name is good for custom request processing where a static int operation id cannot be formulated.

Returns:

the request operation id.

getName

java.lang.String getName()

Returns the name that identifies this request. A request may be identified by its operation id (int) or by a name (String).

In general, an int operation id is more performant because one can use a switch/case construct. A String request name will require string compare which can be more costly. However, string request name is good for custom request processing where a static int operation id cannot be formulated.

Returns:

the request operation name.

getSourceId

java.lang.Object getSourceId()

Returns the object that identifies the object that originated this request. This id should be serializable and marshallable across tiers.

Returns:

the id object of the object that originated this request.