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
1.3.8