com.highqsoft.avalon

Class Blob

java.lang.Object

org.omg.PortableServer.Servant

org.asam.ods.BlobPOA

com.highqsoft.avalon.Blob

All Implemented Interfaces:

AvalonDestroyable, java.io.Serializable, Blob, BlobOperations, org.omg.CORBA.Object, org.omg.CORBA.portable.IDLEntity, org.omg.CORBA.portable.InvokeHandler

public class Blob
extends BlobPOA
implements Blob, AvalonDestroyable

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected AoSession	aosObj
protected long	cObjPtr
protected static java.util.HashMap<java.lang.Long,org.omg.CORBA.Object>	refCache

Constructor Summary

Constructors

Constructor and Description
Blob()
Blob(long cObjPtr)

Method Summary

Methods

Modifier and Type	Method and Description
org.omg.CORBA.Request	_create_request(org.omg.CORBA.Context ctx, java.lang.String operation, org.omg.CORBA.NVList arg_list, org.omg.CORBA.NamedValue result)
org.omg.CORBA.Request	_create_request(org.omg.CORBA.Context ctx, java.lang.String operation, org.omg.CORBA.NVList arg_list, org.omg.CORBA.NamedValue result, org.omg.CORBA.ExceptionList exclist, org.omg.CORBA.ContextList ctxlist)
org.omg.CORBA.Object	_duplicate()
org.omg.CORBA.DomainManager[]	_get_domain_managers()
org.omg.CORBA.Policy	_get_policy(int policy_type)
int	_hash(int maximum)
boolean	_is_equivalent(org.omg.CORBA.Object other)
void	_release()
org.omg.CORBA.Request	_request(java.lang.String operation)
org.omg.CORBA.Object	_set_policy_override(org.omg.CORBA.Policy[] policies, org.omg.CORBA.SetOverrideType set_add)
void	append(byte[] value) Append a byte sequence to the binary large object.
boolean	compare(Blob aBlob) Compares the content of the binary large object.
void	destroy() Destroy the object on the server.
protected void	finalize()
byte[]	get(int offset, int length) Get a part of the binary large object.
java.lang.String	getHeader() Get the header of the binary large object.
static org.omg.CORBA.Object	getInstance(long cObjPtr, AoSession aosObj)
static org.omg.CORBA.Object	getInstance(long cObjPtr, int sessionId)
int	getLength() Get the length of the binary large object without loading it.
long	lastAccessTime() Returns the time stamp of the last access in milliseconds.
void	nativeAppend(byte[] value, AoSession aosObj)
byte[]	nativeGet(int offset, int length, AoSession aosObj)
java.lang.String	nativeGetHeader(AoSession aosObj)
int	nativeGetLength(AoSession aosObj)
void	nativeSet(byte[] value, AoSession aosObj)
void	nativeSetHeader(java.lang.String header, AoSession aosObj)
void	set(byte[] value) Clear the binary large object and set the new data.
void	setHeader(java.lang.String header) Set the header of a binary large object.
void	touch() Touches this instances reseting last access and reseting the session not-used flag.

Methods inherited from class org.asam.ods.BlobPOA

_all_interfaces, _invoke, _this, _this

Methods inherited from class org.omg.PortableServer.Servant

_default_POA, _get_delegate, _get_interface_def, _is_a, _non_existent, _object_id, _orb, _poa, _set_delegate, _this_object, _this_object

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.omg.CORBA.Object

_get_interface_def, _is_a, _non_existent

Field Detail

refCache

protected static java.util.HashMap<java.lang.Long,org.omg.CORBA.Object> refCache

cObjPtr

protected long cObjPtr

aosObj

protected AoSession aosObj

Constructor Detail

Blob

public Blob()

Blob

public Blob(long cObjPtr)

Method Detail

getInstance

public static org.omg.CORBA.Object getInstance(long cObjPtr,
                               int sessionId)

getInstance

public static org.omg.CORBA.Object getInstance(long cObjPtr,
                               AoSession aosObj)

append

public void append(byte[] value)
            throws AoException

Append a byte sequence to the binary large object. It is allowed to modify the object outside a transaction but it is recommended to activate a transaction.

Specified by:

append in interface BlobOperations

Parameters:

value - The byte sequence.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

nativeAppend

public void nativeAppend(byte[] value,
                AoSession aosObj)
                  throws AoException

Throws:

AoException

compare

public boolean compare(Blob aBlob)
                throws AoException

Compares the content of the binary large object. The headers are not compared.

Specified by:

compare in interface BlobOperations

Parameters:

aBlob - The blob to compare.

Returns:

A flag whether or not the compared blobs are equal.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

get

public byte[] get(int offset,
         int length)
           throws AoException

Get a part of the binary large object.

Specified by:

get in interface BlobOperations

Parameters:

offset - The starting position of the data in the blob.

length - The number of bytes requested from the blob.

Returns:

The request part of the blob data.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

nativeGet

public byte[] nativeGet(int offset,
               int length,
               AoSession aosObj)
                 throws AoException

Throws:

AoException

getHeader

public java.lang.String getHeader()
                           throws AoException

Get the header of the binary large object.

Specified by:

getHeader in interface BlobOperations

Returns:

The blob header.

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

nativeGetHeader

public java.lang.String nativeGetHeader(AoSession aosObj)
                                 throws AoException

Throws:

AoException

getLength

public int getLength()
              throws AoException

Get the length of the binary large object without loading it.

Specified by:

getLength in interface BlobOperations

Returns:

The blob length.

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

nativeGetLength

public int nativeGetLength(AoSession aosObj)
                    throws AoException

Throws:

AoException

set

public void set(byte[] value)
         throws AoException

Clear the binary large object and set the new data. It is allowed to modify the object outside a transaction but it is recommended to activate a transaction.

Specified by:

set in interface BlobOperations

Parameters:

value - The new blob data.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

nativeSet

public void nativeSet(byte[] value,
             AoSession aosObj)
               throws AoException

Throws:

AoException

setHeader

public void setHeader(java.lang.String header)
               throws AoException

Set the header of a binary large object. It is allowed to modify the object outside a transaction but it is recommended to activate a transaction.

Specified by:

setHeader in interface BlobOperations

Parameters:

header - The blob header.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

nativeSetHeader

public void nativeSetHeader(java.lang.String header,
                   AoSession aosObj)
                     throws AoException

Throws:

AoException

destroy

public void destroy()
             throws AoException

Destroy the object on the server. The destructor of the client so the server knows this object is not used anymore by the client. Access to this object after the destroy method will lead to an exception.

Specified by:

destroy in interface AvalonDestroyable

Specified by:

destroy in interface BlobOperations

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

finalize

protected void finalize()
                 throws java.lang.Throwable

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable

_create_request

public org.omg.CORBA.Request _create_request(org.omg.CORBA.Context ctx,
                                    java.lang.String operation,
                                    org.omg.CORBA.NVList arg_list,
                                    org.omg.CORBA.NamedValue result)

Specified by:

_create_request in interface org.omg.CORBA.Object

_create_request

public org.omg.CORBA.Request _create_request(org.omg.CORBA.Context ctx,
                                    java.lang.String operation,
                                    org.omg.CORBA.NVList arg_list,
                                    org.omg.CORBA.NamedValue result,
                                    org.omg.CORBA.ExceptionList exclist,
                                    org.omg.CORBA.ContextList ctxlist)

Specified by:

_create_request in interface org.omg.CORBA.Object

_duplicate

public org.omg.CORBA.Object _duplicate()

Specified by:

_duplicate in interface org.omg.CORBA.Object

_get_domain_managers

public org.omg.CORBA.DomainManager[] _get_domain_managers()

Specified by:

_get_domain_managers in interface org.omg.CORBA.Object

_get_policy

public org.omg.CORBA.Policy _get_policy(int policy_type)

Specified by:

_get_policy in interface org.omg.CORBA.Object

_hash

public int _hash(int maximum)

Specified by:

_hash in interface org.omg.CORBA.Object

_is_equivalent

public boolean _is_equivalent(org.omg.CORBA.Object other)

Specified by:

_is_equivalent in interface org.omg.CORBA.Object

_release

public void _release()

Specified by:

_release in interface org.omg.CORBA.Object

_request

public org.omg.CORBA.Request _request(java.lang.String operation)

Specified by:

_request in interface org.omg.CORBA.Object

_set_policy_override

public org.omg.CORBA.Object _set_policy_override(org.omg.CORBA.Policy[] policies,
                                        org.omg.CORBA.SetOverrideType set_add)

Specified by:

_set_policy_override in interface org.omg.CORBA.Object

lastAccessTime

public long lastAccessTime()

Description copied from interface: AvalonDestroyable

Returns the time stamp of the last access in milliseconds.

Specified by:

lastAccessTime in interface AvalonDestroyable

Returns:

the milliseconds representing the last access time.

touch

public void touch()
           throws AoException

Touches this instances reseting last access and reseting the session not-used flag.

Specified by:

touch in interface AvalonDestroyable

Throws:

AoException