bes Updated for version 3.20.13
|
Provides a mechanism for accessing container information from different container stores registered with this server. More...
#include <BESContainerStorageList.h>
Public Member Functions | |
virtual bool | add_persistence (BESContainerStorage *p) |
Add a persistent store to the list. | |
virtual void | delete_container (const std::string &sym_name) |
scan all of the container stores and remove any containers called | |
virtual bool | deref_persistence (const std::string &persist_name) |
dereference a persistent store in the list. | |
virtual void | dump (std::ostream &strm) const |
dumps information about this object | |
virtual BESContainerStorage * | find_persistence (const std::string &persist_name) |
find the persistence store with the given name | |
virtual bool | isnice () |
virtual BESContainer * | look_for (const std::string &sym_name) |
look for the specified container information in the list of persistent stores. | |
virtual bool | ref_persistence (const std::string &persist_name) |
refence the specified persistent store if in the list | |
virtual void | show_containers (BESInfo &info) |
show information for each container in each persistence store | |
Static Public Member Functions | |
static BESContainerStorageList * | TheList () |
Provides a mechanism for accessing container information from different container stores registered with this server.
This class provides a mechanism for users to access container information from different container stores, such as from a MySQL database, a file, or volatile stores.
Users can add different BESContainerStorage instances to this persistent list. Then, when a user looks for a symbolic name, that search goes through the list of persistent stores in order.
If the symbolic name is not found then a flag is checked to determine whether to simply log the fact that the symbolic name was not found, or to throw an exception of type BESContainerStorageException.
Definition at line 72 of file BESContainerStorageList.h.
BESContainerStorageList::BESContainerStorageList | ( | ) |
Definition at line 55 of file BESContainerStorageList.cc.
|
virtual |
Definition at line 60 of file BESContainerStorageList.cc.
|
virtual |
Add a persistent store to the list.
Each persistent store has a name. If a persistent store already exists in the list with that name then the persistent store is not added. Otherwise the store is added to the list.
The persistent stores are searched in the order in which they were added.
cp | persistent store to add to the list |
Definition at line 85 of file BESContainerStorageList.cc.
|
virtual |
scan all of the container stores and remove any containers called
Scan all of the Container Storage objects and looking for containers called
sym_name | The name of the container(s) to delete. |
Definition at line 333 of file BESContainerStorageList.cc.
|
virtual |
dereference a persistent store in the list.
de-reference the names persistent store. If found, the reference on the catalog is decremented and true is returned. If the reference reaches zero then the catalog is removed. If not found then false is returned.
persist_name | name of the persistent store to be de-referenced |
Definition at line 171 of file BESContainerStorageList.cc.
|
virtual |
dumps information about this object
Displays the pointer value of this instance along with information about the container storage objects stored in this list.
strm | C++ i/o stream to dump the information to |
Implements BESObj.
Definition at line 379 of file BESContainerStorageList.cc.
|
virtual |
find the persistence store with the given name
Returns the persistence store with the given name
persist_name | name of the persistent store to be found |
Definition at line 222 of file BESContainerStorageList.cc.
|
virtual |
Definition at line 246 of file BESContainerStorageList.cc.
|
virtual |
look for the specified container information in the list of persistent stores.
Look for the container with the specified symbolic name in the BESContainerStorage instances. The first to find it wins.
If the container information is not found then, depending on the value of the key BES.Container.Persistence in the bes configuration file, an exception is thrown or it is logged to the bes log file that it was not found. If the key is set to Nice, nice, or NICE then information is logged to the bes log file stating that the container information was not found.
sym_name | symbolic name of the container to look for |
BESSyntaxUserError | if container not found and strict set in the bes configuration file for BES.Container.Persistence |
Definition at line 286 of file BESContainerStorageList.cc.
|
virtual |
refence the specified persistent store if in the list
Increments the reference count of the persistent store in the list. This lets the system know that there is a module that is referencing the specified catalog
persist_name | name of the persistent store to be referenced |
Definition at line 133 of file BESContainerStorageList.cc.
|
virtual |
show information for each container in each persistence store
For each container in each persistent store, add infomation about each of those containers. The information added to the information object includes the persistent store information, in the order the persistent stores are searched for a container, followed by a line for each container within that persistent store which includes the symbolic name, the real name, and the data type, separated by commas.
info | object to store the container and persistent store information |
Definition at line 357 of file BESContainerStorageList.cc.
|
static |
Definition at line 402 of file BESContainerStorageList.cc.