Java Globus API: Class GRCEntry

org.globus.replica.catalog
Class GRCEntry

java.lang.Object
  |
  +--org.globus.replica.catalog.GRCEntry
Direct Known Subclasses:
GRCDirectory, GRCFile

public abstract class GRCEntry
extends Object

The proxy for a replica catalog entry, containing methods for creation of an entry and management of its attributes.

Version:
1.3
Author:
Chi Chen, Darcy Quesnel

Field Summary
protected  GRCContext _ctx
           
protected  Attribute _oc
           
 
Constructor Summary
protected GRCEntry(GRCContext ctx, String name)
          Construct a proxy for an entry in the given replica catalog context.
 
Method Summary
 void addAttributes(Attributes attrs)
          Add attributes to the entry in the replica catalog.
 void create()
          Create an entry in the replica catalog.
 void deleteAttributes(Attributes attrs)
          Delete attributes from the entry in the replica catalog.
 void destroy()
          Destroy an entry in the replica catalog.
 String getName()
          Get the logical name of the entry.
protected abstract  String getRDN()
          Get the rdn of the entry.
 Attributes listAttributes()
          List attributes of the entry in the replica catalog.
 Attributes listAttributes(String[] attrs)
          List attributes of the entry in the replica catalog.
protected  void putAttrs(Attribute attr)
          Add the attr that that will be associated with the entry
 void replaceAttributes(Attributes attrs)
          Replace attributes to the entry in the replica catalog.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

_oc

protected Attribute _oc

_ctx

protected GRCContext _ctx
Constructor Detail

GRCEntry

protected GRCEntry(GRCContext ctx,
                   String name)
Construct a proxy for an entry in the given replica catalog context.
Parameters:
ctx - replica catalog context to connect with
name - name of the entry to create
Method Detail

create

public void create()
            throws NamingException
Create an entry in the replica catalog.

destroy

public void destroy()
             throws NamingException
Destroy an entry in the replica catalog.

putAttrs

protected void putAttrs(Attribute attr)
Add the attr that that will be associated with the entry
Parameters:
attr - the attribute to be added
See Also:
Attribute

getName

public String getName()
Get the logical name of the entry. As an example, if the underlying implementation uses LDAP, then the name is the value of the rdn field/value pair. If the corresponding entry has not been created, or if this hasn't been returned by some other query function, then the name may not be known.
Returns:
name, rdn, if the implementation of the directory service is LDAP, of the entry

getRDN

protected abstract String getRDN()
Get the rdn of the entry.
Returns:
a String presentation of the rdn of the entry

listAttributes

public Attributes listAttributes()
                          throws NamingException
List attributes of the entry in the replica catalog.
Returns:
attributes associated with the entry
See Also:
Attributes

listAttributes

public Attributes listAttributes(String[] attrs)
                          throws NamingException
List attributes of the entry in the replica catalog.
Parameters:
attrs - names of attributes to return.
Returns:
attributes associated with the entry
See Also:
Attributes

addAttributes

public void addAttributes(Attributes attrs)
                   throws NamingException
Add attributes to the entry in the replica catalog.
Parameters:
attrs - attributes to associate with the entry
See Also:
Attributes

replaceAttributes

public void replaceAttributes(Attributes attrs)
                       throws NamingException
Replace attributes to the entry in the replica catalog.
Parameters:
attrs - new attributes to associate with the entry
See Also:
Attributes

deleteAttributes

public void deleteAttributes(Attributes attrs)
                      throws NamingException
Delete attributes from the entry in the replica catalog.
Parameters:
attrs - attributes to disassociate with the entry
See Also:
Attributes