org.omg.CORBA

Class Any

Implemented Interfaces:
IDLEntity, Serializable
Known Direct Subclasses:
gnuAny

public abstract class Any
extends Object
implements Serializable, IDLEntity

A container that can store a value of either user defined or primitive IDL type.
See Also:
Serialized Form

Method Summary

abstract InputStream
create_input_stream()
Creates an input stream from that this Any object's value can be read (unmarshalled).
abstract OutputStream
create_output_stream()
Creates an output stream into which this Any object's value can be written (marshalled).
abstract boolean
equal(Any other)
Compare this Any with another Any.
abstract Object
extract_Object()
Extract the CORBA Object from this Any
Principal
extract_Principal()
Deprecated. by CORBA 2.2.
Streamable
extract_Streamable()
Extract an arbitrary Streamable from this Any.
abstract TypeCode
extract_TypeCode()
Extract the TypeCode from this Any value field.
abstract Serializable
extract_Value()
Extract the CORBA Value from this Any
abstract Any
extract_any()
Extract another Any from this Any.
abstract boolean
extract_boolean()
Extract the CORBA boolean from this Any.
abstract char
extract_char()
Extract the CORBA char from this Any.
abstract double
extract_double()
Extract the CORBA double from this Any.
BigDecimal
extract_fixed()
Extract the CORBA fixed from this Any.
abstract float
extract_float()
Extract the CORBA float from this Any.
abstract int
extract_long()
Extract the CORBA long from this Any.
abstract long
extract_longlong()
Extract the CORBA long long from this Any.
abstract byte
extract_octet()
Extract the CORBA octet from this Any.
abstract short
extract_short()
Extract the CORBA short from this Any.
abstract String
extract_string()
Extract the CORBA string from this Any.
abstract int
extract_ulong()
Extract the CORBA unsigned long from this Any
abstract long
extract_ulonglong()
Extract the CORBA unsigned long long from this Any.
abstract short
extract_ushort()
Extract the CORBA unsigned short from this Any
abstract char
extract_wchar()
Extract the CORBA wchar from this Any
abstract String
extract_wstring()
Extract the CORBA wstring from this Any
abstract void
insert_Object(Object x)
Insert the CORBA Object into this Any
abstract void
insert_Object(Object x, TypeCode typecode)
Insert the CORBA Object into this Any
void
insert_Principal(Principal x)
Deprecated. by CORBA 2.2.
void
insert_Streamable(Streamable x)
Insert the CORBA Streamable into this Any
abstract void
insert_TypeCode(TypeCode typecode)
Insert the CORBA TypeCode into this Any value field.
abstract void
insert_Value(Serializable x)
Insert the CORBA Value into this Any.
abstract void
insert_Value(Serializable x, TypeCode typecode)
Insert the CORBA Value into this Any.
abstract void
insert_any(Any x)
Insert the CORBA any into this Any
abstract void
insert_boolean(boolean x)
Insert the CORBA boolean into this Any
abstract void
insert_char(char x)
Insert the CORBA char into this Any
abstract void
insert_double(double x)
Insert the CORBA double into this Any
void
insert_fixed(BigDecimal x)
Insert the CORBA fixed into this Any
void
insert_fixed(BigDecimal x, TypeCode typecode)
Insert the CORBA fixed into this Any
abstract void
insert_float(float x)
Insert the CORBA float into this Any
abstract void
insert_long(int x)
Insert the CORBA long into this Any
abstract void
insert_longlong(long x)
Insert the CORBA longlong into this Any
abstract void
insert_octet(byte x)
Insert the CORBA octet into this Any
abstract void
insert_short(short x)
Insert the CORBA short into this Any
abstract void
insert_string(String x)
Insert the CORBA string into this Any
abstract void
insert_ulong(int x)
Insert the CORBA ulong into this Any
abstract void
insert_ulonglong(long x)
Insert the CORBA ulonglong into this Any
abstract void
insert_ushort(short x)
Insert the CORBA ushort into this Any
abstract void
insert_wchar(char x)
Insert the CORBA wchar into this Any
abstract void
insert_wstring(String x)
Insert the CORBA wstring into this Any
abstract void
read_value(InputStream input, TypeCode type)
Read the value into this Any from the given input stream.
abstract TypeCode
type()
Returns the TypeCode of the object, stored in this Any
abstract void
type(TypeCode valueTypeCode)
Set the type of the object, stored in this Any, to the given TypeCode.
abstract void
write_value(OutputStream output)
Writes out the value (without the typecode of the value), stored in this Any.

Methods inherited from class java.lang.Object

clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

create_input_stream

public abstract InputStream create_input_stream()
Creates an input stream from that this Any object's value can be read (unmarshalled).

create_output_stream

public abstract OutputStream create_output_stream()
Creates an output stream into which this Any object's value can be written (marshalled).
Returns:
the newly created output stream.

equal

public abstract boolean equal(Any other)
Compare this Any with another Any.
Parameters:
other - the other instance to compare with.
Returns:
true if both values and value typecodes are equal, false otherwise.

extract_Object

public abstract Object extract_Object()
            throws BAD_OPERATION
Extract the CORBA Object from this Any
Throws:
BAD_OPERATION - if this instance contains value other than Object or the value has not been set.

extract_Principal

public Principal extract_Principal()

Deprecated. by CORBA 2.2.

Extract the CORBA Principal from this Any

extract_Streamable

public Streamable extract_Streamable()
            throws BAD_INV_ORDER
Extract an arbitrary Streamable from this Any.
Throws:
BAD_INV_ORDER - if the caller has invoked operations in the wrong order.

extract_TypeCode

public abstract TypeCode extract_TypeCode()
            throws BAD_OPERATION
Extract the TypeCode from this Any value field.
Throws:
BAD_OPERATION - if this instance contains value other than TypeCode or the value has not been set.

extract_Value

public abstract Serializable extract_Value()
            throws BAD_OPERATION
Extract the CORBA Value from this Any
Throws:
BAD_OPERATION - if this instance contains value other than Value or the value has not been set.

extract_any

public abstract Any extract_any()
            throws BAD_OPERATION
Extract another Any from this Any.
Throws:
BAD_OPERATION - if this instance contains value other than any or the value has not been set.

extract_boolean

public abstract boolean extract_boolean()
            throws BAD_OPERATION
Extract the CORBA boolean from this Any.
Throws:
BAD_OPERATION - if this instance contains value other than boolean or the value has not been set.

extract_char

public abstract char extract_char()
            throws BAD_OPERATION
Extract the CORBA char from this Any.
Throws:
BAD_OPERATION - if this instance contains value other than char or the value has not been set.

extract_double

public abstract double extract_double()
            throws BAD_OPERATION
Extract the CORBA double from this Any.
Throws:
BAD_OPERATION - if this instance contains value other than double or the value has not been set.

extract_fixed

public BigDecimal extract_fixed()
            throws BAD_OPERATION
Extract the CORBA fixed from this Any.
Throws:
BAD_OPERATION - if this instance contains value other than fixed or the value has not been set.

extract_float

public abstract float extract_float()
            throws BAD_OPERATION
Extract the CORBA float from this Any.
Throws:
BAD_OPERATION - if this instance contains value other than float or the value has not been set.

extract_long

public abstract int extract_long()
            throws BAD_OPERATION
Extract the CORBA long from this Any.
Throws:
BAD_OPERATION - if this instance contains value other than long or the value has not been set.

extract_longlong

public abstract long extract_longlong()
            throws BAD_OPERATION
Extract the CORBA long long from this Any.
Throws:
BAD_OPERATION - if this instance contains value other than longlong or the value has not been set.

extract_octet

public abstract byte extract_octet()
            throws BAD_OPERATION
Extract the CORBA octet from this Any.
Throws:
BAD_OPERATION - if this instance contains value other than octet or the value has not been set.

extract_short

public abstract short extract_short()
            throws BAD_OPERATION
Extract the CORBA short from this Any.
Throws:
BAD_OPERATION - if this instance contains value other than short or the value has not been set.

extract_string

public abstract String extract_string()
            throws BAD_OPERATION
Extract the CORBA string from this Any.
Throws:
BAD_OPERATION - if this instance contains value other than string or the value has not been set.

extract_ulong

public abstract int extract_ulong()
            throws BAD_OPERATION
Extract the CORBA unsigned long from this Any
Throws:
BAD_OPERATION - if this instance contains value other than unsigned long or the value has not been set.

extract_ulonglong

public abstract long extract_ulonglong()
            throws BAD_OPERATION
Extract the CORBA unsigned long long from this Any.
Throws:
BAD_OPERATION - if this instance contains value other than unsigned long long or the value has not been set.

extract_ushort

public abstract short extract_ushort()
            throws BAD_OPERATION
Extract the CORBA unsigned short from this Any
Throws:
BAD_OPERATION - if this instance contains value other than unsigned short or the value has not been set.

extract_wchar

public abstract char extract_wchar()
            throws BAD_OPERATION
Extract the CORBA wchar from this Any
Throws:
BAD_OPERATION - if this instance contains value other than wchar or the value has not been set.

extract_wstring

public abstract String extract_wstring()
            throws BAD_OPERATION
Extract the CORBA wstring from this Any
Throws:
BAD_OPERATION - if this instance contains value other than wstring or the value has not been set.

insert_Object

public abstract void insert_Object(Object x)
Insert the CORBA Object into this Any

insert_Object

public abstract void insert_Object(Object x,
                                   TypeCode typecode)
Insert the CORBA Object into this Any

insert_Principal

public void insert_Principal(Principal x)

Deprecated. by CORBA 2.2.

Insert the CORBA Principal into this Any.

insert_Streamable

public void insert_Streamable(Streamable x)
Insert the CORBA Streamable into this Any

insert_TypeCode

public abstract void insert_TypeCode(TypeCode typecode)
Insert the CORBA TypeCode into this Any value field.

insert_Value

public abstract void insert_Value(Serializable x)
Insert the CORBA Value into this Any. The type of the Any should be set (by type(TypeCode)) before inserting the value.

insert_Value

public abstract void insert_Value(Serializable x,
                                  TypeCode typecode)
Insert the CORBA Value into this Any. The type of the Any should be set (by type(TypeCode)) before inserting the value.

insert_any

public abstract void insert_any(Any x)
Insert the CORBA any into this Any

insert_boolean

public abstract void insert_boolean(boolean x)
Insert the CORBA boolean into this Any

insert_char

public abstract void insert_char(char x)
Insert the CORBA char into this Any

insert_double

public abstract void insert_double(double x)
Insert the CORBA double into this Any

insert_fixed

public void insert_fixed(BigDecimal x)
Insert the CORBA fixed into this Any

insert_fixed

public void insert_fixed(BigDecimal x,
                         TypeCode typecode)
Insert the CORBA fixed into this Any

insert_float

public abstract void insert_float(float x)
Insert the CORBA float into this Any

insert_long

public abstract void insert_long(int x)
Insert the CORBA long into this Any

insert_longlong

public abstract void insert_longlong(long x)
Insert the CORBA longlong into this Any

insert_octet

public abstract void insert_octet(byte x)
Insert the CORBA octet into this Any

insert_short

public abstract void insert_short(short x)
Insert the CORBA short into this Any

insert_string

public abstract void insert_string(String x)
Insert the CORBA string into this Any

insert_ulong

public abstract void insert_ulong(int x)
Insert the CORBA ulong into this Any

insert_ulonglong

public abstract void insert_ulonglong(long x)
Insert the CORBA ulonglong into this Any

insert_ushort

public abstract void insert_ushort(short x)
Insert the CORBA ushort into this Any

insert_wchar

public abstract void insert_wchar(char x)
Insert the CORBA wchar into this Any

insert_wstring

public abstract void insert_wstring(String x)
Insert the CORBA wstring into this Any

read_value

public abstract void read_value(InputStream input,
                                TypeCode type)
            throws MARSHAL
Read the value into this Any from the given input stream.
Parameters:
input - a CORBA stream to read from.
type - a TypeCode of the object being read.
Throws:
MARSHAL - if the given TypeCode does not match the TypeCode of the object, found in the stream.

type

public abstract TypeCode type()
Returns the TypeCode of the object, stored in this Any
Returns:
the TypeCode

type

public abstract void type(TypeCode valueTypeCode)
Set the type of the object, stored in this Any, to the given TypeCode. Clear the value.
Parameters:
valueTypeCode - the type of the object that is expected to be stored in this any.

write_value

public abstract void write_value(OutputStream output)
Writes out the value (without the typecode of the value), stored in this Any.
Parameters:
output - the CORBA stream to write into.
Throws:
NullPointerException - if the value of this Any has not been set.

Any.java -- Copyright (C) 2005 Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.