Class OncRpcReplyMessage
- Direct Known Subclasses:
OncRpcClientReplyMessage
,OncRpcServerReplyMessage
OncRpcReplyMessage
class represents an ONC/RPC reply
message as defined by ONC/RPC in RFC 1831. Such messages are sent back by
ONC/RPC to servers to clients and contain (in case of real success) the
result of a remote procedure call.
The decision to define only one single class for the accepted and rejected replies was driven by the motivation not to use polymorphism and thus have to upcast and downcast references all the time.
The derived classes are only provided for convinience on the server side.
- Version:
- $Revision: 1.2 $ $Date: 2003/08/14 07:56:59 $ $State: Exp $ $Locker: $
- Author:
- Harald Albrecht
-
Field Summary
FieldsModifier and TypeFieldDescriptionint
Acceptance status in case this reply was sent in response to an accepted call (OncRpcReplyStatus.ONCRPC_MSG_ACCEPTED
).int
Contains the reason for authentification failure in the case ofOncRpcRejectStatus.ONCRPC_AUTH_ERROR
.int
Highest supported version in case ofOncRpcRejectStatus.ONCRPC_RPC_MISMATCH
andOncRpcAcceptStatus.ONCRPC_PROG_MISMATCH
.int
Lowest supported version in case ofOncRpcRejectStatus.ONCRPC_RPC_MISMATCH
andOncRpcAcceptStatus.ONCRPC_PROG_MISMATCH
.int
Rejectance status in case this reply sent in response to a rejected call (OncRpcReplyStatus.ONCRPC_MSG_DENIED
).int
The reply status of the reply message.static final int
Dummy, which can be used to identify unused parameters when constructingOncRpcReplyMessage
objects.Fields inherited from class org.acplt.oncrpc.OncRpcMessage
messageId, messageType
-
Constructor Summary
ConstructorsConstructorDescriptionInitializes a newOncRpcReplyMessage
object to represent an invalid state.OncRpcReplyMessage
(OncRpcCallMessage call, int replyStatus, int acceptStatus, int rejectStatus, int lowVersion, int highVersion, int authStatus) Initializes a newOncRpcReplyMessage
object and initializes its complete state from the given parameters. -
Method Summary
-
Field Details
-
replyStatus
public int replyStatusThe reply status of the reply message. This can be eitherOncRpcReplyStatus.ONCRPC_MSG_ACCEPTED
orOncRpcReplyStatus.ONCRPC_MSG_DENIED
. Depending on the value of this field, other fields of an instance ofOncRpcReplyMessage
become important.The decision to define only one single class for the accepted and rejected replies was driven by the motivation not to use polymorphism and thus have to upcast and downcast references all the time.
-
acceptStatus
public int acceptStatusAcceptance status in case this reply was sent in response to an accepted call (OncRpcReplyStatus.ONCRPC_MSG_ACCEPTED
). This field can take any of the values defined in theOncRpcAcceptStatus
interface.Note that even for accepted calls that only in the case of
OncRpcAcceptStatus.ONCRPC_SUCCESS
result data will follow the reply message header. -
rejectStatus
public int rejectStatusRejectance status in case this reply sent in response to a rejected call (OncRpcReplyStatus.ONCRPC_MSG_DENIED
). This field can take any of the values defined in theOncRpcRejectStatus
interface. -
lowVersion
public int lowVersionLowest supported version in case ofOncRpcRejectStatus.ONCRPC_RPC_MISMATCH
andOncRpcAcceptStatus.ONCRPC_PROG_MISMATCH
. -
highVersion
public int highVersionHighest supported version in case ofOncRpcRejectStatus.ONCRPC_RPC_MISMATCH
andOncRpcAcceptStatus.ONCRPC_PROG_MISMATCH
. -
authStatus
public int authStatusContains the reason for authentification failure in the case ofOncRpcRejectStatus.ONCRPC_AUTH_ERROR
. -
UNUSED_PARAMETER
public static final int UNUSED_PARAMETERDummy, which can be used to identify unused parameters when constructingOncRpcReplyMessage
objects.- See Also:
-
-
Constructor Details
-
OncRpcReplyMessage
public OncRpcReplyMessage()Initializes a newOncRpcReplyMessage
object to represent an invalid state. This default constructor should only be used if in the next step the real state of the reply message is immediately decoded from a XDR stream. -
OncRpcReplyMessage
public OncRpcReplyMessage(OncRpcCallMessage call, int replyStatus, int acceptStatus, int rejectStatus, int lowVersion, int highVersion, int authStatus) Initializes a newOncRpcReplyMessage
object and initializes its complete state from the given parameters.Note that depending on the reply, acceptance and rejectance status some parameters are unused and can be specified as
UNUSED_PARAMETER
.- Parameters:
call
- The ONC/RPC call this reply message corresponds to.replyStatus
- The reply status (seeOncRpcReplyStatus
).acceptStatus
- The acceptance state (seeOncRpcAcceptStatus
).rejectStatus
- The rejectance state (seeOncRpcRejectStatus
).lowVersion
- lowest supported version.highVersion
- highest supported version.authStatus
- The autentication state (seeOncRpcAuthStatus
).
-