-
Interface Summary Interface Description BindingIterator The BindingIterator interface allows a client to iterate through the bindings using the next_one or next_n operations.BindingIteratorOperations The BindingIterator interface allows a client to iterate through the bindings using the next_one or next_n operations.NamingContext A naming context is an object that contains a set of name bindings in which each name is unique.NamingContextExt NamingContextExt
is the extension ofNamingContext
which contains a set of name bindings in which each name is unique and is part of Interoperable Naming Service.NamingContextExtOperations NamingContextExt
is the extension ofNamingContext
which contains a set of name bindings in which each name is unique and is part of Interoperable Naming Service.NamingContextOperations A naming context is an object that contains a set of name bindings in which each name is unique. -
Class Summary Class Description _BindingIteratorImplBase _BindingIteratorStub The BindingIterator interface allows a client to iterate through the bindings using the next_one or next_n operations._NamingContextExtStub NamingContextExt
is the extension ofNamingContext
which contains a set of name bindings in which each name is unique and is part of Interoperable Naming Service._NamingContextImplBase _NamingContextStub A naming context is an object that contains a set of name bindings in which each name is unique.Binding org/omg/CosNaming/Binding.java .BindingHelper org/omg/CosNaming/BindingHelper.java .BindingHolder org/omg/CosNaming/BindingHolder.java .BindingIteratorHelper The BindingIterator interface allows a client to iterate through the bindings using the next_one or next_n operations.BindingIteratorHolder The BindingIterator interface allows a client to iterate through the bindings using the next_one or next_n operations.BindingIteratorPOA The BindingIterator interface allows a client to iterate through the bindings using the next_one or next_n operations.BindingListHelper List of Bindings.BindingListHolder List of Bindings.BindingType Specifies whether the given binding is for a object (that is not a naming context) or for a naming context.BindingTypeHelper Specifies whether the given binding is for a object (that is not a naming context) or for a naming context.BindingTypeHolder Specifies whether the given binding is for a object (that is not a naming context) or for a naming context.IstringHelper org/omg/CosNaming/IstringHelper.java .NameComponent org/omg/CosNaming/NameComponent.java .NameComponentHelper org/omg/CosNaming/NameComponentHelper.java .NameComponentHolder org/omg/CosNaming/NameComponentHolder.java .NameHelper A name is a sequence of name components.NameHolder A name is a sequence of name components.NamingContextExtHelper NamingContextExt
is the extension ofNamingContext
which contains a set of name bindings in which each name is unique and is part of Interoperable Naming Service.NamingContextExtHolder NamingContextExt
is the extension ofNamingContext
which contains a set of name bindings in which each name is unique and is part of Interoperable Naming Service.NamingContextExtPOA NamingContextExt
is the extension ofNamingContext
which contains a set of name bindings in which each name is unique and is part of Interoperable Naming Service.NamingContextHelper A naming context is an object that contains a set of name bindings in which each name is unique.NamingContextHolder A naming context is an object that contains a set of name bindings in which each name is unique.NamingContextPOA A naming context is an object that contains a set of name bindings in which each name is unique.
Package org.omg.CosNaming Description
The package and all its classes and interfaces
were generated by running the tool idlj
on the file
nameservice.idl
, which is a module written in OMG IDL.
Package Specification
For a precise list of supported sections of official specifications with which the Java[tm] Platform, Standard Edition 6, ORB complies, see Official Specifications for CORBA support in Java[tm] SE 6.
Interfaces
The package org.omg.CosNaming contains two public interfaces and several auxiliary classes.The interfaces are:
- NamingContext
- BindingIterator
These two interfaces provide the means to bind/unbind names and object
references, to retrieve bound object references, and
to iterate through a list of bindings. The NamingContext
interface supplies the main functionality for the naming service, and
BindingIterator
provides a means of iterating through a list
of name/object reference bindings.
Auxiliary Classes
In order to map an OMG IDL interface to the Java programming language, the idlj compiler creates Java classes that can be thought of as auxiliary classes. Comments for the generated auxiliary classes used by the interfacesNamingContext
and
BindingIterator
are included here.
Classes Used by NamingContext
and
BindingIterator
The following are classes used by
the naming service. (Helper and holder classes, which are
generated for each of the classes listed here, are discussed below.)
public final class NameComponent
-- a building block for names. (Names are bound to object references in a naming context.)A name is an array of one or more
NameComponent
objects. A name with a singleNameComponent
is called a simple name; a name with multipleNameComponent
objects is called a compound name.A
NameComponent
object consists of two fields:id
-- aString
used as an identifierkind
-- aString
that can be used for any descriptive purpose. Its importance is that it can be used to describe an object without affecting syntax. The C programming language, for example, uses the the syntactic convention of appending the extension ".c" to a file name to indicate that it is a source code file. In aNameComponent
object, thekind
field can be used to describe the type of object rather than a file extension or some other syntactic convention. Examples of the value of thekind
field include the strings"c_source"
,"object_code"
,"executable"
,"postscript"
, and""
. It is not unusual for thekind
field to be the empty string.
In a name, each
NameComponent
object except the last denotes aNamingContext
object; the lastNameComponent
object denotes the bound object reference. This is similar to a path name, in which the last name is the file name, and all names before it are directory names.public final class Binding
-- an object that associates a name with an object reference or a naming context. ABinding
object has two fields:binding_name
- an array of one or moreNameComponent
objects that represents the bound namebinding_type
- aBindingType
object indicating whether the binding is between a name and an object reference or between a name and a naming context
The interface
NamingContext
has methods for binding/unbinding names with object references or naming contexts, for listing bindings, and for resolving bindings (given a name, the methodresolve
returns the object reference bound to it).public final class BindingType
-- an object that specifies whether the givenBinding
object is a binding between a name and an object reference (that is, not a naming context) or between a name and a naming context.The class
BindingType
consists of two methods and four constants. Two of these constants areBindingType
objects, and two areint
s.The
BindingType
objects can be passed to the constructor for the classBinding
or used as parameters or return values. TheseBindingType
objects are:public static final BindingType nobject
-- to indicate that the binding is with an object referencepublic static final BindingType ncontext
-- to indicate that the binding is with a naming context
The
int
constants can be supplied to the methodfrom_int
to createBindingType
objects, or they can be return values for the methodvalue
. These constants are:public static final int _nobject
public static final int _ncontext
from_int
is supplied with anything other than_nobject
or_ncontext
, it will throw the exceptionorg.omg.CORBA.BAD_PARAM
.Usage is as follows:
BindingType btObject = from_int(_nobject); BindingType btContext = from_int(_ncontext);
The variablebtObject
refers to aBindingType
object initialized to represent a binding with an object reference. The variablebtContext
refers to aBindingType
object initialized to represent a binding with aNamingContex
object.The method
value
returns either_nobject
or_ncontext
, so in the following line of code, the variablebt
will contain_nobject
or_ncontext
:int bt = BindingType.value();
Holder Classes
OMG IDL uses OUT and INOUT parameters for returning values from operations. The mapping to the Java programming language, which does not have OUT and INOUT parameters, creates a special class for each type, called a holder class. An instance of a holder class can be passed to a Java method as a parameter, and a value can be assigned to itsvalue
field. This allows
it to perform the function of an OUT or INOUT parameter.
The following holder classes are generated for the package
org.omg.CosNaming
:
NamingContextHolder
BindingIteratorHolder
BindingHolder
BindingListHolder
BindingTypeHolder
NameComponentHolder
NameHolder
Note that in the org.omg.CORBA
package,
there is a holder class for each of the basic Java types:
IntHolder
, ShortHolder
,
StringHolder
, and so on.
Note also that there is a NameHolder
class even though
there is no Name
class; similarly, there is a
BindingListHolder
class even though there is no
BindingList
class. This is true because in the OMG IDL
interface, Name
and BindingList
are
typedef
s. There is no mapping from an IDL
typedef
to a Java construct, but holder classes
are generated if the typedef
is for a sequence or
an array. As mapped to the
Java programming language, Name
is an array of
NameComponent
objects, and a BindingList
is an array of Binding
objects.
All holder classes have at least two constructors and one field:
value
field -- an instance of the type being used as an OUT or INOUT parameter. For example, thevalue
field of aNamingContextHolder
will be aNamingContext
object.- default constructor -- a constructor that creates a new holder object
initialized with the default value for the type. For example, a new
BindingHolder
object created with the default constructor will have itsvalue
field set tonull
because that is the default value for an object. Other defaults arefalse
forboolean
,0
for numeric and char types, andnull
for object references. - constructor from an instance -- a constructor that creates a new
holder object whose
value
field is initialized with the instance supplied
A holder class for a user-defined type (a Java class) has three more methods, but application developers do not use them directly.
Helper Classes
Helper classes, which are generated for all user-defined types in an OMG IDL interface, supply static methods needed to manipulate those types.
There is only one method in a helper class that an
application programmer uses: the
method narrow
. Only Java interfaces mapped from IDL
interfaces will have a helper class that includes a narrow
method, so in the CosNaming
package, only the classes
NamingContextHelper
and BindingIteratorHelper
have a narrow
method.
public static NamingContext narrow(org.omg.CORBA.Object obj)
-- converts the given CORBA object to aNamingContext
objectpublic static BindingIterator narrow(org.omg.CORBA.Object obj)
-- converts the given CORBA object to aBindingIterator
object
Package org.omg.CosNaming.NamingContextPackage
This package supplies Helper and Holder classes for the exceptions used
in the package org.omg.CosNaming
and also for the class
NotFoundReason
, which supplies a reason for the exception
NotFound
.
There are Helper and Holder classes for the following exceptions:
AlreadyBound
CannotProceed
InvalidName
NotEmpty
NotFound
Naming Service Compatibility
Sun's implementation of theCosNaming
package complies
with the OMG COSNaming
specification. In other words,
the APIs in Sun's naming service are implemented according to the
guidelines for a naming service provided by OMG. Therefore, if a
third-party vendor has implemented a naming service that is OMG
compliant, it is possible to switch between Sun's implementation of
CosNaming
and the third-party vendor's implementation.
However, it is important to understand that there can be minor
variations in the way different vendors implement the naming service,
such as differences in the exception strings.
Instructions for Using a Third Party's Naming Service
Although we encourage using an ORB and ORB services that are both from one vendor, it is possible to plug in a third party'sCOSNaming
implementation with Sun's RMI-IIOP ORB.
Here are the steps to follow:
- Create a properties file for the Bootstrap server and give it
two entries. For example, you could call this properties file
/tmp/services
and put the following in it:NameService, <Stringified IOR of the Root Naming Context>
.This associates
NameService
with the Root Naming Context of theCosNaming
implementation that you want to use. - Start the standalone Bootstrap server using the following command:
java -classpath $(CLASSPATH) com.sun.corba.ee.internal.CosNaming.BootstrapServer -InitialServicesFile "/tmp/services" [-ORBInitialPort port]
Note that the square brackets at the end of the command indicate that specifying a port number is optional.
Now when an application calls the method
org.omg.CORBA.ORB.resolve_initial_references
, CORBA
processes will contact the Bootstrap Server to get the Root Naming
Context.
Package Specification
- Interoperable Naming Service (ptc/00-08-07)
Related Documentation
For an overview and examples of how to use theCosNaming
API, please see:
For an overview of Java IDL, please see:
- Since:
- JDK1.3
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
21/11/2024 21:40:41 Cette version de la page est en cache (à la date du 21/11/2024 21:40:41) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 30/08/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-org/omg/cosnaming/package-summary.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.