org.asam.ods

Class _BlobStub

java.lang.Object

org.omg.CORBA.portable.ObjectImpl

org.asam.ods._BlobStub

All Implemented Interfaces:

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

public class _BlobStub
extends org.omg.CORBA.portable.ObjectImpl
implements Blob

The ASAM ODS blob interface.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
_BlobStub()

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String[]	_ids()
void	append(byte[] value) (12001) Append a byte sequence to the binary large object.
boolean	compare(Blob aBlob) (12002) Compares the content of the binary large object.
void	destroy() (12008) Destroy the object on the server.
byte[]	get(int offset, int length) (12003) Get a part of the binary large object.
java.lang.String	getHeader() (12004) Get the header of the binary large object.
int	getLength() (12005) Get the length of the binary large object without loading it.
void	set(byte[] value) (12006) Clear the binary large object and set the new data.
void	setHeader(java.lang.String header) (12007) Set the header of a binary large object.

Methods inherited from class org.omg.CORBA.portable.ObjectImpl

_create_request, _create_request, _duplicate, _get_delegate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _invoke, _is_a, _is_equivalent, _is_local, _non_existent, _orb, _release, _releaseReply, _request, _request, _servant_postinvoke, _servant_preinvoke, _set_delegate, _set_policy_override, equals, hashCode, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.omg.CORBA.Object

_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _is_a, _is_equivalent, _non_existent, _release, _request, _set_policy_override

Constructor Detail

_BlobStub

public _BlobStub()

Method Detail

append

public void append(byte[] value)
            throws AoException

(12001) Append a byte sequence to the binary large object. It is allowed to modify the binary large 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

compare

public boolean compare(Blob aBlob)
                throws AoException

(12002) 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

(12003) 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 requested 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

getHeader

public java.lang.String getHeader()
                           throws AoException

(12004) 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

getLength

public int getLength()
              throws AoException

(12005) 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

set

public void set(byte[] value)
         throws AoException

(12006) Clear the binary large object and set the new data. It is allowed to modify the binary large 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

setHeader

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

(12007) Set the header of a binary large object. It is allowed to modify the binary large 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

destroy

public void destroy()
             throws AoException

(12008) Destroy the object on the server. This method is used to tell the server that the blob object is not used any more by the client. Access to this object after the invokation of the destroy method will lead to an exception.

Specified by:

destroy in interface BlobOperations

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

_ids

public java.lang.String[] _ids()

Specified by:

_ids in class org.omg.CORBA.portable.ObjectImpl