Class COM.odi.jcpp.PeerPointer

java.lang.Object
   |
   +----COM.odi.jcpp.PeerPointer

public class PeerPointer
extends Object

PeerPointer is the superclass of peer pointer classes. ObjectStore uses peer pointer classes to wrap absolute addresses and associate them with a type. If you are not defining your own peer pointer classes, you need not be concerned with the constructor in this class.

PeerPointer(byte[]): Initializes PeerPointer instances with the linear address.

equals(PeerPointer): Indicates whether or not the specified peer pointer object contains the same linear address as this peer pointer object.
getLinearObjectReference(): Returns the linear address.

PeerPointer

  protected PeerPointer(byte linearObjectReference[])

Initializes PeerPointer instances with the linear address.

A linear address, also called a linear object reference, is a byte array that captures information about the type of an object and where it is located. ObjectStore determines the size of the array and where it is stored. An application can obtain a linear address by invoking the PeerPointer.getLinearObjectReference() method. You can use a linear address to construct a new peer pointer object of a different type.

Parameters:: linearObjectReference - Encoding of the address in its usual linear format.

getLinearObjectReference

  public byte[] getLinearObjectReference()

Returns the linear address. The Java interface to ObjectStore uses this representation to exchange object references between C++ and Java.

equals

  public boolean equals(PeerPointer p)

Indicates whether or not the specified peer pointer object contains the same linear address as this peer pointer object. equals() bases equality on the contents of the linear object reference.

Parameters:: p - Peer pointer object whose linear address you want to compare. This object must be nonnull.
Returns:: True if the linear addresses are the same. False if otherwise.