com.goldencode.p2j.util

Class MemoryBuffer

java.lang.Object

com.goldencode.p2j.util.MemoryBuffer

All Implemented Interfaces:

java.io.Externalizable, java.io.Serializable

public final class MemoryBuffer
extends java.lang.Object
implements java.io.Externalizable

Provides a byte buffer to be used from non-P2J code, when performing remote appserver calls. Instances of this class will be sent when the remote side expectes a memptr instance.

The remote side will be responsible of converting instances of this class to a memptr instance when it receives a MemoryBuffer instance and also to send back to the requester a MemoryBuffer instance, in case OUTPUT or INPUT-OUTPUT mode is used for the parameter.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private byte[]	value Stores the state of this instance as an array of bytes.

Constructor Summary

Constructors

Constructor and Description
MemoryBuffer() Default c'tor, needed for deserialization purposes; not for public use.
MemoryBuffer(byte[] value) Construct a new instance of this class, by saving a copy of the passed byte array.

Method Summary

Modifier and Type	Method and Description
private byte[]	getCopy(byte[] bytes) Create a copy of the given array of bytes.
byte[]	getValue() Get the array of bytes for this instance, as a copy.
void	readExternal(java.io.ObjectInput in) Initialize this instance by reading its state from the specified stream.
void	setValue(byte[] value) Change the array of bytes of this instance by saving a copy of the passed array.
void	writeExternal(java.io.ObjectOutput out) Write the state of this instance to the specified stream.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

value

private byte[] value

Stores the state of this instance as an array of bytes.

Constructor Detail

MemoryBuffer

public MemoryBuffer()

Default c'tor, needed for deserialization purposes; not for public use.

MemoryBuffer

public MemoryBuffer(byte[] value)

Construct a new instance of this class, by saving a copy of the passed byte array.

Any changes made to the passed array will not be reflected in this instance.

Parameters:

value - The array of bytes representing the state of this instance. May be null.

Method Detail

setValue

public void setValue(byte[] value)

Change the array of bytes of this instance by saving a copy of the passed array.

Any changes made to the passed array will not be reflected in this instance.

Parameters:

value - The array of bytes representing the new state of this instance. May be null.

getValue

public byte[] getValue()

Get the array of bytes for this instance, as a copy.

Any changes made to the returned array will not be reflected in this instance.

Returns:

See above.

writeExternal

public void writeExternal(java.io.ObjectOutput out)
                   throws java.io.IOException

Write the state of this instance to the specified stream.

Specified by:

writeExternal in interface java.io.Externalizable

Parameters:

out - The stream where the state of this instance will be sent.

Throws:

java.io.IOException

readExternal

public void readExternal(java.io.ObjectInput in)
                  throws java.io.IOException,
                         java.lang.ClassNotFoundException

Initialize this instance by reading its state from the specified stream.

Specified by:

readExternal in interface java.io.Externalizable

Parameters:

in - The stream from where the state of this instance will be read.

Throws:

java.io.IOException

java.lang.ClassNotFoundException

getCopy

private byte[] getCopy(byte[] bytes)

Create a copy of the given array of bytes.

Parameters:

bytes - The array of bytes for which a copy is needed. May be null.

Returns:

If the given byte array is null, return null. Else, return a copy of the array.