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

EdgReplicaLocationService::RemoteLocalReplicaCatalog Class Reference

Inheritance diagram for EdgReplicaLocationService::RemoteLocalReplicaCatalog:

EdgReplicaLocationService::LocalReplicaCatalog List of all members.

Public Methods

 RemoteLocalReplicaCatalog (const std::string &url, int timeOut=30)
virtual ~RemoteLocalReplicaCatalog ()
 standard virtual destructor. More...

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

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

virtual void deleteMapping (const std::string &guid) 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) throw (CommunicationException)
 remove from the catalog a single guid to pfn mapping. More...

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

virtual bool pfnExists (const std::string &pfn) const 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 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 throw (NoSuchPfnException, CommunicationException)
 For a given pfn, return the guid that points to it. More...

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

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

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

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

virtual bool attributeDefinitionExists (const std::string &attrName) const 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) 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) 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) 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) throw (NoSuchAttributeDefinitionException, NoSuchPfnException, UnappropriateAttributeTypeException, CommunicationException)
 Add an attribute value to a PFN attribute of type float. More...

virtual const std::string getPfnAttribute (const std::string &pfn, const std::string &attrName) const throw (NoSuchPfnException, NoSuchAttributeDefinitionException, CommunicationException)
 return the value of a given attribute for an PFN. More...

virtual std::string getStringPfnAttribute (const std::string &pfnName, const std::string &attrDefnName) 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) 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) 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) throw (NoSuchPfnException, NoSuchAttributeDefinitionException, NoSuchAttributeException, CommunicationException)
 remove the value of a given attribute for an PFN. More...

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

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

virtual void getColumnSizes (ColumnSizes &cs) const 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 throw (CommunicationException)
 Return the mappings for a list of guids. More...

virtual void setMappingsWithAttributes (const std::vector< Mapping > &mappings) const 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 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 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 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 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 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 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 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 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 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 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) 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) 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) 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) throw (CommunicationException)
 Add an RLI URL to the list of RLI subscribers. More...

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

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

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

virtual void forceRLIUpdate () const 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 throw (CommunicationException)
 Check if a server is alive. More...

virtual const std::string getVersion () const 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 throw (CommunicationException)
 Return RLS server interface version as std::string
Exceptions:
CommunicationException  in case of an unknown server error.
More...


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



Detailed Description

Author:
James Casey , Radovan Chytracek
Version:
Id:
RemoteLocalReplicaCatalog.h,v 1.49 2004/05/05 08:55:22 jamesc Exp


Constructor & Destructor Documentation

RemoteLocalReplicaCatalog const std::string &    url,
int    timeOut = 30
 

~RemoteLocalReplicaCatalog   [virtual]
 

standard virtual destructor.


Member Function Documentation

const std::string & getUrl   const [virtual]
 

get the URL this LocalReplicaCatalog resides at.

Returns:
the URL

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void addMapping const std::string &    guid,
const std::string &    pfn
throw (ValueTooLongException, PfnExistsException, CommunicationException) [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:
CommunicationException  in case of an unknown server error

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void deleteMapping const std::string &    guid throw (CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void removeMapping const std::string &    guid,
const std::string &    pfn
throw (CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

bool guidExists const std::string &    guid const throw (CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

bool pfnExists const std::string &    pfn const throw (CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void getPfns const std::string &    guid,
std::vector< std::string > &    output
const throw (NoSuchGuidException, CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

const std::string guidForPfn const std::string &    pfn const throw (NoSuchPfnException, CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void createAttributeDefinition const AttributeDefinition   attrDef throw (AttributeDefinitionExistsException, EmptyAttributeNameException, ValueTooLongException, CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

AttributeDefinition getAttributeDefinition const std::string &    attrName const throw (NoSuchAttributeDefinitionException, CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

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

Retrieve the list of all availabel 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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void removeAttributeDefinition const std::string &    attrName throw (NoSuchAttributeDefinitionException, EmptyAttributeNameException, CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

bool attributeDefinitionExists const std::string &    attrName const throw (CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void setPfnAttribute const std::string &    pfn,
const std::string &    attrName,
const std::string &    value
throw (NoSuchPfnException, NoSuchAttributeDefinitionException, ValueTooLongException, CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void setStringPfnAttribute const std::string &    pfnName,
const std::string &    attrDefnName,
const std::string &    attrValue
throw (NoSuchAttributeDefinitionException, NoSuchPfnException, UnappropriateAttributeTypeException, CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void setIntPfnAttribute const std::string &    pfnName,
const std::string &    attrDefnName,
int    attrValue
throw (NoSuchAttributeDefinitionException, NoSuchPfnException, UnappropriateAttributeTypeException, CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void setFloatPfnAttribute const std::string &    pfnName,
const std::string    attrDefnName,
float    attrValue
throw (NoSuchAttributeDefinitionException, NoSuchPfnException, UnappropriateAttributeTypeException, CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

const std::string getPfnAttribute const std::string &    pfn,
const std::string &    attrName
const throw (NoSuchPfnException, NoSuchAttributeDefinitionException, CommunicationException) [virtual]
 

return the value of a given attribute for an PFN.

Parameters:
pfn  the PFN
attrName  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.
CommunicationException  in case of an unknown server error DEPRECATED

std::string getStringPfnAttribute const std::string &    pfnName,
const std::string &    attrDefnName
throw (NoSuchPfnException, NoSuchAttributeDefinitionException, UnappropriateAttributeTypeException, CommunicationException) [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.

Implements EdgReplicaLocationService::LocalReplicaCatalog.

int getIntPfnAttribute const std::string &    pfnName,
const std::string &    attrDefnName
throw (NoSuchPfnException, NoSuchAttributeDefinitionException, UnappropriateAttributeTypeException, CommunicationException) [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.

Implements EdgReplicaLocationService::LocalReplicaCatalog.

float getFloatPfnAttribute const std::string &    pfnName,
const std::string &    attrDefnName
throw (NoSuchPfnException, NoSuchAttributeDefinitionException, UnappropriateAttributeTypeException, CommunicationException) [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.

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void removePfnAttribute const std::string &    pfn,
const std::string &    attrName
throw (NoSuchPfnException, NoSuchAttributeDefinitionException, NoSuchAttributeException, CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void setDefaultResultLength int    resultLength throw (CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

int getDefaultResultLength   const throw (CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void getColumnSizes ColumnSizes   cs const throw (CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void getMappingsWithAttributes const std::vector< std::string > &    guids,
std::vector< Mapping > &    mappings
const throw (CommunicationException) [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 GuidPfnPair_t to return the results in

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void setMappingsWithAttributes const std::vector< Mapping > &    mappings const throw (CommunicationException, NoSuchAttributeDefinitionException, UnappropriateAttributeTypeException, PfnExistsException) [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 GuidPfnPair_t

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void getMappingsByGuid const std::string &    guidPattern,
std::vector< GuidPfnPair_t > &    mappings
const throw (CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void getMappingsByGuid const std::string &    guidPattern,
int    resultLength,
std::vector< GuidPfnPair_t > &    mappings
const throw (CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void getMappingsByGuid const std::string &    guidPattern,
int    resultLength,
int    resultStart,
std::vector< GuidPfnPair_t > &    mappings
const throw (CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void getMappingsByPfn const std::string &    pfnPattern,
std::vector< GuidPfnPair_t > &    mappings
const throw (CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void getMappingsByPfn const std::string &    pfnPattern,
int    resultLength,
std::vector< GuidPfnPair_t > &    mappings
const throw (CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

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

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

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:
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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void getMappingsByAttribute const std::string &    SQLQuery,
int    resultLength,
std::vector< GuidPfnPair_t > &    mappings
const throw (InvalidQueryException, CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void getMappingsByAttribute const std::string &    SQLQuery,
int    resultLength,
int    resultStart,
std::vector< GuidPfnPair_t > &    mappings
const throw (InvalidQueryException, CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void getMappingsWithAttributes const std::string &    SQLQuery,
int    resultLength,
std::vector< Mapping > &    mappings
const throw (InvalidQueryException, CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void getMappingsWithAttributes const std::string &    SQLQuery,
int    resultLength,
int    resultStart,
std::vector< Mapping > &    mappings
const throw (InvalidQueryException, CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void getMappingsByPfnAttribute const std::string &    attrName,
const std::string &    valuePattern,
std::vector< GuidPfnPair_t > &    mappings
throw (NoSuchAttributeDefinitionException, CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void getMappingsByPfnAttribute const std::string &    attrName,
const std::string &    valuePattern,
int    resultLength,
std::vector< GuidPfnPair_t > &    mappings
throw (NoSuchAttributeDefinitionException, CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void getMappingsByPfnAttribute const std::string &    attrName,
const std::string &    valuePattern,
int    resultLength,
int    resultStart,
std::vector< GuidPfnPair_t > &    mappings
throw (NoSuchAttributeDefinitionException, CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

bool addRLISubscription const std::string &    lrcURL,
const std::string &    rliURL
throw (CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

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

Add an RLI URL to the list of RLI subscribers.

Parameters:
rliURL  The URL for the RLI subscriber

Implements EdgReplicaLocationService::LocalReplicaCatalog.

bool removeRLISubscription const std::string &    rliURL throw (CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void getRLISubscriptions RliList_t   rlis const throw (CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

void forceRLIUpdate   const throw (CommunicationException) [virtual]
 

Force a bloom filter update to all the RLI subscribers

Exceptions:
CommunicationException  in case of an unknown server error.

Implements EdgReplicaLocationService::LocalReplicaCatalog.

const std::string ping   const throw (CommunicationException) [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

Implements EdgReplicaLocationService::LocalReplicaCatalog.

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

Return RLS server version as std::string

Exceptions:
CommunicationException  in case of an unknown server error.

Implements EdgReplicaLocationService::LocalReplicaCatalog.

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

Return RLS server interface version as std::string

Exceptions:
CommunicationException  in case of an unknown server error.

Implements EdgReplicaLocationService::LocalReplicaCatalog.

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

Return RLS server schema version as std::string

Exceptions:
CommunicationException  in case of an unknown server error.

Implements EdgReplicaLocationService::LocalReplicaCatalog.

The EU DataGrid Project. All rights reserved.