Class XdrDynamicOpaque

java.lang.Object
org.acplt.oncrpc.XdrDynamicOpaque
All Implemented Interfaces:
XdrAble

public class XdrDynamicOpaque extends Object implements XdrAble
Instances of the class XdrDynamicOpaque represent (de-)serializeable dynamic-size opaque values, which are especially useful in cases where a result with only a single opaque value is expected from a remote function call or only a single opaque value parameter needs to be supplied.

Please note that this class is somewhat modelled after Java's primitive data type wrappers. As for these classes, the XDR data type wrapper classes follow the concept of values with no identity, so you are not allowed to change the value after you've created a value object.

Version:
$Revision: 1.1.1.1 $ $Date: 2003/08/13 12:03:44 $ $State: Exp $ $Locker: $
Author:
Harald Albrecht
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    private byte[]
    The encapsulated opaque value itself.
  • Constructor Summary

    Constructors
    Constructor
    Description
    Constructs and initializes a new XdrDynamicOpaque object.
    XdrDynamicOpaque(byte[] value)
    Constructs and initializes a new XdrDynamicOpaque object.
  • Method Summary

    Modifier and Type
    Method
    Description
    byte[]
    Returns the value of this XdrDynamicOpaque object as a byte vector.
    void
    Decodes -- that is: deserializes -- a XDR opaque from a XDR stream in compliance to RFC 1832.
    void
    Encodes -- that is: serializes -- a XDR opaque into a XDR stream in compliance to RFC 1832.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Field Details

    • value

      private byte[] value
      The encapsulated opaque value itself.
  • Constructor Details

    • XdrDynamicOpaque

      public XdrDynamicOpaque()
      Constructs and initializes a new XdrDynamicOpaque object.
    • XdrDynamicOpaque

      public XdrDynamicOpaque(byte[] value)
      Constructs and initializes a new XdrDynamicOpaque object.
  • Method Details

    • dynamicOpaqueValue

      public byte[] dynamicOpaqueValue()
      Returns the value of this XdrDynamicOpaque object as a byte vector.
      Returns:
      The primitive byte[] value of this object.
    • xdrEncode

      public void xdrEncode(XdrEncodingStream xdr) throws OncRpcException, IOException
      Encodes -- that is: serializes -- a XDR opaque into a XDR stream in compliance to RFC 1832.
      Specified by:
      xdrEncode in interface XdrAble
      Parameters:
      xdr - XDR stream to which information is sent for encoding.
      Throws:
      OncRpcException - if an ONC/RPC error occurs.
      IOException - if an I/O error occurs.
    • xdrDecode

      public void xdrDecode(XdrDecodingStream xdr) throws OncRpcException, IOException
      Decodes -- that is: deserializes -- a XDR opaque from a XDR stream in compliance to RFC 1832.
      Specified by:
      xdrDecode in interface XdrAble
      Parameters:
      xdr - XDR stream from which decoded information is retrieved.
      Throws:
      OncRpcException - if an ONC/RPC error occurs.
      IOException - if an I/O error occurs.