Main Page | Namespace List | Class Hierarchy | Alphabetical List | Class List | File List | Namespace Members | Class Members | File Members | Related Pages

abeans::pluggable::acs::cdb::dal::CDBDALRemoteInfo Class Reference

List of all members.

Public Member Functions

 CDBDALRemoteInfo (String remoteName, String authority, String plugType) throws NamingException
 CDBDALRemoteInfo (Name name, TargetPart[] targets) throws NamingException
 CDBDALRemoteInfo (Binding[] bindings) throws NamingException
 CDBDALRemoteInfo (String remoteName, String query, String authority, String plugType) throws NamingException

Detailed Description

This class is a CDBDAL plug implementation of RemoteInfo interface. As such, it represents the target in the remote layer, be it an action, a query, a namespace etc. The meaning of the target is defined by the contract between the entity submitting the remote request (usually modeling layer) and the entity processing it (usually the plug). The most important feature of the RemoteInfo implementation is to produce a consistent representation of that remote target. The consistency request is imposed on the agreement between different name forms that can exist for the same target. In other words, target can be represented as an Abeans URI, for instance

abeans-CDBDAL://dina.ijs.si:xxxx/PSBEND_M.01/current or it may be represented as a JNDI javax.naming.Name sequence:

[0]=abeans-CDBDAL [1]=dina.ijs.si:xxxx [2]=PSBEND_M.01 [3]=current or it may be a simple string. The default implementation allows all these conversions and is able to construct a new name from components like remoteName, URI authority, plugType and so on. For detailed documentation see RemoteInfo interface javadoc.

This implementation buffers the URI, so once it has been created for the first time, the invocations of toURI() return immediately. Moreover, this class implements javax.naming.Name directly.

As an instance of javax.naming.Name this instance is unmodifiable, i.e. all methods adding or removing a name component will fail with an exception.

Author:
Matej Sekoranja (matej.sekoranja@cosylab.com)
Version:
@VERSION@
See also:
DefaultRemoteInfo

RemoteInfo


Constructor & Destructor Documentation

abeans::pluggable::acs::cdb::dal::CDBDALRemoteInfo::CDBDALRemoteInfo String  remoteName,
String  authority,
String  plugType
throws NamingException [inline]
 

Creates a new remote info object from the name of the remote entity, the authority and the plug type. This constructor will usually be used to name connectable entities.

Parameters:
remoteName the name of the connectable entity; this name may contain slash hierarchical separators, non-null
authority an optional namespace authority (such as a name server, context server, device manager etc); i.e. that is the entity in the scope of which the remoteName becomes a unique remote target designation; may be null iff the plug can either provide a default value or the system runs on top of a global namespace
plugType the name of the plug under which this remote info is being issued; this is the plug where the remote target runs; non-null

abeans::pluggable::acs::cdb::dal::CDBDALRemoteInfo::CDBDALRemoteInfo Name  name,
TargetPart[]  targets
throws NamingException [inline]
 

Creates a new remote info object from a sequence of JNDI names and the corresponding sequence of TargetPart instances that define the meaning of each successive name component. This constructor is mostly used to build RemoteInfo instances from names obtained from abeans.models.DistributedDirectory.

Parameters:
name an array of names; non-null, each component non-null; each component is non-hierarchical (does not contain slash separators)
targets an array, non-null, each component non-null of the same length as name; each entry in this array describes the meaning of the name component with the same index

abeans::pluggable::acs::cdb::dal::CDBDALRemoteInfo::CDBDALRemoteInfo Binding[]  bindings  )  throws NamingException [inline]
 

This constructor is used to create a name from the tree path obtained from the abeans.models.DistributedDirectory. The binding array must contain, in each binding, a name and an instance of ModelingElementDescriptor. From the descriptors, this instance will extract the target part information that will be of help when identifying the meaning of each name component.

Parameters:
bindings the array of bindings (name - descriptor pairs) that represent some target in the distributed directory; a name for that target will be created by this constructor; non-null, each component is non-null.

abeans::pluggable::acs::cdb::dal::CDBDALRemoteInfo::CDBDALRemoteInfo String  remoteName,
String  query,
String  authority,
String  plugType
throws NamingException [inline]
 

Constructor for CDBDALRemoteInfo.

Parameters:
remoteName 
component 
query 
authority 
plugType 


The documentation for this class was generated from the following file:
Generated on Thu Apr 30 02:43:18 2009 for ACS Java API by doxygen 1.3.8