org.omg.CORBA.NamedValue Maven / Gradle / Ivy
/*
* Copyright (c) 1997, 2020 Oracle and/or its affiliates.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License v. 2.0 which is available at
* http://www.eclipse.org/legal/epl-2.0, or the Eclipse Distribution License
* v. 1.0 which is available at
* http://www.eclipse.org/org/documents/edl-v10.php.
*
* This Source Code may also be made available under the following Secondary
* Licenses when the conditions for such availability set forth in the Eclipse
* Public License v. 2.0 are satisfied: GNU General Public License v2.0
* w/Classpath exception which is available at
* https://www.gnu.org/software/classpath/license.html.
*
* SPDX-License-Identifier: EPL-2.0 OR BSD-3-Clause OR GPL-2.0 WITH
* Classpath-exception-2.0
*/
package org.omg.CORBA;
/**
* 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
.
*
* @see Any
* @see ARG_IN
* @see ARG_INOUT
* @see ARG_OUT
*
* @version 1.12 ,09/09/97
* @since JDK1.2
*/
public abstract class NamedValue {
/**
* Retrieves the name for this NamedValue
object.
*
* @return a String
object representing
* the name of this NamedValue
object
*/
public abstract String name();
/**
* Retrieves the value for this NamedValue
object.
*
* @return an Any
object containing
* the value of this NamedValue
object
*/
public abstract Any value();
/**
* Retrieves the argument mode flag for this NamedValue
object.
*
* @return an int
representing the argument
* mode for this NamedValue
object
*/
public abstract int flags();
}