ome-xml  5.6.0
OMEModel.h
1 /*
2  * #%L
3  * OME-XML C++ library for working with OME-XML metadata structures.
4  * %%
5  * Copyright © 2006 - 2016 Open Microscopy Environment:
6  * - Massachusetts Institute of Technology
7  * - National Institutes of Health
8  * - University of Dundee
9  * - Board of Regents of the University of Wisconsin-Madison
10  * - Glencoe Software, Inc.
11  * %%
12  * Redistribution and use in source and binary forms, with or without
13  * modification, are permitted provided that the following conditions are met:
14  *
15  * 1. Redistributions of source code must retain the above copyright notice,
16  * this list of conditions and the following disclaimer.
17  * 2. Redistributions in binary form must reproduce the above copyright notice,
18  * this list of conditions and the following disclaimer in the documentation
19  * and/or other materials provided with the distribution.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
22  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
25  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31  * POSSIBILITY OF SUCH DAMAGE.
32  *
33  * The views and conclusions contained in the software and documentation are
34  * those of the authors and should not be interpreted as representing official
35  * policies, either expressed or implied, of any organization.
36  * #L%
37  */
38 
39 #ifndef OME_XML_MODEL_OMEMODEL_H
40 #define OME_XML_MODEL_OMEMODEL_H
41 
42 #include <map>
43 #include <memory>
44 #include <string>
45 #include <vector>
46 
47 #include <ome/xml/model/OMEModelObject.h>
48 
49 namespace ome
50 {
51  namespace xml
52  {
53  namespace model
54  {
55 
56  class Reference;
57 
61  class OMEModel
62  {
63  public:
65  typedef std::vector<std::shared_ptr<Reference>> reference_list_type;
67  typedef std::map<std::string, std::shared_ptr<OMEModelObject>> object_map_type;
69  typedef std::map<std::shared_ptr<OMEModelObject>, reference_list_type> reference_map_type;
71  typedef reference_map_type::size_type size_type;
72 
73  protected:
76  {}
77 
78  public:
80  virtual
82  {}
83 
85  OMEModel (const OMEModel&) = delete;
86 
87  OMEModel&
88  operator= (const OMEModel&) = delete;
90 
104  virtual
105  std::shared_ptr<OMEModelObject>
106  addModelObject (const std::string& id,
107  std::shared_ptr<OMEModelObject>& object) = 0;
108 
117  virtual
118  std::shared_ptr<OMEModelObject>
119  removeModelObject (const std::string& id) = 0;
120 
131  virtual
132  std::shared_ptr<OMEModelObject>
133  getModelObject (const std::string& id) const = 0;
134 
140  virtual
141  const object_map_type&
142  getModelObjects () const = 0;
143 
159  virtual
160  bool
161  addReference (std::shared_ptr<OMEModelObject>& a,
162  std::shared_ptr<Reference>& b) = 0;
163 
169  virtual
170  const reference_map_type&
171  getReferences () const = 0;
172 
183  virtual
184  size_type
185  resolveReferences () = 0;
186 
187  };
188 
189  }
190  }
191 }
192 
193 #endif // OME_XML_MODEL_OMEMODEL_H
194 
195 /*
196  * Local Variables:
197  * mode:C++
198  * End:
199  */
virtual SKIP std::shared_ptr< OMEModelObject > addModelObject(const std::string &id, std::shared_ptr< OMEModelObject > &object)=0
Add a model object to the model.
OME model interface (abstract top-level container)
Definition: OMEModel.h:61
OMEModel()
Constructor.
Definition: OMEModel.h:75
std::vector< std::shared_ptr< Reference > > reference_list_type
A list of Reference objects.
Definition: OMEModel.h:65
virtual std::shared_ptr< OMEModelObject > removeModelObject(const std::string &id)=0
Remove a model object from the model.
virtual std::shared_ptr< OMEModelObject > getModelObject(const std::string &id) const =0
Retrieve a model object from the model.
virtual ~OMEModel()
Destructor.
Definition: OMEModel.h:81
virtual bool addReference(std::shared_ptr< OMEModelObject > &a, std::shared_ptr< Reference > &b)=0
Add a reference to a model object.
std::map< std::string, std::shared_ptr< OMEModelObject > > object_map_type
A map of string model object identifiers to model objects.
Definition: OMEModel.h:67
Open Microscopy Environment C++ implementation.
virtual const object_map_type & getModelObjects() const =0
Retrieve all model objects from the model.
reference_map_type::size_type size_type
Size type for reference map.
Definition: OMEModel.h:71
virtual const reference_map_type & getReferences() const =0
Retrieve all references from the model.
std::map< std::shared_ptr< OMEModelObject >, reference_list_type > reference_map_type
A map of model objects to list of Reference objects.
Definition: OMEModel.h:69
virtual size_type resolveReferences()=0
Resolve all references.