GDAL
ogrmutexeddatasource.h
1/******************************************************************************
2 * $Id: ogrmutexeddatasource.h 5a8ccc891da4f76e423dec56c6babdc61425c02f 2021-10-15 18:58:04 +0200 Even Rouault $
3 *
4 * Project: OpenGIS Simple Features Reference Implementation
5 * Purpose: Defines OGRLMutexedDataSource class
6 * Author: Even Rouault, even dot rouault at spatialys.com
7 *
8 ******************************************************************************
9 * Copyright (c) 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 OGRMUTEXEDDATASOURCELAYER_H_INCLUDED
31#define OGRMUTEXEDDATASOURCELAYER_H_INCLUDED
32
33#ifndef DOXYGEN_SKIP
34
35#include "ogrsf_frmts.h"
36#include "cpl_multiproc.h"
37#include "ogrmutexedlayer.h"
38#include <map>
39
47class CPL_DLL OGRMutexedDataSource : public OGRDataSource
48{
49 CPL_DISALLOW_COPY_ASSIGN(OGRMutexedDataSource)
50
51 protected:
52 OGRDataSource *m_poBaseDataSource;
53 int m_bHasOwnership;
54 CPLMutex *m_hGlobalMutex;
55 int m_bWrapLayersInMutexedLayer;
56 std::map<OGRLayer*, OGRMutexedLayer* > m_oMapLayers{};
57 std::map<OGRMutexedLayer*, OGRLayer* > m_oReverseMapLayers{};
58
59 OGRLayer* WrapLayerIfNecessary(OGRLayer* poLayer);
60
61 public:
62
63 /* The construction of the object isn't protected by the mutex */
64 OGRMutexedDataSource(OGRDataSource* poBaseDataSource,
65 int bTakeOwnership,
66 CPLMutex* hMutexIn,
67 int bWrapLayersInMutexedLayer);
68
69 /* The destruction of the object isn't protected by the mutex */
70 virtual ~OGRMutexedDataSource() override;
71
72 OGRDataSource* GetBaseDataSource() { return m_poBaseDataSource; }
73
74 virtual const char *GetName() override;
75
76 virtual int GetLayerCount() override ;
77 virtual OGRLayer *GetLayer(int) override;
78 virtual OGRLayer *GetLayerByName(const char *) override;
79 virtual OGRErr DeleteLayer(int) override;
80 virtual bool IsLayerPrivate(int iLayer) const override;
81
82 virtual int TestCapability( const char * ) override;
83
84 virtual OGRLayer *ICreateLayer( const char *pszName,
85 OGRSpatialReference *poSpatialRef = nullptr,
87 char ** papszOptions = nullptr ) override;
88 virtual OGRLayer *CopyLayer( OGRLayer *poSrcLayer,
89 const char *pszNewName,
90 char **papszOptions = nullptr ) override;
91
92 virtual OGRStyleTable *GetStyleTable() override;
93 virtual void SetStyleTableDirectly( OGRStyleTable *poStyleTable ) override;
94
95 virtual void SetStyleTable(OGRStyleTable *poStyleTable) override;
96
97 virtual OGRLayer * ExecuteSQL( const char *pszStatement,
98 OGRGeometry *poSpatialFilter,
99 const char *pszDialect ) override;
100 virtual void ReleaseResultSet( OGRLayer * poResultsSet ) override;
101
102 virtual void FlushCache(bool bAtClosing) override;
103
104 virtual OGRErr StartTransaction(int bForce=FALSE) override;
105 virtual OGRErr CommitTransaction() override;
106 virtual OGRErr RollbackTransaction() override;
107
108 virtual char **GetMetadata( const char * pszDomain = "" ) override;
109 virtual CPLErr SetMetadata( char ** papszMetadata,
110 const char * pszDomain = "" ) override;
111 virtual const char *GetMetadataItem( const char * pszName,
112 const char * pszDomain = "" ) override;
113 virtual CPLErr SetMetadataItem( const char * pszName,
114 const char * pszValue,
115 const char * pszDomain = "" ) override;
116
117 virtual const OGRFieldDomain* GetFieldDomain(const std::string& name) const override;
118
119 virtual bool AddFieldDomain(std::unique_ptr<OGRFieldDomain>&& domain,
120 std::string& failureReason) override;
121
122 virtual std::shared_ptr<GDALGroup> GetRootGroup() const override;
123
124};
125
126#endif /* #ifndef DOXYGEN_SKIP */
127
128#endif // OGRMUTEXEDDATASOURCELAYER_H_INCLUDED
virtual bool IsLayerPrivate(int iLayer) const
Returns true if the layer at the specified index is deemed a private or system table,...
Definition gdaldataset.cpp:6971
virtual void SetStyleTableDirectly(OGRStyleTable *poStyleTable)
Set dataset style table.
Definition gdaldataset.cpp:6863
CPLErr SetMetadataItem(const char *pszName, const char *pszValue, const char *pszDomain) override
Set single metadata item.
virtual int GetLayerCount()
Get the number of layers in this dataset.
Definition gdaldataset.cpp:6924
virtual void FlushCache(bool bAtClosing=false)
Flush all write cached data to disk.
Definition gdaldataset.cpp:435
virtual OGRStyleTable * GetStyleTable()
Returns dataset style table.
Definition gdaldataset.cpp:6843
virtual OGRErr StartTransaction(int bForce=FALSE)
For datasources which support transactions, StartTransaction creates a `transaction.
Definition gdaldataset.cpp:7409
virtual OGRLayer * GetLayerByName(const char *)
Fetch a layer by name.
Definition gdaldataset.cpp:5499
virtual void SetStyleTable(OGRStyleTable *poStyleTable)
Set dataset style table.
Definition gdaldataset.cpp:6889
virtual OGRLayer * ExecuteSQL(const char *pszStatement, OGRGeometry *poSpatialFilter, const char *pszDialect)
Execute an SQL statement against the data store.
Definition gdaldataset.cpp:6280
virtual const OGRFieldDomain * GetFieldDomain(const std::string &name) const
Get a field domain from its name.
Definition gdaldataset.cpp:8447
virtual OGRErr RollbackTransaction()
For datasources which support transactions, RollbackTransaction will roll back a datasource to its st...
Definition gdaldataset.cpp:7551
virtual OGRLayer * GetLayer(int iLayer)
Fetch a layer by index.
Definition gdaldataset.cpp:6951
virtual OGRLayer * ICreateLayer(const char *pszName, OGRSpatialReference *poSpatialRef=nullptr, OGRwkbGeometryType eGType=wkbUnknown, char **papszOptions=nullptr)
This method attempts to create a new layer on the dataset with the indicated name,...
Definition gdaldataset.cpp:5062
virtual void ReleaseResultSet(OGRLayer *poResultsSet)
Release results of ExecuteSQL().
Definition gdaldataset.cpp:6821
virtual bool AddFieldDomain(std::unique_ptr< OGRFieldDomain > &&domain, std::string &failureReason)
Add a field domain to the dataset.
Definition gdaldataset.cpp:8499
CPLErr SetMetadata(char **papszMetadata, const char *pszDomain) override
Set metadata.
void static void char ** GetMetadata(const char *pszDomain="") override
Fetch metadata.
Definition gdaldataset.cpp:4229
virtual std::shared_ptr< GDALGroup > GetRootGroup() const
Return the root GDALGroup of this dataset.
Definition gdaldataset.cpp:8372
virtual OGRErr DeleteLayer(int iLayer)
Delete the indicated layer from the datasource.
Definition gdaldataset.cpp:5470
virtual OGRErr CommitTransaction()
For datasources which support transactions, CommitTransaction commits a transaction.
Definition gdaldataset.cpp:7499
virtual int TestCapability(const char *)
Test if capability is available.
Definition gdaldataset.cpp:7304
virtual OGRLayer * CopyLayer(OGRLayer *poSrcLayer, const char *pszNewName, char **papszOptions=nullptr)
Duplicate an existing layer.
Definition gdaldataset.cpp:5103
virtual const char * GetMetadataItem(const char *pszName, const char *pszDomain="")
Fetch single metadata item.
Definition gdalmajorobject.cpp:344
LEGACY class.
Definition ogrsf_frmts.h:367
CPLErr
Error category.
Definition cpl_error.h:53
#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:955
OGRwkbGeometryType
List of well known binary geometry types.
Definition ogr_core.h:369
@ wkbUnknown
unknown type, non-standard
Definition ogr_core.h:370
int OGRErr
Type for a OGR error.
Definition ogr_core.h:341
Classes related to registration of format support, and opening datasets.