public interface ReplicaCatalog extends Catalog
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
BATCH_KEY
The suffix for the property that if set, specifies the size of the chunk
in which the implementations handle multiple queries.
|
static java.lang.String |
c_prefix
Prefix for the property subset to use with this catalog.
|
static java.lang.String |
DB_PREFIX
The DB Driver properties prefix.
|
static java.lang.String |
PROXY_KEY
The key that if set, specifies the proxy to be picked up while connecting
to the RLS.
|
DB_ALL_PREFIX
Modifier and Type | Method and Description |
---|---|
int |
clear()
Removes everything.
|
int |
delete(java.util.Map x,
boolean matchAttributes)
Deletes multiple mappings into the replica catalog.
|
int |
delete(java.lang.String lfn,
ReplicaCatalogEntry tuple)
Deletes a very specific mapping from the replica catalog.
|
int |
delete(java.lang.String lfn,
java.lang.String pfn)
Deletes a specific mapping from the replica catalog.
|
int |
delete(java.lang.String lfn,
java.lang.String name,
java.lang.Object value)
Deletes all PFN entries for a given LFN from the replica catalog
where the PFN attribute is found, and matches exactly the object
value.
|
int |
deleteByResource(java.lang.String lfn,
java.lang.String handle)
Deletes all PFN entries for a given LFN from the replica catalog
where the resource handle is found.
|
int |
insert(java.util.Map x)
Inserts multiple mappings into the replica catalog.
|
int |
insert(java.lang.String lfn,
ReplicaCatalogEntry tuple)
Inserts a new mapping into the replica catalog.
|
int |
insert(java.lang.String lfn,
java.lang.String pfn,
java.lang.String handle)
Inserts a new mapping into the replica catalog.
|
java.util.Set |
list()
Lists all logical filenames in the catalog.
|
java.util.Set |
list(java.lang.String constraint)
Lists a subset of all logical filenames in the catalog.
|
java.util.Map |
lookup(java.util.Map constraints)
Retrieves multiple entries for a given logical filename, up to the
complete catalog.
|
java.util.Map |
lookup(java.util.Set lfns)
Retrieves multiple entries for a given logical filename, up to the
complete catalog.
|
java.util.Map |
lookup(java.util.Set lfns,
java.lang.String handle)
Retrieves multiple entries for a given logical filename, up to the
complete catalog.
|
java.util.Collection |
lookup(java.lang.String lfn)
Retrieves all entries for a given LFN from the replica catalog.
|
java.lang.String |
lookup(java.lang.String lfn,
java.lang.String handle)
Retrieves the entry for a given filename and resource handle from
the replica catalog.
|
java.util.Map |
lookupNoAttributes(java.util.Set lfns)
Retrieves multiple entries for a given logical filename, up to the
complete catalog.
|
java.util.Map |
lookupNoAttributes(java.util.Set lfns,
java.lang.String handle)
Retrieves multiple entries for a given logical filename, up to the
complete catalog.
|
java.util.Set |
lookupNoAttributes(java.lang.String lfn)
Retrieves all entries for a given LFN from the replica catalog.
|
int |
remove(java.util.Set lfns)
Removes all mappings for a set of LFNs.
|
int |
remove(java.lang.String lfn)
Removes all mappings for an LFN from the replica catalog.
|
int |
removeByAttribute(java.lang.String handle)
Removes all entries associated with a particular resource handle.
|
int |
removeByAttribute(java.lang.String name,
java.lang.Object value)
Removes all entries from the replica catalog where the PFN attribute
is found, and matches exactly the object value.
|
static final java.lang.String c_prefix
static final java.lang.String DB_PREFIX
static final java.lang.String PROXY_KEY
static final java.lang.String BATCH_KEY
java.lang.String lookup(java.lang.String lfn, java.lang.String handle)
lfn
- is the logical filename to obtain information for.handle
- is the resource handle to obtain entries for.null
if no match was found.java.util.Collection lookup(java.lang.String lfn)
lfn
- is the logical filename to obtain information for.ReplicaCatalogEntry
java.util.Set lookupNoAttributes(java.lang.String lfn)
lfn
- is the logical filename to obtain information for.java.util.Map lookup(java.util.Set lfns)
lfns
- is a set of logical filename strings to look up.ReplicaCatalogEntry
java.util.Map lookupNoAttributes(java.util.Set lfns)
lfns
- is a set of logical filename strings to look up.java.util.Map lookup(java.util.Set lfns, java.lang.String handle)
lfns
- is a set of logical filename strings to look up.handle
- is the resource handle, restricting the LFNs.ReplicaCatalogEntry
java.util.Map lookupNoAttributes(java.util.Set lfns, java.lang.String handle)
lfns
- is a set of logical filename strings to look up.handle
- is the resource handle, restricting the LFNs.java.util.Map lookup(java.util.Map constraints)
constraints
- is mapping of keys 'lfn', 'pfn', or any
attribute name, e.g. the resource handle 'site', to a string that
has some meaning to the implementing system. This can be a SQL
wildcard for queries, or a regular expression for Java-based memory
collections. Unknown keys are ignored. Using an empty map requests
the complete catalog.ReplicaCatalogEntry
java.util.Set list()
java.util.Set list(java.lang.String constraint)
constraint
- is a constraint for the logical filename only. It
is a string that has some meaning to the implementing system. This
can be a SQL wildcard for queries, or a regular expression for
Java-based memory collections.int insert(java.lang.String lfn, ReplicaCatalogEntry tuple)
lfn
- is the logical filename under which to book the entry.tuple
- is the physical filename and associated PFN attributes.int insert(java.lang.String lfn, java.lang.String pfn, java.lang.String handle)
ReplicaCatalogEntry
element will be contructed, and passed to
the appropriate insert function.lfn
- is the logical filename under which to book the entry.pfn
- is the physical filename associated with it.handle
- is a resource handle where the PFN resides.insert( String, ReplicaCatalogEntry )
,
ReplicaCatalogEntry
int insert(java.util.Map x)
x
- is a map from logical filename string to list of replica
catalog entries.ReplicaCatalogEntry
int delete(java.util.Map x, boolean matchAttributes)
x
- is a map from logical filename string to list of
replica catalog entries.matchAttributes
- whether mapping should be deleted only if all
attributes match.ReplicaCatalogEntry
int delete(java.lang.String lfn, java.lang.String pfn)
lfn
- is the logical filename in the tuple.pfn
- is the physical filename in the tuple.int delete(java.lang.String lfn, ReplicaCatalogEntry tuple)
lfn
- is the logical filename in the tuple.tuple
- is a description of the PFN and its attributes.int delete(java.lang.String lfn, java.lang.String name, java.lang.Object value)
lfn
- is the logical filename to look for.name
- is the PFN attribute name to look for.value
- is an exact match of the attribute value to match.int deleteByResource(java.lang.String lfn, java.lang.String handle)
delete( lfn, RESOURCE_HANDLE, handle )
lfn
- is the logical filename to look for.handle
- is the resource handleint remove(java.lang.String lfn)
lfn
- is the logical filename to remove all mappings for.int remove(java.util.Set lfns)
lfns
- is a set of logical filename to remove all mappings for.int removeByAttribute(java.lang.String name, java.lang.Object value)
name
- is the PFN attribute name to look for.value
- is an exact match of the attribute value to match.int removeByAttribute(java.lang.String handle)
removeByAttribute
method.handle
- is the site handle to remove all entries for.removeByAttribute( String, Object )
int clear()