|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
The middleware level API for the composite File and SURLStat catalog operations.
This interface provides combined operations over the File and
Replica Catalog interfaces as well as all operations of the FileCatalog and ReplicaCatalog
interfaces which are then simply forwarded to the corresponding services
The additional methods giving added value are those which require coordination between
the two catalog services.
Method Summary | |
void |
addReplica(java.lang.String lfn,
SURLEntry[] newSurls)
New mapping creation for {LFN,SURL[]} pairs. |
void |
associateDirWithSchema(java.lang.String directoryLfn,
java.lang.String schemaName)
Associates an existing directory with an existing schema. |
void |
create(FRCEntry[] entries)
Creates entries based on LFN and SURL only. |
Stat[] |
getStat(java.lang.String[] lfns)
Lists LFNStat for a given LFN. |
StringPair[] |
listLfn(java.lang.String[] surls)
Lists LFN for SURL of interest |
FRCEntry[] |
listReplicas(java.lang.String[] lfns,
boolean withPermissions)
List all known SURLs registered to a given LFN. |
void |
remove(java.lang.String[] lfns)
Removes LFN and all linked data (corresponding guid and replicas) from catalog. |
void |
removeReplica(StringPair[] lfnSurls,
boolean removeLfnOnLastReplica)
Removes specified mappings. |
Methods inherited from interface org.glite.data.catalog.service.file.FileCatalog |
createFile, getFileCatalogEntry, getGuidForLfn, getLfnForGuid, locate, mkdir, mv, readDir, rmdir, symlink, unlink, updateModifyTime, updateValidityTime |
Methods inherited from interface org.glite.data.catalog.service.fas.FASBase |
checkPermission, getPermission, setPermission |
Methods inherited from interface org.glite.data.catalog.service.ServiceBase |
getInterfaceVersion, getSchemaVersion, getServiceMetadata, getVersion |
Methods inherited from interface org.glite.data.catalog.service.meta.MetadataBase |
clearAttributes, getAttributes, listAttributes, query, setAttributes |
Methods inherited from interface org.glite.data.catalog.service.replica.ReplicaCatalog |
addGuidReplica, createGuid, getDefaultGlobalPermission, getDefaultPrincipalPermission, getGuidForSurl, getGuidStat, getMasterReplica, getSurlStat, hasGuid, listReplicasByGuid, listSurlsByGuid, removeGuid, removeGuidReplica, setDefaultGlobalPermission, setDefaultPrincipalPermission, setMasterReplica, updateGuidStat, updateStatus, updateSurlStat |
Method Detail |
public void create(FRCEntry[] entries) throws InternalException, AuthorizationException, ExistsException, NotExistsException, InvalidArgumentException
entries
- A list of FRCEntry
objects.
If permission not passed, one derived from the parent directory is used.
Otherwise only the passed one is used.
AuthorizationException
- No access right to create new entry in the parent directory.
ExistsException
- The file already exists.
NotExistsException
- One of the parent path elements does not exists.
InvalidArgumentException
- Some part of the argument is invalid.
InternalException
- InvalidArgumentException
.
NotExistsException
.
ExistsException
.
AuthorizationException
.
public FRCEntry[] listReplicas(java.lang.String[] lfns, boolean withPermissions) throws InternalException, AuthorizationException, NotExistsException
lfns
- The Logical File Name to list SURLs for.withPermissions
- Flag whether to include permissions in the listing
AuthorizationException
- No access right to read LFN.
NotExistsException
- LFN does not exists.
InvalidArgumentException
- Some part of the argument is invalid.
InternalException
- InvalidArgumentException
.
NotExistsException
.
InvalidArgumentException
.
AuthorizationException
.
public StringPair[] listLfn(java.lang.String[] surls) throws InternalException, AuthorizationException, NotExistsException, InvalidArgumentException
surls
- list of surls we want perform LFN lookup
AuthorizationException
- No access right to list the LFN for a given SURL.
NotExistsException
- The SURL does not exist.
InvalidArgumentException
- Some part of the argument is invalid.
InternalException
- InvalidArgumentException
.
NotExistsException
.
AuthorizationException
.
public Stat[] getStat(java.lang.String[] lfns) throws InternalException, AuthorizationException, NotExistsException, InvalidArgumentException
lfns
- list of LFNs we want LFNStat object for.
InvalidArgumentException
- Some part of the argument is invalid.
AuthorizationException
- No access right get status information.
NotExistsException
- The LFN does not exist.
InternalException
- InvalidArgumentException
.
NotExistsException
.
AuthorizationException
.
public void addReplica(java.lang.String lfn, SURLEntry[] newSurls) throws InternalException, AuthorizationException, ExistsException, NotExistsException, InvalidArgumentException
lfn
- LFN to add new SURLs to, has to be a file.newSurls
- The list of new SURLs to add
AuthorizationException
- No right to add new SURLs to an existing replica.
ExistsException
- The LFN-SURL pair already exists.
InvalidArgumentException
- Some part of the argument is invalid.
NotExistsException
- The LFN does not exist.
InternalException
- InvalidArgumentException
.
NotExistsException
.
InvalidArgumentException
.
AuthorizationException
.
ExistsException
.
public void remove(java.lang.String[] lfns) throws InternalException, AuthorizationException, NotExistsException, InvalidArgumentException
lfns
- LFN for removal, cannot be directories
AuthorizationException
- No right to remove the entry from the catalog.
InvalidArgumentException
- Some part of the argument is invalid.
NotExistsException
- The LFN does not exist.
InternalException
- InvalidArgumentException
.
NotExistsException
.
InvalidArgumentException
.
AuthorizationException
.
public void removeReplica(StringPair[] lfnSurls, boolean removeLfnOnLastReplica) throws InternalException, AuthorizationException, NotExistsException, InvalidArgumentException
lfnSurls
- list of {LFN, SURL} pair objects.
The first string is the LFN, the second is the SURL to be removed.removeLfnOnLastReplica
- tells the catalog whether the LFN should be removed if the last SURL is removed.
AuthorizationException
- No right to remove a replica from the given LFN.
NotExistsException
- Either the LFN does not exist or the given SURL is not a registered replica of the LFN.
InvalidArgumentException
- The LFN or SURL of an entry is malformed.
InternalException
- InvalidArgumentException
.
NotExistsException
.
AuthorizationException
.
InvalidArgumentException
.
AuthorizationException
.
public void associateDirWithSchema(java.lang.String directoryLfn, java.lang.String schemaName) throws InternalException
directoryLfn
- The lfn of the directory.schemaName
- The name of the schema to be associated with the directory.
InternalException
AuthorizationException
- No right to list entries in the catalog.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |