org.omg.DynamicAny
Class DynAnyHelper

java.lang.Object
  org.omg.DynamicAny.DynAnyHelper

public abstract class DynAnyHelper
extends Object

The helper operations for DynAny. Following the 1.5 JDK specifications, DynAny is always a local object, so the two methods of this helper (read(org.omg.CORBA.portable.InputStream) and write(org.omg.CORBA.portable.OutputStream, org.omg.DynamicAny.DynAny) are not in use, always throwing MARSHAL.

Specnote:

always throwing MARSHAL in read and write ensures compatibility with other popular implementations like Sun's.

Constructor Summary

DynAnyHelper()

Method Summary

static DynAny	extract(Any any) Extract the DynAny from given Any.
static String	id() Get the DynAny repository id.
static void	insert(Any any, DynAny that) Insert the DynAny into the given Any.
static DynAny	narrow(Object obj) Cast the passed object into the DynAny.
static DynAny	read(InputStream input) This should read DynAny from the CDR input stream, but (following the JDK 1.5 API) it does not.
static TypeCode	type() Get the type code of the DynAny.
static DynAny	unchecked_narrow(Object obj) Narrow the given object to the DynAny.
static void	write(OutputStream output, DynAny value) This should read DynAny from the CDR input stream, but (following the JDK 1.5 API) it does not.

Methods inherited from class java.lang.Object

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

Constructor Detail

DynAnyHelper

public DynAnyHelper()

Method Detail

narrow

public static DynAny narrow(Object obj)

Cast the passed object into the DynAny. As DynAny is a local object, the method just uses java type cast.

Parameters:

obj - the object to narrow.

Returns:

narrowed instance.

Throws:

BAD_PARAM - if the passed object is not a DynAny.

unchecked_narrow

public static DynAny unchecked_narrow(Object obj)

Narrow the given object to the DynAny. For the objects that are always local, this operation does not differ from the ordinary narrow(org.omg.CORBA.Object) (ClassCastException will be thrown if narrowing something different).

Parameters:

obj - the object to cast.

Returns:

the casted DynAny.

Since:

1.5

See Also:

issue 4158.

type

public static TypeCode type()

Get the type code of the DynAny.

insert

public static void insert(Any any,
                          DynAny that)

Insert the DynAny into the given Any.

Parameters:

any - the Any to insert into.

that - the DynAny to insert.

extract

public static DynAny extract(Any any)

Extract the DynAny from given Any.

Throws:

BAD_OPERATION - if the passed Any does not contain DynAny.

id

public static String id()

Get the DynAny repository id.

Returns:

"IDL:omg.org/DynamicAny/DynAny:1.0", always.

read

public static DynAny read(InputStream input)

This should read DynAny from the CDR input stream, but (following the JDK 1.5 API) it does not.

Parameters:

input - a org.omg.CORBA.portable stream to read from.

Throws:

MARSHAL - always.

Specnote:

Sun throws the same exception.

write

public static void write(OutputStream output,
                         DynAny value)

This should read DynAny from the CDR input stream, but (following the JDK 1.5 API) it does not.

Parameters:

output - a org.omg.CORBA.portable stream to read from.

Throws:

MARSHAL - always.

Specnote:

Sun throws the same exception.