OGR
ogrlayerpool.h
1 /******************************************************************************
2  * $Id: ogrlayerpool.h 27044 2014-03-16 23:41:27Z rouault $
3  *
4  * Project: OpenGIS Simple Features Reference Implementation
5  * Purpose: Defines OGRLayerPool and OGRProxiedLayer class
6  * Author: Even Rouault, even dot rouault at mines dash paris dot org
7  *
8  ******************************************************************************
9  * Copyright (c) 2012-2013, Even Rouault <even dot rouault at mines-paris dot org>
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 #include "ogrsf_frmts.h"
34 
35 typedef OGRLayer* (*OpenLayerFunc)(void* user_data);
36 typedef void (*FreeUserDataFunc)(void* user_data);
37 
38 class OGRLayerPool;
39 
40 /************************************************************************/
41 /* OGRAbstractProxiedLayer */
42 /************************************************************************/
43 
45 {
46  friend class OGRLayerPool;
47 
48  OGRAbstractProxiedLayer *poPrevLayer; /* Chain to a layer that was used more recently */
49  OGRAbstractProxiedLayer *poNextLayer; /* Chain to a layer that was used less recently */
50 
51  protected:
52  OGRLayerPool *poPool;
53 
54  virtual void CloseUnderlyingLayer() = 0;
55 
56  public:
58  virtual ~OGRAbstractProxiedLayer();
59 };
60 
61 /************************************************************************/
62 /* OGRLayerPool */
63 /************************************************************************/
64 
66 {
67  protected:
68  OGRAbstractProxiedLayer *poMRULayer; /* the most recently used layer */
69  OGRAbstractProxiedLayer *poLRULayer; /* the least recently used layer (still opened) */
70  int nMRUListSize; /* the size of the list */
71  int nMaxSimultaneouslyOpened;
72 
73  public:
74  OGRLayerPool(int nMaxSimultaneouslyOpened = 100);
75  ~OGRLayerPool();
76 
77  void SetLastUsedLayer(OGRAbstractProxiedLayer* poProxiedLayer);
78  void UnchainLayer(OGRAbstractProxiedLayer* poProxiedLayer);
79 
80  int GetMaxSimultaneouslyOpened() const { return nMaxSimultaneouslyOpened; }
81  int GetSize() const { return nMRUListSize; }
82 };
83 
84 /************************************************************************/
85 /* OGRProxiedLayer */
86 /************************************************************************/
87 
89 {
90  OpenLayerFunc pfnOpenLayer;
91  FreeUserDataFunc pfnFreeUserData;
92  void *pUserData;
93  OGRLayer *poUnderlyingLayer;
94  OGRFeatureDefn *poFeatureDefn;
95  OGRSpatialReference *poSRS;
96 
97  int OpenUnderlyingLayer();
98 
99  protected:
100 
101  virtual void CloseUnderlyingLayer();
102 
103  public:
104 
106  OpenLayerFunc pfnOpenLayer,
107  FreeUserDataFunc pfnFreeUserData,
108  void* pUserData);
109  virtual ~OGRProxiedLayer();
110 
111  virtual OGRGeometry *GetSpatialFilter();
112  virtual void SetSpatialFilter( OGRGeometry * );
113  virtual void SetSpatialFilter( int iGeomField, OGRGeometry * );
114 
115  virtual OGRErr SetAttributeFilter( const char * );
116 
117  virtual void ResetReading();
118  virtual OGRFeature *GetNextFeature();
119  virtual OGRErr SetNextByIndex( long nIndex );
120  virtual OGRFeature *GetFeature( long nFID );
121  virtual OGRErr SetFeature( OGRFeature *poFeature );
122  virtual OGRErr CreateFeature( OGRFeature *poFeature );
123  virtual OGRErr DeleteFeature( long nFID );
124 
125  virtual const char *GetName();
127  virtual OGRFeatureDefn *GetLayerDefn();
128 
130 
131  virtual int GetFeatureCount( int bForce = TRUE );
132  virtual OGRErr GetExtent(int iGeomField, OGREnvelope *psExtent, int bForce = TRUE);
133  virtual OGRErr GetExtent(OGREnvelope *psExtent, int bForce = TRUE);
134 
135  virtual int TestCapability( const char * );
136 
137  /* Deprecated (and un-implemented method) --> we won't decorate it ! */
138  /* virtual const char *GetInfo( const char * ); */
139 
140  virtual OGRErr CreateField( OGRFieldDefn *poField,
141  int bApproxOK = TRUE );
142  virtual OGRErr DeleteField( int iField );
143  virtual OGRErr ReorderFields( int* panMap );
144  virtual OGRErr AlterFieldDefn( int iField, OGRFieldDefn* poNewFieldDefn, int nFlags );
145 
146  virtual OGRErr SyncToDisk();
147 
148  virtual OGRStyleTable *GetStyleTable();
149  virtual void SetStyleTableDirectly( OGRStyleTable *poStyleTable );
150 
151  virtual void SetStyleTable(OGRStyleTable *poStyleTable);
152 
153  virtual OGRErr StartTransaction();
154  virtual OGRErr CommitTransaction();
155  virtual OGRErr RollbackTransaction();
156 
157  virtual const char *GetFIDColumn();
158  virtual const char *GetGeometryColumn();
159 
160  virtual OGRErr SetIgnoredFields( const char **papszFields );
161 };
162 
163 #endif // _OGRLAYERPOOL_H_INCLUDED
virtual void SetStyleTable(OGRStyleTable *poStyleTable)
Set layer style table.
Definition: ogrlayer.cpp:1460
virtual const char * GetFIDColumn()
This method returns the name of the underlying database column being used as the FID column...
Definition: ogrlayer.cpp:1393
virtual OGRFeatureDefn * GetLayerDefn()=0
Fetch the schema information for this layer.
virtual OGRErr SetAttributeFilter(const char *)
Set a new attribute query.
Definition: ogrlayer.cpp:320
virtual void SetSpatialFilter(OGRGeometry *)
Set a new spatial filter.
Definition: ogrlayer.cpp:950
virtual OGRErr GetExtent(OGREnvelope *psExtent, int bForce=TRUE)
Fetch the extent of this layer.
Definition: ogrlayer.cpp:206
Definition: ogrlayerpool.h:44
virtual OGRFeature * GetFeature(long nFID)
Fetch a feature by its identifier.
Definition: ogrlayer.cpp:421
virtual OGRErr SetIgnoredFields(const char **papszFields)
Set which fields can be omitted when retrieving features from the layer.
Definition: ogrlayer.cpp:1553
virtual OGRGeometry * GetSpatialFilter()
This method returns the current spatial filter for this layer.
Definition: ogrlayer.cpp:928
virtual int GetFeatureCount(int bForce=TRUE)
Fetch the feature count in this layer.
Definition: ogrlayer.cpp:170
virtual void SetStyleTableDirectly(OGRStyleTable *poStyleTable)
Set layer style table.
Definition: ogrlayer.cpp:1449
virtual OGRErr AlterFieldDefn(int iField, OGRFieldDefn *poNewFieldDefn, int nFlags)
Alter the definition of an existing field on a layer.
Definition: ogrlayer.cpp:729
virtual const char * GetName()
Return the layer name.
Definition: ogrlayer.cpp:1511
Definition: ogr_feature.h:167
virtual OGRErr ReorderFields(int *panMap)
Reorder all the fields of a layer.
Definition: ogrlayer.cpp:632
Definition: ogr_feature.h:52
virtual const char * GetGeometryColumn()
This method returns the name of the underlying database column being used as the geometry column...
Definition: ogrlayer.cpp:1415
virtual OGRErr SetFeature(OGRFeature *poFeature)
Rewrite an existing feature.
Definition: ogrlayer.cpp:517
OGRwkbGeometryType
Definition: ogr_core.h:308
virtual OGRFeature * GetNextFeature()=0
Fetch the next available feature from this layer.
Definition: ogr_geometry.h:79
virtual int TestCapability(const char *)=0
Test if this layer supported the named capability.
virtual void ResetReading()=0
Reset feature reading to start on the first feature.
Definition: ogrlayerpool.h:65
virtual OGRErr CreateFeature(OGRFeature *poFeature)
Create and write a new feature within a layer.
Definition: ogrlayer.cpp:540
Definition: ogr_spatialref.h:129
Definition: ogr_core.h:48
virtual OGRErr SyncToDisk()
Flush pending changes to disk.
Definition: ogrlayer.cpp:1327
Definition: ogrsf_frmts.h:59
Definition: ogrlayerpool.h:88
virtual OGRErr CreateField(OGRFieldDefn *poField, int bApproxOK=TRUE)
Create a new field on a layer.
Definition: ogrlayer.cpp:574
Definition: ogr_feature.h:232
Definition: ogr_featurestyle.h:81
virtual OGRErr DeleteField(int iField)
Delete an existing field on a layer.
Definition: ogrlayer.cpp:605
virtual OGRStyleTable * GetStyleTable()
Returns layer style table.
Definition: ogrlayer.cpp:1440
virtual OGRSpatialReference * GetSpatialRef()
Fetch the spatial reference system for this layer.
Definition: ogrlayer.cpp:891
virtual OGRwkbGeometryType GetGeomType()
Return the layer geometry type.
Definition: ogrlayer.cpp:1533
virtual OGRErr DeleteFeature(long nFID)
Delete feature from layer.
Definition: ogrlayer.cpp:1349
virtual OGRErr SetNextByIndex(long nIndex)
Move read cursor to the nIndex&#39;th feature in the current resultset.
Definition: ogrlayer.cpp:468

Generated for GDAL by doxygen 1.8.11.