bes  Updated for version 3.20.6
BESContainerStorageList.h
1 // BESContainerStorageList.h
2 
3 // This file is part of bes, A C++ back-end server implementation framework
4 // for the OPeNDAP Data Access Protocol.
5 
6 // Copyright (c) 2004-2009 University Corporation for Atmospheric Research
7 // Author: Patrick West <pwest@ucar.edu> and Jose Garcia <jgarcia@ucar.edu>
8 //
9 // This library is free software; you can redistribute it and/or
10 // modify it under the terms of the GNU Lesser General Public
11 // License as published by the Free Software Foundation; either
12 // version 2.1 of the License, or (at your option) any later version.
13 //
14 // This library is distributed in the hope that it will be useful,
15 // but WITHOUT ANY WARRANTY; without even the implied warranty of
16 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 // Lesser General Public License for more details.
18 //
19 // You should have received a copy of the GNU Lesser General Public
20 // License along with this library; if not, write to the Free Software
21 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22 //
23 // You can contact University Corporation for Atmospheric Research at
24 // 3080 Center Green Drive, Boulder, CO 80301
25 
26 // (c) COPYRIGHT University Corporation for Atmospheric Research 2004-2005
27 // Please read the full copyright statement in the file COPYRIGHT_UCAR.
28 //
29 // Authors:
30 // pwest Patrick West <pwest@ucar.edu>
31 // jgarcia Jose Garcia <jgarcia@ucar.edu>
32 
33 #ifndef I_BESContainerStorageList_H
34 #define I_BESContainerStorageList_H 1
35 
36 #include <string>
37 
38 #include "BESObj.h"
39 
41 class BESContainer;
42 class BESInfo;
43 
44 #ifndef DEFAULT
45 #define DEFAULT "default"
46 #endif
47 
48 #ifndef CATALOG
49 #define CATALOG "catalog"
50 #endif
51 
72 private:
73  static BESContainerStorageList * _instance;
74 
75  typedef struct _persistence_list {
76  BESContainerStorage *_persistence_obj;
77  unsigned int _reference;
78  BESContainerStorageList::_persistence_list *_next;
79  } persistence_list;
80 
81  BESContainerStorageList::persistence_list *_first;
82 
83 protected:
85 public:
86  virtual ~BESContainerStorageList();
87 
88  virtual bool add_persistence(BESContainerStorage *p);
89  virtual bool ref_persistence(const std::string &persist_name);
90  virtual bool deref_persistence(const std::string &persist_name);
91  virtual BESContainerStorage *find_persistence(const std::string &persist_name);
92  virtual bool isnice();
93 
94  // These methods scan all of the container stores. Currently, this is used
95  // by both <setContainer> and <define>. However, a better design would disentangle
96  // the ContainerStorage from the Container creation. jhrg 1/8/19
97  virtual BESContainer *look_for(const std::string &sym_name);
98  virtual void delete_container(const std::string &sym_name);
99 
100  virtual void show_containers(BESInfo &info);
101 
102  virtual void dump(std::ostream &strm) const;
103 
104  static BESContainerStorageList *TheList();
105 };
106 
107 #endif // I_BESContainerStorageList_H
108 
BESContainerStorageList::show_containers
virtual void show_containers(BESInfo &info)
show information for each container in each persistence store
Definition: BESContainerStorageList.cc:341
BESContainerStorageList::deref_persistence
virtual bool deref_persistence(const std::string &persist_name)
dereference a persistent store in the list.
Definition: BESContainerStorageList.cc:163
BESContainerStorageList::look_for
virtual BESContainer * look_for(const std::string &sym_name)
look for the specified container information in the list of persistent stores.
Definition: BESContainerStorageList.cc:272
BESContainerStorage
provides persistent storage for data storage information represented by a container.
Definition: BESContainerStorage.h:67
BESContainerStorageList::dump
virtual void dump(std::ostream &strm) const
dumps information about this object
Definition: BESContainerStorageList.cc:361
BESInfo
informational response object
Definition: BESInfo.h:63
BESContainerStorageList::add_persistence
virtual bool add_persistence(BESContainerStorage *p)
Add a persistent store to the list.
Definition: BESContainerStorageList.cc:81
BESContainerStorageList::find_persistence
virtual BESContainerStorage * find_persistence(const std::string &persist_name)
find the persistence store with the given name
Definition: BESContainerStorageList.cc:212
BESObj
top level BES object to house generic methods
Definition: BESObj.h:49
BESContainerStorageList::delete_container
virtual void delete_container(const std::string &sym_name)
scan all of the container stores and remove any containers called
Definition: BESContainerStorageList.cc:319
BESContainer
A container is something that holds data. E.G., a netcdf file or a database entry.
Definition: BESContainer.h:65
BESContainerStorageList
Provides a mechanism for accessing container information from different container stores registered w...
Definition: BESContainerStorageList.h:71
BESContainerStorageList::ref_persistence
virtual bool ref_persistence(const std::string &persist_name)
refence the specified persistent store if in the list
Definition: BESContainerStorageList.cc:127