OGR
Public Member Functions | List of all members
OGRMutexedDataSource Class Reference

#include <ogrmutexeddatasource.h>

Inheritance diagram for OGRMutexedDataSource:
OGRDataSource

Public Member Functions

virtual const char * GetName ()
 Returns the name of the data source. More...
 
virtual int GetLayerCount ()
 Get the number of layers in this data source. More...
 
virtual OGRLayerGetLayer (int)
 Fetch a layer by index. More...
 
virtual OGRLayerGetLayerByName (const char *)
 Fetch a layer by name. More...
 
virtual OGRErr DeleteLayer (int)
 Delete the indicated layer from the datasource. More...
 
virtual int TestCapability (const char *)
 Test if capability is available. More...
 
virtual OGRLayerCreateLayer (const char *pszName, OGRSpatialReference *poSpatialRef=NULL, OGRwkbGeometryType eGType=wkbUnknown, char **papszOptions=NULL)
 This method attempts to create a new layer on the data source with the indicated name, coordinate system, geometry type. More...
 
virtual OGRLayerCopyLayer (OGRLayer *poSrcLayer, const char *pszNewName, char **papszOptions=NULL)
 Duplicate an existing layer. More...
 
virtual OGRStyleTableGetStyleTable ()
 Returns data source style table. More...
 
virtual void SetStyleTableDirectly (OGRStyleTable *poStyleTable)
 Set data source style table. More...
 
virtual void SetStyleTable (OGRStyleTable *poStyleTable)
 Set data source style table. More...
 
virtual OGRLayerExecuteSQL (const char *pszStatement, OGRGeometry *poSpatialFilter, const char *pszDialect)
 Execute an SQL statement against the data store. More...
 
virtual void ReleaseResultSet (OGRLayer *poResultsSet)
 Release results of ExecuteSQL(). More...
 
virtual OGRErr SyncToDisk ()
 Flush pending changes to disk. More...
 
- Public Member Functions inherited from OGRDataSource
int Reference ()
 Increment datasource reference count. More...
 
int Dereference ()
 Decrement datasource reference count. More...
 
int GetRefCount () const
 Fetch reference count. More...
 
int GetSummaryRefCount () const
 Fetch reference count of datasource and all owned layers. More...
 
OGRErr Release ()
 Drop a reference to this datasource, and if the reference count drops to zero close (destroy) the datasource. More...
 
OGRSFDriverGetDriver () const
 Returns the driver that the dataset was opened with. More...
 
void SetDriver (OGRSFDriver *poDriver)
 Sets the driver that the dataset was created or opened with. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from OGRDataSource
static void DestroyDataSource (OGRDataSource *)
 Closes opened datasource and releases allocated resources. More...
 

Detailed Description

OGRMutexedDataSource class protects all virtual methods of OGRDataSource with a mutex. If the passed mutex is NULL, then no locking will be done.

Note that the constructors and destructors are not explictely protected by the mutex*

Member Function Documentation

OGRLayer * OGRMutexedDataSource::CopyLayer ( OGRLayer poSrcLayer,
const char *  pszNewName,
char **  papszOptions = NULL 
)
virtual

Duplicate an existing layer.

This method creates a new layer, duplicate the field definitions of the source layer and then duplicate each features of the source layer. The papszOptions argument can be used to control driver specific creation options. These options are normally documented in the format specific documentation. The source layer may come from another dataset.

This method is the same as the C function OGR_DS_CopyLayer().

Parameters
poSrcLayersource layer.
pszNewNamethe name of the layer to create.
papszOptionsa StringList of name=value options. Options are driver specific.
Returns
an handle to the layer, or NULL if an error occurs.

Reimplemented from OGRDataSource.

OGRLayer * OGRMutexedDataSource::CreateLayer ( const char *  pszName,
OGRSpatialReference poSpatialRef = NULL,
OGRwkbGeometryType  eGType = wkbUnknown,
char **  papszOptions = NULL 
)
virtual

This method attempts to create a new layer on the data source with the indicated name, coordinate system, geometry type.

The papszOptions argument can be used to control driver specific creation options. These options are normally documented in the format specific documentation.

Parameters
pszNamethe name for the new layer. This should ideally not match any existing layer on the datasource.
poSpatialRefthe coordinate system to use for the new layer, or NULL if no coordinate system is available.
eGTypethe geometry type for the layer. Use wkbUnknown if there are no constraints on the types geometry to be written.
papszOptionsa StringList of name=value options. Options are driver specific.
Returns
NULL is returned on failure, or a new OGRLayer handle on success.

Example:

#include "ogrsf_frmts.h"
#include "cpl_string.h"
...
OGRLayer *poLayer;
char **papszOptions;
if( !poDS->TestCapability( ODsCCreateLayer ) )
{
...
}
papszOptions = CSLSetNameValue( papszOptions, "DIM", "2" );
poLayer = poDS->CreateLayer( "NewLayer", NULL, wkbUnknown,
papszOptions );
CSLDestroy( papszOptions );
if( poLayer == NULL )
{
...
}

Reimplemented from OGRDataSource.

OGRErr OGRMutexedDataSource::DeleteLayer ( int  iLayer)
virtual

Delete the indicated layer from the datasource.

If this method is supported the ODsCDeleteLayer capability will test TRUE on the OGRDataSource.

This method is the same as the C function OGR_DS_DeleteLayer().

Parameters
iLayerthe index of the layer to delete.
Returns
OGRERR_NONE on success, or OGRERR_UNSUPPORTED_OPERATION if deleting layers is not supported for this datasource.

Reimplemented from OGRDataSource.

OGRLayer * OGRMutexedDataSource::ExecuteSQL ( const char *  pszStatement,
OGRGeometry poSpatialFilter,
const char *  pszDialect 
)
virtual

Execute an SQL statement against the data store.

The result of an SQL query is either NULL for statements that are in error, or that have no results set, or an OGRLayer pointer representing a results set from the query. Note that this OGRLayer is in addition to the layers in the data store and must be destroyed with OGRDataSource::ReleaseResultSet() before the data source is closed (destroyed).

This method is the same as the C function OGR_DS_ExecuteSQL().

For more information on the SQL dialect supported internally by OGR review the OGR SQL document. Some drivers (ie. Oracle and PostGIS) pass the SQL directly through to the underlying RDBMS.

Starting with OGR 1.10, the SQLITE dialect can also be used.

Parameters
pszStatementthe SQL statement to execute.
poSpatialFiltergeometry which represents a spatial filter. Can be NULL.
pszDialectallows control of the statement dialect. If set to NULL, the OGR SQL engine will be used, except for RDBMS drivers that will use their dedicated SQL engine, unless OGRSQL is explicitly passed as the dialect. Starting with OGR 1.10, the SQLITE dialect can also be used.
Returns
an OGRLayer containing the results of the query. Deallocate with ReleaseResultSet().

Reimplemented from OGRDataSource.

OGRLayer * OGRMutexedDataSource::GetLayer ( int  iLayer)
virtual

Fetch a layer by index.

The returned layer remains owned by the OGRDataSource and should not be deleted by the application.

This method is the same as the C function OGR_DS_GetLayer().

Parameters
iLayera layer number between 0 and GetLayerCount()-1.
Returns
the layer, or NULL if iLayer is out of range or an error occurs.

Implements OGRDataSource.

OGRLayer * OGRMutexedDataSource::GetLayerByName ( const char *  pszLayerName)
virtual

Fetch a layer by name.

The returned layer remains owned by the OGRDataSource and should not be deleted by the application.

This method is the same as the C function OGR_DS_GetLayerByName().

Parameters
pszLayerNamethe layer name of the layer to fetch.
Returns
the layer, or NULL if Layer is not found or an error occurs.

Reimplemented from OGRDataSource.

int OGRMutexedDataSource::GetLayerCount ( )
virtual

Get the number of layers in this data source.

This method is the same as the C function OGR_DS_GetLayerCount().

Returns
layer count.

Implements OGRDataSource.

const char * OGRMutexedDataSource::GetName ( )
virtual

Returns the name of the data source.

This string should be sufficient to open the data source if passed to the same OGRSFDriver that this data source was opened with, but it need not be exactly the same string that was used to open the data source. Normally this is a filename.

This method is the same as the C function OGR_DS_GetName().

Returns
pointer to an internal name string which should not be modified or freed by the caller.

Implements OGRDataSource.

OGRStyleTable * OGRMutexedDataSource::GetStyleTable ( )
virtual

Returns data source style table.

This method is the same as the C function OGR_DS_GetStyleTable().

Returns
pointer to a style table which should not be modified or freed by the caller.

Reimplemented from OGRDataSource.

void OGRMutexedDataSource::ReleaseResultSet ( OGRLayer poResultsSet)
virtual

Release results of ExecuteSQL().

This method should only be used to deallocate OGRLayers resulting from an ExecuteSQL() call on the same OGRDataSource. Failure to deallocate a results set before destroying the OGRDataSource may cause errors.

This method is the same as the C function OGR_L_ReleaseResultSet().

Parameters
poResultsSetthe result of a previous ExecuteSQL() call.

Reimplemented from OGRDataSource.

void OGRMutexedDataSource::SetStyleTable ( OGRStyleTable poStyleTable)
virtual

Set data source style table.

This method operate exactly as OGRDataSource::SetStyleTableDirectly() except that it does not assume ownership of the passed table.

This method is the same as the C function OGR_DS_SetStyleTable().

Parameters
poStyleTablepointer to style table to set

Reimplemented from OGRDataSource.

void OGRMutexedDataSource::SetStyleTableDirectly ( OGRStyleTable poStyleTable)
virtual

Set data source style table.

This method operate exactly as OGRDataSource::SetStyleTable() except that it assumes ownership of the passed table.

This method is the same as the C function OGR_DS_SetStyleTableDirectly().

Parameters
poStyleTablepointer to style table to set

Reimplemented from OGRDataSource.

OGRErr OGRMutexedDataSource::SyncToDisk ( )
virtual

Flush pending changes to disk.

This call is intended to force the datasource to flush any pending writes to disk, and leave the disk file in a consistent state. It would not normally have any effect on read-only datasources.

Some data sources do not implement this method, and will still return OGRERR_NONE. An error is only returned if an error occurs while attempting to flush to disk.

The default implementation of this method just calls the SyncToDisk() method on each of the layers. Conceptionally, calling SyncToDisk() on a datasource should include any work that might be accomplished by calling SyncToDisk() on layers in that data source.

In any event, you should always close any opened datasource with OGRDataSource::DestroyDataSource() that will ensure all data is correctly flushed.

This method is the same as the C function OGR_DS_SyncToDisk().

Returns
OGRERR_NONE if no error occurs (even if nothing is done) or an error code.

Reimplemented from OGRDataSource.

int OGRMutexedDataSource::TestCapability ( const char *  pszCapability)
virtual

Test if capability is available.

One of the following data source capability names can be passed into this method, and a TRUE or FALSE value will be returned indicating whether or not the capability is available for this object.

  • ODsCCreateLayer: True if this datasource can create new layers.

  • ODsCDeleteLayer: True if this datasource can delete existing layers.

  • ODsCCreateGeomFieldAfterCreateLayer: True if the layers of this datasource support CreateGeomField() just after layer creation.

The #define macro forms of the capability names should be used in preference to the strings themselves to avoid mispelling.

This method is the same as the C function OGR_DS_TestCapability().

Parameters
pszCapabilitythe capability to test.
Returns
TRUE if capability available otherwise FALSE.

Implements OGRDataSource.


The documentation for this class was generated from the following files:

Generated for GDAL by doxygen 1.8.11.