GDAL

ogrlayerpool.h
1/******************************************************************************
2 * $Id$
3 *
4 * Project: OpenGIS Simple Features Reference Implementation
5 * Purpose: Defines OGRLayerPool and OGRProxiedLayer class
6 * Author: Even Rouault, even dot rouault at spatialys.com
7 *
8 ******************************************************************************
9 * Copyright (c) 2012-2013, Even Rouault <even dot rouault at spatialys.com>
10 *
11 * Permission is hereby granted, free of charge, to any person obtaining a
12 * copy of this software and associated documentation files (the "Software"),
13 * to deal in the Software without restriction, including without limitation
14 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
15 * and/or sell copies of the Software, and to permit persons to whom the
16 * Software is furnished to do so, subject to the following conditions:
17 *
18 * The above copyright notice and this permission notice shall be included
19 * in all copies or substantial portions of the Software.
20 *
21 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
22 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
23 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
24 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
25 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
26 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
27 * DEALINGS IN THE SOFTWARE.
28 ****************************************************************************/
29
30#ifndef OGRLAYERPOOL_H_INCLUDED
31#define OGRLAYERPOOL_H_INCLUDED
32
33#ifndef DOXYGEN_SKIP
34
35#include "ogrsf_frmts.h"
36
37typedef OGRLayer *(*OpenLayerFunc)(void *user_data);
38typedef void (*FreeUserDataFunc)(void *user_data);
39
40class OGRLayerPool;
41
42/************************************************************************/
43/* OGRAbstractProxiedLayer */
44/************************************************************************/
45
46class CPL_DLL OGRAbstractProxiedLayer : public OGRLayer
47{
48 CPL_DISALLOW_COPY_ASSIGN(OGRAbstractProxiedLayer)
49
50 friend class OGRLayerPool;
51
52 OGRAbstractProxiedLayer
53 *poPrevLayer; /* Chain to a layer that was used more recently */
54 OGRAbstractProxiedLayer
55 *poNextLayer; /* Chain to a layer that was used less recently */
56
57 protected:
58 OGRLayerPool *poPool;
59
60 virtual void CloseUnderlyingLayer() = 0;
61
62 public:
63 explicit OGRAbstractProxiedLayer(OGRLayerPool *poPool);
64 virtual ~OGRAbstractProxiedLayer();
65};
66
67/************************************************************************/
68/* OGRLayerPool */
69/************************************************************************/
70
71class CPL_DLL OGRLayerPool
72{
73 CPL_DISALLOW_COPY_ASSIGN(OGRLayerPool)
74
75 protected:
76 OGRAbstractProxiedLayer *poMRULayer; /* the most recently used layer */
77 OGRAbstractProxiedLayer
78 *poLRULayer; /* the least recently used layer (still opened) */
79 int nMRUListSize; /* the size of the list */
80 int nMaxSimultaneouslyOpened;
81
82 public:
83 explicit OGRLayerPool(int nMaxSimultaneouslyOpened = 100);
84 ~OGRLayerPool();
85
86 void SetLastUsedLayer(OGRAbstractProxiedLayer *poProxiedLayer);
87 void UnchainLayer(OGRAbstractProxiedLayer *poProxiedLayer);
88
89 int GetMaxSimultaneouslyOpened() const
90 {
91 return nMaxSimultaneouslyOpened;
92 }
93
94 int GetSize() const
95 {
96 return nMRUListSize;
97 }
98};
99
100/************************************************************************/
101/* OGRProxiedLayer */
102/************************************************************************/
103
104class OGRProxiedLayer : public OGRAbstractProxiedLayer
105{
106 CPL_DISALLOW_COPY_ASSIGN(OGRProxiedLayer)
107
108 OpenLayerFunc pfnOpenLayer;
109 FreeUserDataFunc pfnFreeUserData;
110 void *pUserData;
111 OGRLayer *poUnderlyingLayer;
112 OGRFeatureDefn *poFeatureDefn;
113 OGRSpatialReference *poSRS;
114
115 int OpenUnderlyingLayer();
116
117 protected:
118 virtual void CloseUnderlyingLayer() override;
119
120 public:
121 OGRProxiedLayer(OGRLayerPool *poPool, OpenLayerFunc pfnOpenLayer,
122 FreeUserDataFunc pfnFreeUserData, void *pUserData);
123 virtual ~OGRProxiedLayer();
124
125 OGRLayer *GetUnderlyingLayer();
126
127 virtual OGRGeometry *GetSpatialFilter() override;
128 virtual void SetSpatialFilter(OGRGeometry *) override;
129 virtual void SetSpatialFilter(int iGeomField, OGRGeometry *) override;
130
131 virtual OGRErr SetAttributeFilter(const char *) override;
132
133 virtual void ResetReading() override;
134 virtual OGRFeature *GetNextFeature() override;
135 virtual OGRErr SetNextByIndex(GIntBig nIndex) override;
136 virtual OGRFeature *GetFeature(GIntBig nFID) override;
137 virtual OGRErr ISetFeature(OGRFeature *poFeature) override;
138 virtual OGRErr ICreateFeature(OGRFeature *poFeature) override;
139 virtual OGRErr IUpsertFeature(OGRFeature *poFeature) override;
140 OGRErr IUpdateFeature(OGRFeature *poFeature, int nUpdatedFieldsCount,
141 const int *panUpdatedFieldsIdx,
142 int nUpdatedGeomFieldsCount,
143 const int *panUpdatedGeomFieldsIdx,
144 bool bUpdateStyleString) override;
145 virtual OGRErr DeleteFeature(GIntBig nFID) override;
146
147 virtual GDALDataset *GetDataset() override;
148 virtual bool GetArrowStream(struct ArrowArrayStream *out_stream,
149 CSLConstList papszOptions = nullptr) override;
150
151 virtual const char *GetName() override;
152 virtual OGRwkbGeometryType GetGeomType() override;
153 virtual OGRFeatureDefn *GetLayerDefn() override;
154
155 virtual OGRSpatialReference *GetSpatialRef() override;
156
157 virtual GIntBig GetFeatureCount(int bForce = TRUE) override;
158 virtual OGRErr GetExtent(int iGeomField, OGREnvelope *psExtent,
159 int bForce = TRUE) override;
160 virtual OGRErr GetExtent(OGREnvelope *psExtent, int bForce = TRUE) override;
161
162 virtual int TestCapability(const char *) override;
163
164 virtual OGRErr CreateField(const OGRFieldDefn *poField,
165 int bApproxOK = TRUE) override;
166 virtual OGRErr DeleteField(int iField) override;
167 virtual OGRErr ReorderFields(int *panMap) override;
168 virtual OGRErr AlterFieldDefn(int iField, OGRFieldDefn *poNewFieldDefn,
169 int nFlags) override;
170 virtual OGRErr
171 AlterGeomFieldDefn(int iGeomField,
172 const OGRGeomFieldDefn *poNewGeomFieldDefn,
173 int nFlags) override;
174
175 virtual OGRErr SyncToDisk() override;
176
177 virtual OGRStyleTable *GetStyleTable() override;
178 virtual void SetStyleTableDirectly(OGRStyleTable *poStyleTable) override;
179
180 virtual void SetStyleTable(OGRStyleTable *poStyleTable) override;
181
182 virtual OGRErr StartTransaction() override;
183 virtual OGRErr CommitTransaction() override;
184 virtual OGRErr RollbackTransaction() override;
185
186 virtual const char *GetFIDColumn() override;
187 virtual const char *GetGeometryColumn() override;
188
189 virtual OGRErr SetIgnoredFields(CSLConstList papszFields) override;
190
191 virtual OGRErr Rename(const char *pszNewName) override;
192};
193
194#endif /* #ifndef DOXYGEN_SKIP */
195
196#endif // OGRLAYERPOOL_H_INCLUDED
GDALDataset
A set of associated raster bands, usually from one file.
Definition: gdal_priv.h:490
OGREnvelope
Simple container for a bounding region (rectangle)
Definition: ogr_core.h:61
OGRFeatureDefn
Definition of a feature class or feature layer.
Definition: ogr_feature.h:517
OGRFeature
A simple feature, including geometry and attributes.
Definition: ogr_feature.h:893
OGRFieldDefn
Definition of an attribute of an OGRFeatureDefn.
Definition: ogr_feature.h:111
OGRGeomFieldDefn
Definition of a geometry field of an OGRFeatureDefn.
Definition: ogr_feature.h:346
OGRGeometry
Abstract base class for all geometry classes.
Definition: ogr_geometry.h:377
OGRLayer
This class represents a layer of simple features, with access methods.
Definition: ogrsf_frmts.h:74
OGRSpatialReference
This class represents an OpenGIS Spatial Reference System, and contains methods for converting betwee...
Definition: ogr_spatialref.h:169
OGRStyleTable
This class represents a style table.
Definition: ogr_featurestyle.h:86
CPL_DISALLOW_COPY_ASSIGN
#define CPL_DISALLOW_COPY_ASSIGN(ClassName)
Helper to remove the copy and assignment constructors so that the compiler will not generate the defa...
Definition: cpl_port.h:1042
CSLConstList
char ** CSLConstList
Type of a constant null-terminated list of nul terminated strings.
Definition: cpl_port.h:1183
GIntBig
long long GIntBig
Large signed integer type (generally 64-bit integer type).
Definition: cpl_port.h:215
OGRwkbGeometryType
OGRwkbGeometryType
List of well known binary geometry types.
Definition: ogr_core.h:416
OGRErr
int OGRErr
Type for a OGR error.
Definition: ogr_core.h:387
ogrsf_frmts.h
Classes related to registration of format support, and opening datasets.