Main Page   Namespace List   Class Hierarchy   Compound List   File List   Namespace Members   Compound Members   File Members  

EdgReplicaLocationService::LocalReplicaCatalog Class Reference

Inheritance diagram for EdgReplicaLocationService::LocalReplicaCatalog:

EdgReplicaLocationService::RemoteLocalReplicaCatalog List of all members.

Public Methods

 LocalReplicaCatalog (const std::string &url)
 create a new LocalReplicaCatalog. More...

virtual ~LocalReplicaCatalog ()
 standard virtual destructor. More...

virtual const std::string & getUrl () const=0
 get the URL this LocalReplicaCatalog resides at. More...

virtual void addMapping (const std::string &guid, const std::string &pfn)=0 throw (ValueTooLongException, PfnExistsException, CommunicationException)
 add a new mapping to the Catalog. More...

virtual void deleteMapping (const std::string &guid)=0 throw (CommunicationException)
 delete all parts of an guid to pfn mapping including attached attributes. More...

virtual void removeMapping (const std::string &guid, const std::string &pfn)=0 throw (CommunicationException)
 remove from the catalog a single guid to pfn mapping. More...

virtual bool guidExists (const std::string &guid) const=0 throw (CommunicationException)
 Do we have a given guid in the catalog? More...

virtual bool pfnExists (const std::string &pfn) const=0 throw (CommunicationException)
 Do we have a given physical filename in the catalog? More...

virtual void getPfns (const std::string &guid, std::vector< std::string > &output) const=0 throw (NoSuchGuidException, CommunicationException)
 For a given guid, return all the physical filenames we map to in this Catalog. More...

virtual const std::string guidForPfn (const std::string &pfn) const=0 throw (NoSuchPfnException, CommunicationException)
 For a given pfn, return the guid that points to it. More...

virtual void createAttributeDefinition (const AttributeDefinition &attrDef)=0 throw (AttributeDefinitionExistsException, EmptyAttributeNameException, ValueTooLongException, CommunicationException)
 Create a new Attribute Definition in the Catalog. More...

virtual AttributeDefinition getAttributeDefinition (const std::string &attrName) const=0 throw (NoSuchAttributeDefinitionException, CommunicationException)
 Get the AttributeDefinition corresponding to the attribute name. More...

virtual void getAttributeDefinitions (AttrDefs_t &attdefs) const=0 throw (CommunicationException)
 Retrieve the list of all available attribute definitions. More...

virtual void removeAttributeDefinition (const std::string &attrName)=0 throw (NoSuchAttributeDefinitionException, EmptyAttributeNameException, CommunicationException)
 Delete an Attribute Definition from the Catalog. More...

virtual bool attributeDefinitionExists (const std::string &attrName) const=0 throw (CommunicationException)
 do we have an attribute definition for a given attribute name? More...

virtual void setPfnAttribute (const std::string &pfn, const std::string &attrName, const std::string &value)=0 throw (NoSuchPfnException, NoSuchAttributeDefinitionException, ValueTooLongException, CommunicationException)
 Add an attribute value to a PFN. More...

virtual void setStringPfnAttribute (const std::string &pfnName, const std::string &attrDefnName, const std::string &attrValue)=0 throw (NoSuchAttributeDefinitionException, NoSuchPfnException, UnappropriateAttributeTypeException, CommunicationException)
 Add an attribute value to a PFN attribute of type string. More...

virtual void setIntPfnAttribute (const std::string &pfnName, const std::string &attrDefnName, int attrValue)=0 throw (NoSuchAttributeDefinitionException, NoSuchPfnException, UnappropriateAttributeTypeException, CommunicationException)
 Add an attribute value to a PFN attribute of type int. More...

virtual void setFloatPfnAttribute (const std::string &pfnName, const std::string attrDefnName, float attrValue)=0 throw (NoSuchAttributeDefinitionException, NoSuchPfnException, UnappropriateAttributeTypeException, CommunicationException)
 Add an attribute value to a PFN attribute of type float. More...

virtual std::string getStringPfnAttribute (const std::string &pfnName, const std::string &attrDefnName)=0 throw (NoSuchPfnException, NoSuchAttributeDefinitionException, UnappropriateAttributeTypeException, CommunicationException)
 return the value of a given string attribute for a PFN. More...

virtual int getIntPfnAttribute (const std::string &pfnName, const std::string &attrDefnName)=0 throw (NoSuchPfnException, NoSuchAttributeDefinitionException, UnappropriateAttributeTypeException, CommunicationException)
 return the value of a given int attribute for an PFN. More...

virtual float getFloatPfnAttribute (const std::string &pfnName, const std::string &attrDefnName)=0 throw (NoSuchPfnException, NoSuchAttributeDefinitionException, UnappropriateAttributeTypeException, CommunicationException)
 return the value of a given float attribute for an PFN. More...

virtual void removePfnAttribute (const std::string &pfn, const std::string &attrName)=0 throw (NoSuchPfnException, NoSuchAttributeDefinitionException, NoSuchAttributeException, CommunicationException)
 remove the value of a given attribute for an PFN. More...

virtual void setDefaultResultLength (int resultLength)=0 throw (CommunicationException)
 Set the number of mappings that will be displayed by default. More...

virtual int getDefaultResultLength () const=0 throw (CommunicationException)
 Return the number of mappings that will be displayed by default. More...

virtual void getColumnSizes (ColumnSizes &) const=0 throw (CommunicationException)
 Return the maximum number of characters for a GUID, a PFN and an attribute. More...

virtual void getMappingsWithAttributes (const std::vector< std::string > &guids, std::vector< Mapping > &mappings) const=0 throw (CommunicationException)
 Return the mappings for a list of guids. More...

virtual void setMappingsWithAttributes (const std::vector< Mapping > &mappings) const=0 throw (CommunicationException, NoSuchAttributeDefinitionException, UnappropriateAttributeTypeException, PfnExistsException)
 Add a set of guid to pfn mappings, with optional pfn attributes to the database. More...

virtual void getMappingsByGuid (const std::string &guidPattern, std::vector< GuidPfnPair_t > &mappings) const=0 throw (CommunicationException)
 Return the guid to physical filename mappings which contain a guid that matches the given guidPattern. More...

virtual void getMappingsByGuid (const std::string &guidPattern, int resultLength, std::vector< GuidPfnPair_t > &mappings) const=0 throw (CommunicationException)
 Return the guid to physical filename mappings which contain a guid that matches the given guidPattern. More...

virtual void getMappingsByGuid (const std::string &guidPattern, int resultLength, int resultStart, std::vector< GuidPfnPair_t > &mappings) const=0 throw (CommunicationException)
 Return the guid to physical filename mappings which contain a guid that matches the given guidPattern. More...

virtual void getMappingsByPfn (const std::string &pfnPattern, std::vector< GuidPfnPair_t > &mappings) const=0 throw (CommunicationException)
 Return the guid to physical filename mappings which contain a physical filename that matches the given pfnPattern. More...

virtual void getMappingsByPfn (const std::string &pfnPattern, int resultLength, std::vector< GuidPfnPair_t > &mappings) const=0 throw (CommunicationException)
 Return the guid to physical filename mappings which contain a pfn that matches the given pfnPattern. More...

virtual void getMappingsByPfn (const std::string &pfnPattern, int resultLength, int resultStart, std::vector< GuidPfnPair_t > &mappings) const=0 throw (CommunicationException)
 Return the guid to physical filename mappings which contain a pfn that matches the given pfnPattern. More...

virtual void getMappingsByAttribute (const std::string &SQLQuery, int resultLength, std::vector< GuidPfnPair_t > &mappings) const=0 throw (InvalidQueryException, CommunicationException)
 Return the guid to physical filename mappings which contain the PFNs corresponding to the given attributes conditions. More...

virtual void getMappingsByAttribute (const std::string &SQLQuery, int resultLength, int resultStart, std::vector< GuidPfnPair_t > &mappings) const=0 throw (InvalidQueryException, CommunicationException)
 Return the guid to physical filename mappings which the PFNs corresponding to the given attributes conditions. More...

virtual void getMappingsWithAttributes (const std::string &SQLQuery, int resultLength, std::vector< Mapping > &mappings) const=0 throw (InvalidQueryException, CommunicationException)
 Return the guid to physical filename mappings which the PFNs corresponding to the given conditions, along with their attributes. More...

virtual void getMappingsWithAttributes (const std::string &SQLQuery, int resultLength, int resultStart, std::vector< Mapping > &mappings) const=0 throw (InvalidQueryException, CommunicationException)
 Return the guid to physical filename mappings which the PFNs corresponding to the given conditions, along with their attributes. More...

virtual void getMappingsByPfnAttribute (const std::string &attrName, const std::string &valuePattern, std::vector< GuidPfnPair_t > &mappings)=0 throw (NoSuchAttributeDefinitionException, CommunicationException)
 Return the guid to physical filename mappings which have a given attribute name=value pair. More...

virtual void getMappingsByPfnAttribute (const std::string &attrName, const std::string &valuePattern, int resultLength, std::vector< GuidPfnPair_t > &mappings)=0 throw (NoSuchAttributeDefinitionException, CommunicationException)
 Return the guid to physical filename mappings which have a given attribute name=value pair. More...

virtual void getMappingsByPfnAttribute (const std::string &attrName, const std::string &valuePattern, int resultLength, int resultStart, std::vector< GuidPfnPair_t > &mappings)=0 throw (NoSuchAttributeDefinitionException, CommunicationException)
 Return the guid to physical filename mappings which have a given attribute name=value pair. More...

virtual bool addRLISubscription (const std::string &lrcURL, const std::string &rliURL)=0 throw (CommunicationException)
 Add an RLI URL to the list of RLI subscribers. More...

virtual bool addRLISubscription (const std::string &rliURL)=0 throw ( CommunicationException)
 Add an RLI URL to the list of RLI subscribers. More...

virtual bool removeRLISubscription (const std::string &rliURL)=0 throw (CommunicationException)
 Remove a RLI URL from the list of RLI subscribers. More...

virtual void getRLISubscriptions (RliList_t &rlis) const=0 throw (CommunicationException)
 Return the list of RLIs that currently subscribe to this LRC. More...

virtual void forceRLIUpdate () const=0 throw (CommunicationException)
 Force a bloom filter update to all the RLI subscribers
Exceptions:
CommunicationException  in case of an unknown server error.
More...


virtual const std::string ping () const=0 throw (CommunicationException)
 Check if a server is alive. More...

virtual const std::string getVersion () const=0 throw (CommunicationException)
 Return RLS server version as std::string
Exceptions:
CommunicationException  in case of an unknown server error.
More...


virtual const std::string getInterfaceVersion () const=0 throw (CommunicationException)
 Return RLS server version as std::string
Exceptions:
CommunicationException  in case of an unknown server error.
More...


virtual const std::string getSchemaVersion () const=0 throw (CommunicationException)
 Return RLS server version as std::string
Exceptions:
CommunicationException  in case of an unknown server error.
More...



Constructor & Destructor Documentation

LocalReplicaCatalog const std::string &    url
 

create a new LocalReplicaCatalog.

virtual ~LocalReplicaCatalog   [virtual]
 

standard virtual destructor.


Member Function Documentation

virtual const std::string& getUrl   const [pure virtual]
 

get the URL this LocalReplicaCatalog resides at.

Returns:
the URL

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void addMapping const std::string &    guid,
const std::string &    pfn
throw (ValueTooLongException, PfnExistsException, CommunicationException) [pure virtual]
 

add a new mapping to the Catalog.

If there is already a mapping, we add this mapping to the set of mappings. If there are no mappings already, we create a new mapping.

Parameters:
guid  The guid
pfn  The physical filename
Exceptions:
ValueTooLongException  if the guid & pfn are longer then column size in the DB.
See also:
ColumnSizes and , getColumnSize( ColumnSizes & )
Exceptions:
PfnExistsException 
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void deleteMapping const std::string &    guid throw (CommunicationException) [pure virtual]
 

delete all parts of an guid to pfn mapping including attached attributes.

Parameters:
guid  The guid for which to delete the mapping
Exceptions:
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void removeMapping const std::string &    guid,
const std::string &    pfn
throw (CommunicationException) [pure virtual]
 

remove from the catalog a single guid to pfn mapping.

Parameters:
guid  the guid whose mapping we look at
pfn  the physical filename to remove
Exceptions:
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual bool guidExists const std::string &    guid const throw (CommunicationException) [pure virtual]
 

Do we have a given guid in the catalog?

Parameters:
guid  The guid we are checking for
Returns:
true if we have a mapping for the guid, false otherwise
Exceptions:
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual bool pfnExists const std::string &    pfn const throw (CommunicationException) [pure virtual]
 

Do we have a given physical filename in the catalog?

Parameters:
pfn  The physical filename we are checking for
Returns:
true if we have a mapping for the physical filename, false otherwise
Exceptions:
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void getPfns const std::string &    guid,
std::vector< std::string > &    output
const throw (NoSuchGuidException, CommunicationException) [pure virtual]
 

For a given guid, return all the physical filenames we map to in this Catalog.

This will always have at least one entry, and never be empty.

Parameters:
guid  The GUID
output  the vector in which to return the set of Physical FileNames
Exceptions:
NoSuchGuidException  If the guid does not exist in the catalog.
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual const std::string guidForPfn const std::string &    pfn const throw (NoSuchPfnException, CommunicationException) [pure virtual]
 

For a given pfn, return the guid that points to it.

The return value will never be null.

Parameters:
pfn  The physical filename.
Returns:
the guid that maps to it
Exceptions:
NoSuchPfnException  If the pfn does not exist in the catalog.
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void createAttributeDefinition const AttributeDefinition   attrDef throw (AttributeDefinitionExistsException, EmptyAttributeNameException, ValueTooLongException, CommunicationException) [pure virtual]
 

Create a new Attribute Definition in the Catalog.

Parameters:
attrDef  The new atttribute definition object
See also:
AttributeDefinition
Exceptions:
AttributeAlreadyExistsException  if an attribute with the given name already exists
ValueTooLongException  if the attrName is longer then column size in the DB.
See also:
ColumnSizes , getColumnSize( ColumnSizes & )
Exceptions:
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual AttributeDefinition getAttributeDefinition const std::string &    attrName const throw (NoSuchAttributeDefinitionException, CommunicationException) [pure virtual]
 

Get the AttributeDefinition corresponding to the attribute name.

Parameters:
attrName  the attribute name
Exceptions:
NoSuchAttributeDefinitionException  if an attribute with the given name doesn't exist

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void getAttributeDefinitions AttrDefs_t   attdefs const throw (CommunicationException) [pure virtual]
 

Retrieve the list of all available attribute definitions.

Parameters:
attdefs  the reference to a vector to be filled by the attribute definition names
Exceptions:
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void removeAttributeDefinition const std::string &    attrName throw (NoSuchAttributeDefinitionException, EmptyAttributeNameException, CommunicationException) [pure virtual]
 

Delete an Attribute Definition from the Catalog.

This will also remove any attribute value with this definition from GUID and Physical FileName entries in the Catalog.

Parameters:
attrName  the name of the attribute definition to remove
Exceptions:
NoSuchAttributeDefinitionException  if an attribute with the given name does not exist
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual bool attributeDefinitionExists const std::string &    attrName const throw (CommunicationException) [pure virtual]
 

do we have an attribute definition for a given attribute name?

Parameters:
attrName  the name of attribute to check for
Returns:
true if the attribute name is there.
Exceptions:
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void setPfnAttribute const std::string &    pfn,
const std::string &    attrName,
const std::string &    value
throw (NoSuchPfnException, NoSuchAttributeDefinitionException, ValueTooLongException, CommunicationException) [pure virtual]
 

Add an attribute value to a PFN.

Parameters:
pfn  The PFN
attrName  the name of attribute
value  The attribute value we'll add.
Exceptions:
NoSuchPfnException  if the PFN does not exist in the Catalog
NoSuchAttributeDefinitionException  if the definition of the attribute does not exist in the Catalog.
ValueTooLongException  if the attrName is longer then column size in the DB.
See also:
ColumnSizes and , getColumnSize( ColumnSizes & )
Exceptions:
CommunicationException  in case of an unknown server error DEPRECATED

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void setStringPfnAttribute const std::string &    pfnName,
const std::string &    attrDefnName,
const std::string &    attrValue
throw (NoSuchAttributeDefinitionException, NoSuchPfnException, UnappropriateAttributeTypeException, CommunicationException) [pure virtual]
 

Add an attribute value to a PFN attribute of type string.

Parameters:
pfnName  The PFN
attrDefnName  the name of attribute
attrValue  The attribute value we'll add.
Exceptions:
NoSuchPfnException  if the PFN does not exist in the Catalog
NoSuchAttributeDefinitionException  if the definition of the attribute does not exist in the Catalog.
UnappropriateAttributeTypeException  if the attribute is not of type string

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void setIntPfnAttribute const std::string &    pfnName,
const std::string &    attrDefnName,
int    attrValue
throw (NoSuchAttributeDefinitionException, NoSuchPfnException, UnappropriateAttributeTypeException, CommunicationException) [pure virtual]
 

Add an attribute value to a PFN attribute of type int.

Parameters:
pfnName  The PFN
attrDefnName  the name of attribute
attrValue  The attribute value we'll add.
Exceptions:
NoSuchPfnException  if the PFN does not exist in the Catalog
NoSuchAttributeDefinitionException  if the definition of the attribute does not exist in the Catalog.
UnappropriateAttributeTypeException  if the attribute is not of type int

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void setFloatPfnAttribute const std::string &    pfnName,
const std::string    attrDefnName,
float    attrValue
throw (NoSuchAttributeDefinitionException, NoSuchPfnException, UnappropriateAttributeTypeException, CommunicationException) [pure virtual]
 

Add an attribute value to a PFN attribute of type float.

Parameters:
pfnName  The PFN
attrDefnName  the name of attribute
attrValue  The attribute value we'll add.
Exceptions:
NoSuchPfnException  if the PFN does not exist in the Catalog
NoSuchAttributeDefinitionException  if the definition of the attribute does not exist in the Catalog.
UnappropriateAttributeTypeException  if the attribute is not of type float

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual std::string getStringPfnAttribute const std::string &    pfnName,
const std::string &    attrDefnName
throw (NoSuchPfnException, NoSuchAttributeDefinitionException, UnappropriateAttributeTypeException, CommunicationException) [pure virtual]
 

return the value of a given string attribute for a PFN.

Parameters:
pfnName  the PFN
attrDefnName  the AttributeDefinition name to check for
Returns:
the attribute value
Exceptions:
NoSuchPfnException  if the PFN does not exist in the Catalog
NoSuchAttributeDefinitionException  if the AttributeDefintion does not exist in the catalog.

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual int getIntPfnAttribute const std::string &    pfnName,
const std::string &    attrDefnName
throw (NoSuchPfnException, NoSuchAttributeDefinitionException, UnappropriateAttributeTypeException, CommunicationException) [pure virtual]
 

return the value of a given int attribute for an PFN.

Parameters:
pfnName  the PFN
attrDefnName  the AttributeDefinition name to check for
Returns:
the attribute value
Exceptions:
NoSuchPfnException  if the PFN does not exist in the Catalog
NoSuchAttributeDefinitionException  if the AttributeDefintion does not exist in the catalog.

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual float getFloatPfnAttribute const std::string &    pfnName,
const std::string &    attrDefnName
throw (NoSuchPfnException, NoSuchAttributeDefinitionException, UnappropriateAttributeTypeException, CommunicationException) [pure virtual]
 

return the value of a given float attribute for an PFN.

Parameters:
pfnName  the PFN
attrDefnName  the AttributeDefinition name to check for
Returns:
the attribute value
Exceptions:
NoSuchPfnException  if the PFN does not exist in the Catalog
NoSuchAttributeDefinitionException  if the AttributeDefintion does not exist in the catalog.

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void removePfnAttribute const std::string &    pfn,
const std::string &    attrName
throw (NoSuchPfnException, NoSuchAttributeDefinitionException, NoSuchAttributeException, CommunicationException) [pure virtual]
 

remove the value of a given attribute for an PFN.

Parameters:
pfn  the PFN
attrName  the AttributeDefinition name to check for
Exceptions:
NoSuchPfnException  if the PFN does not exist in the Catalog
NoSuchAttributeDefinitionException  if the AttributeDefintion does not exist in the catalog.
NoSuchAttributeException  if there is no such attribute for the given PFN
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void setDefaultResultLength int    resultLength throw (CommunicationException) [pure virtual]
 

Set the number of mappings that will be displayed by default.

(for the getMappingsByGuid and getMappingsByPfn methods)..

Parameters:
resultLength  the number of mappings that will be displayed by default
Exceptions:
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual int getDefaultResultLength   const throw (CommunicationException) [pure virtual]
 

Return the number of mappings that will be displayed by default.

(for the getMappingsByGuid and getMappingsByPfn methods).

Returns:
the number of mappings displayed by default.
Exceptions:
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void getColumnSizes ColumnSizes   const throw (CommunicationException) [pure virtual]
 

Return the maximum number of characters for a GUID, a PFN and an attribute.

(according to the schema : if GUID has been defined as VARCHAR(250), then the GUID cannot have more than 250 characters. So 250 will be returned.)

Returns:
the object containing the Column sizes for Attr. def., GUID, PFN
Exceptions:
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void getMappingsWithAttributes const std::vector< std::string > &    guids,
std::vector< Mapping > &    mappings
const throw (CommunicationException) [pure virtual]
 

Return the mappings for a list of guids.

If some of the guids do not exist, this is not a problem. If there are no results, an empty array is returned

Parameters:
guids  the list of guids, which may be empty, but may not be null
mappings  pointer to a vector of Mapping objects to return the results in

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void setMappingsWithAttributes const std::vector< Mapping > &    mappings const throw (CommunicationException, NoSuchAttributeDefinitionException, UnappropriateAttributeTypeException, PfnExistsException) [pure virtual]
 

Add a set of guid to pfn mappings, with optional pfn attributes to the database.

If any problem occurs when inserting entries or attributes (pfn already exists, inserting an attribute value for an attribute which doesn't exist, inserting the wrong type of attribute value) the entire transaction is rolled back, and a fault thrown

Parameters:
mappings  a vector of mappings

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void getMappingsByGuid const std::string &    guidPattern,
std::vector< GuidPfnPair_t > &    mappings
const throw (CommunicationException) [pure virtual]
 

Return the guid to physical filename mappings which contain a guid that matches the given guidPattern.

We assume unix regexp semantics. The result will be an empty set if no mapppings are found.

Parameters:
guidPattern  The GUID pattern we are searching for
mappings  pointer to a vector of GuidPfnPair_t to return the results in
Exceptions:
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void getMappingsByGuid const std::string &    guidPattern,
int    resultLength,
std::vector< GuidPfnPair_t > &    mappings
const throw (CommunicationException) [pure virtual]
 

Return the guid to physical filename mappings which contain a guid that matches the given guidPattern.

Return only the first mappings (no more than the resultLength parameter). We assume unix regexp semantics. The result will be an empty set if no mapppings are found.

Parameters:
guidPattern  The GUID pattern we are searching for
resultLength  The number of of mappings that will be displayed
mappings  pointer to a vector of GuidPfnPair_t to return the results in
Exceptions:
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void getMappingsByGuid const std::string &    guidPattern,
int    resultLength,
int    resultStart,
std::vector< GuidPfnPair_t > &    mappings
const throw (CommunicationException) [pure virtual]
 

Return the guid to physical filename mappings which contain a guid that matches the given guidPattern.

Return only a certain number of mappings. Return We assume unix regexp semantics. The result will be an empty set if no mapppings are found.

Parameters:
guidPattern  The GUID pattern we are searching for
resultLength  The number of of mappings that will be displayed
resultStart  The rank of the first mapping that will be displayed
mappings  pointer to a vector of GuidPfnPair_t to return the results in
Exceptions:
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void getMappingsByPfn const std::string &    pfnPattern,
std::vector< GuidPfnPair_t > &    mappings
const throw (CommunicationException) [pure virtual]
 

Return the guid to physical filename mappings which contain a physical filename that matches the given pfnPattern.

We assume unix regexp semantics. The result will be an empty set if no mapppings are found.

Parameters:
pfnPattern  The Physical FileName pattern we are searching for
mappings  pointer to a vector of GuidPfnPair_t to return the results in
Exceptions:
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void getMappingsByPfn const std::string &    pfnPattern,
int    resultLength,
std::vector< GuidPfnPair_t > &    mappings
const throw (CommunicationException) [pure virtual]
 

Return the guid to physical filename mappings which contain a pfn that matches the given pfnPattern.

Return only the first mappings (no more than the resultLength parameter). We assume unix regexp semantics. The result will be an empty set if no mapppings are found.

Parameters:
pfnPattern  The PFN pattern we are searching for
resultLength  The number of of mappings that will be displayed
mappings  pointer to a vector of GuidPfnPair_t to return the results in
Exceptions:
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void getMappingsByPfn const std::string &    pfnPattern,
int    resultLength,
int    resultStart,
std::vector< GuidPfnPair_t > &    mappings
const throw (CommunicationException) [pure virtual]
 

Return the guid to physical filename mappings which contain a pfn that matches the given pfnPattern.

Return only a certain number of mappings. We assume unix regexp semantics. The result will be an empty set if no mapppings are found.

Parameters:
pfnPattern  The PFN pattern we are searching for
resultLength  The number of of mappings that will be displayed
resultStart  The rank of the first mapping that will be displayed
mappings  pointer to a vector of GuidPfnPair_t to return the results in
Exceptions:
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void getMappingsByAttribute const std::string &    SQLQuery,
int    resultLength,
std::vector< GuidPfnPair_t > &    mappings
const throw (InvalidQueryException, CommunicationException) [pure virtual]
 

Return the guid to physical filename mappings which contain the PFNs corresponding to the given attributes conditions.

Return only the first mappings (no more than the resultLength parameter). We assume unix regexp semantics. The result will be an empty set if no mapppings are found.

Parameters:
SQLQuery  The attributes conditions
resultLength  The number of of mappings that will be displayed
mappings  The mappings to be filled into

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void getMappingsByAttribute const std::string &    SQLQuery,
int    resultLength,
int    resultStart,
std::vector< GuidPfnPair_t > &    mappings
const throw (InvalidQueryException, CommunicationException) [pure virtual]
 

Return the guid to physical filename mappings which the PFNs corresponding to the given attributes conditions.

Return only a certain number of mappings. Return We assume unix regexp semantics. The result will be an empty set if no mapppings are found.

Parameters:
SQLQuery  The attributes conditions
resultLength  The number of of mappings that will be displayed
resultStart  The rank of the first mapping that will be displayed
mappings  The mappings to be filled into

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void getMappingsWithAttributes const std::string &    SQLQuery,
int    resultLength,
std::vector< Mapping > &    mappings
const throw (InvalidQueryException, CommunicationException) [pure virtual]
 

Return the guid to physical filename mappings which the PFNs corresponding to the given conditions, along with their attributes.

Return only a certain number of mappings. We assume unix regexp semantics. The result will be an empty set if no mapppings are found.

Parameters:
SQLQuery  The attributes conditions
resultLength  The number of of mappings that will be displayed
mappings  The mappings to be filled into

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void getMappingsWithAttributes const std::string &    SQLQuery,
int    resultLength,
int    resultStart,
std::vector< Mapping > &    mappings
const throw (InvalidQueryException, CommunicationException) [pure virtual]
 

Return the guid to physical filename mappings which the PFNs corresponding to the given conditions, along with their attributes.

Return only a certain number of mappings. We assume unix regexp semantics. The result will be an empty set if no mapppings are found.

Parameters:
SQLQuery  The attributes conditions
resultLength  The number of of mappings that will be displayed
resultStart  The rank of the first mapping that will be displayed
mappings  The mappings to be filled into

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void getMappingsByPfnAttribute const std::string &    attrName,
const std::string &    valuePattern,
std::vector< GuidPfnPair_t > &    mappings
throw (NoSuchAttributeDefinitionException, CommunicationException) [pure virtual]
 

Return the guid to physical filename mappings which have a given attribute name=value pair.

The result will be an empty if no mapppings are found. We assume unix regexp semantics for valuePattern.

Parameters:
attrName  the name of the attribute
valuePattern  the value of attribute to search for
mappings  pointer to a vector of GuidPfnPair_t to return the results in
Exceptions:
CommunicationException  in case of an unknown server error DEPRECATED

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void getMappingsByPfnAttribute const std::string &    attrName,
const std::string &    valuePattern,
int    resultLength,
std::vector< GuidPfnPair_t > &    mappings
throw (NoSuchAttributeDefinitionException, CommunicationException) [pure virtual]
 

Return the guid to physical filename mappings which have a given attribute name=value pair.

The result will be an empty if no mapppings are found. We assume unix regexp semantics for valuePattern.

Parameters:
attrName  the name of the attribute
valuePattern  the value of attribute to search for
resultLength  The number of of mappings that will be displayed
mappings  pointer to a vector of GuidPfnPair_t to return the results in
Exceptions:
CommunicationException  in case of an unknown server error DEPRECATED

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void getMappingsByPfnAttribute const std::string &    attrName,
const std::string &    valuePattern,
int    resultLength,
int    resultStart,
std::vector< GuidPfnPair_t > &    mappings
throw (NoSuchAttributeDefinitionException, CommunicationException) [pure virtual]
 

Return the guid to physical filename mappings which have a given attribute name=value pair.

The result will be an empty if no mapppings are found. We assume unix regexp semantics for valuePattern.

Parameters:
attrName  the name of the attribute
valuePattern  the value of attribute to search for
resultLength  The number of of mappings that will be displayed
resultStart  The rank of the first mapping that will be displayed
mappings  pointer to a vector of GuidPfnPair_t to return the results in
Exceptions:
CommunicationException  in case of an unknown server error DEPRECATED

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual bool addRLISubscription const std::string &    lrcURL,
const std::string &    rliURL
throw (CommunicationException) [pure virtual]
 

Add an RLI URL to the list of RLI subscribers.

The lrc URL is also passed so that the LRC servlet knows its own URL

Parameters:
lrcURL  The URL for the LRC servlet
rliURL  The URL for the RLI subscriber
Exceptions:
CommunicationException  in case of an unknown server error DEPRECATED

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual bool addRLISubscription const std::string &    rliURL throw ( CommunicationException) [pure virtual]
 

Add an RLI URL to the list of RLI subscribers.

Parameters:
rliURL  The URL for the RLI subscriber

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual bool removeRLISubscription const std::string &    rliURL throw (CommunicationException) [pure virtual]
 

Remove a RLI URL from the list of RLI subscribers.

Parameters:
rliURL  The URL for the RLI subscriber
Exceptions:
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void getRLISubscriptions RliList_t   rlis const throw (CommunicationException) [pure virtual]
 

Return the list of RLIs that currently subscribe to this LRC.

Parameters:
rlis  variable where the current list of RLIs is returned
Exceptions:
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual void forceRLIUpdate   const throw (CommunicationException) [pure virtual]
 

Force a bloom filter update to all the RLI subscribers

Exceptions:
CommunicationException  in case of an unknown server error.

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual const std::string ping   const throw (CommunicationException) [pure virtual]
 

Check if a server is alive.

It returns a stats string. If everything is ok, this will start with OK else it will start with FAIL.

Returns:
the stats string
Exceptions:
CommunicationException  in case of an unknown server error

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual const std::string getVersion   const throw (CommunicationException) [pure virtual]
 

Return RLS server version as std::string

Exceptions:
CommunicationException  in case of an unknown server error.

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual const std::string getInterfaceVersion   const throw (CommunicationException) [pure virtual]
 

Return RLS server version as std::string

Exceptions:
CommunicationException  in case of an unknown server error.

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

virtual const std::string getSchemaVersion   const throw (CommunicationException) [pure virtual]
 

Return RLS server version as std::string

Exceptions:
CommunicationException  in case of an unknown server error.

Implemented in EdgReplicaLocationService::RemoteLocalReplicaCatalog.

The EU DataGrid Project. All rights reserved.