NamedValue (Java Platform SE 6) - JDK 5 Documentation v6.0, Java 2 SDK 英文文档

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

Java™ Platform
Standard Ed. 6

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.omg.CORBA
Class NamedValue

java.lang.Object
  org.omg.CORBA.NamedValue

public abstract class NamedValue
extends Object
extends Object

An object used in the DII and DSI to describe arguments and return values. NamedValue objects are also used in the Context object routines to pass lists of property names and values.

A NamedValue object contains:

a name -- If the NamedValue object is used to describe arguments to a request, the name will be an argument identifier specified in the OMG IDL interface definition for the operation being described.
a value -- an Any object
an argument mode flag -- one of the following:
- ARG_IN.value
- ARG_OUT.value
- ARG_INOUT.value
- zero -- if this NamedValue object represents a property in a Context object rather than a parameter or return value

The class NamedValue has three methods, which access its fields. The following code fragment demonstrates creating a NamedValue object and then accessing its fields:

    ORB orb = ORB.init(args, null);
    String s = "argument_1";
    org.omg.CORBA.Any myAny = orb.create_any();
    myAny.insert_long(12345);
    int in = org.omg.CORBA.ARG_IN.value;

    org.omg.CORBA.NamedValue nv = orb.create_named_value(
        s, myAny, in);
    System.out.println("This nv name is " + nv.name());
    try {
        System.out.println("This nv value is " + nv.value().extract_long());
        System.out.println("This nv flag is " + nv.flags());
    } catch (org.omg.CORBA.BAD_OPERATION b) {
      System.out.println("extract failed");
    }

If this code fragment were put into a main method, the output would be something like the following:

    This nv name is argument_1
    This nv value is 12345
    This nv flag is 1

Note that the method value returns an Any object. In order to access the long contained in the Any object, we used the method extract_long.

Since:: JDK1.2
See Also:: Any, ARG_IN, ARG_INOUT, ARG_OUT

Constructor Summary

NamedValue()


Method Summary

abstract int flags()
          Retrieves the argument mode flag for this NamedValue object.

abstract String name()
          Retrieves the name for this NamedValue object.

abstract Any value()
          Retrieves the value for this NamedValue object.

Methods inherited from class java.lang.Object

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

Constructor Summary
`NamedValue()`

Method Summary
`abstract int`	`flags()` Retrieves the argument mode flag for this `NamedValue` object.
`abstract String`	`name()` Retrieves the name for this `NamedValue` object.
`abstract Any`	`value()` Retrieves the value for this `NamedValue` object.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

NamedValue

public NamedValue()

Method Detail

name

public abstract String name()

Retrieves the name for this NamedValue object.

Returns:: a String object representing the name of this NamedValue object

value

public abstract Any value()

Retrieves the value for this NamedValue object.

Returns:: an Any object containing the value of this NamedValue object

flags

public abstract int flags()

Retrieves the argument mode flag for this NamedValue object.

Returns:: an int representing the argument mode for this NamedValue object