QGIS API Documentation
3.14.0-Pi (9f7028fd23)
|
Go to the documentation of this file.
30 #define AS_JOINFIELD QStringLiteral( "ASPK" )
31 #define AS_EXTENSION QStringLiteral( "qgd" )
32 #define AS_JOINPREFIX QStringLiteral( "auxiliary_storage_" )
68 :
QgsVectorLayer( QStringLiteral( "%1|layername=%2" ).arg( filename, table ),
69 QStringLiteral( "%1_auxiliarystorage" ).arg( table ), QStringLiteral( "ogr" ) )
70 , mFileName( filename )
76 mJoinInfo.setJoinLayer(
this );
78 mJoinInfo.setTargetFieldName( pkField );
79 mJoinInfo.setEditable(
true );
80 mJoinInfo.setUpsertOnEdit(
true );
81 mJoinInfo.setCascadedDelete(
true );
82 mJoinInfo.setJoinFieldNamesBlockList( QStringList() << QStringLiteral(
"rowid" ) );
142 if ( ( definition.
name().isEmpty() && definition.
comment().isEmpty() ) ||
exists( definition ) )
155 if ( index >= 0 && auxIndex >= 0 )
166 QVector<QgsAttributeTableConfig::ColumnConfig> columns = attrCfg.
columns();
167 QVector<QgsAttributeTableConfig::ColumnConfig>::iterator it;
169 for ( it = columns.begin(); it != columns.end(); ++it )
241 for (
const QString &providerId : subProviderIds )
246 c.setProperty( property, prop );
275 c.setProperty( property, prop );
291 if ( def.
origin().compare( QLatin1String(
"labeling" ) ) == 0 )
297 if ( propName.compare( def.
name() ) == 0 )
313 if ( aDef.
origin().compare( QLatin1String(
"labeling" ) ) == 0 )
316 QgsPropertiesDefinition::const_iterator it = defs.constBegin();
317 for ( ; it != defs.constEnd(); ++it )
319 if ( it->name().compare( aDef.
name(), Qt::CaseInsensitive ) == 0 )
326 else if ( aDef.
origin().compare( QLatin1String(
"symbol" ) ) == 0 )
329 QgsPropertiesDefinition::const_iterator it = defs.constBegin();
330 for ( ; it != defs.constEnd(); ++it )
332 if ( it->name().compare( aDef.
name(), Qt::CaseInsensitive ) == 0 )
339 else if ( aDef.
origin().compare( QLatin1String(
"diagram" ) ) == 0 )
342 QgsPropertiesDefinition::const_iterator it = defs.constBegin();
343 for ( ; it != defs.constEnd(); ++it )
345 if ( it->name().compare( aDef.
name(), Qt::CaseInsensitive ) == 0 )
368 QString fieldName = def.
origin();
370 if ( !def.
name().isEmpty() )
371 fieldName = QStringLiteral(
"%1_%2" ).arg( fieldName, def.
name().toLower() );
373 if ( !def.
comment().isEmpty() )
374 fieldName = QStringLiteral(
"%1_%2" ).arg( fieldName, def.
comment() );
377 fieldName = QStringLiteral(
"%1%2" ).arg(
AS_JOINPREFIX, fieldName );
386 if ( !def.
name().isEmpty() || !def.
comment().isEmpty() )
388 QVariant::Type
type = QVariant::Invalid;
394 type = QVariant::String;
396 typeName = QStringLiteral(
"String" );
399 type = QVariant::Double;
402 typeName = QStringLiteral(
"Real" );
405 type = QVariant::Int;
406 typeName = QStringLiteral(
"Integer" );
423 const QStringList parts = f.
name().split(
'_' );
425 if ( parts.size() <= 1 )
428 const QString origin = parts[0];
429 const QString propertyName = parts[1];
431 if ( origin.compare( QLatin1String(
"labeling" ), Qt::CaseInsensitive ) == 0 )
434 for (
auto it = props.constBegin(); it != props.constEnd(); ++it )
436 if ( it.value().name().compare( propertyName, Qt::CaseInsensitive ) == 0 )
439 if ( parts.size() >= 3 )
445 else if ( origin.compare( QLatin1String(
"symbol" ), Qt::CaseInsensitive ) == 0 )
448 for (
auto it = props.constBegin(); it != props.constEnd(); ++it )
450 if ( it.value().name().compare( propertyName, Qt::CaseInsensitive ) == 0 )
453 if ( parts.size() >= 3 )
459 else if ( origin.compare( QLatin1String(
"diagram" ), Qt::CaseInsensitive ) == 0 )
462 for (
auto it = props.constBegin(); it != props.constEnd(); ++it )
464 if ( it.value().name().compare( propertyName, Qt::CaseInsensitive ) == 0 )
467 if ( parts.size() >= 3 )
479 case QVariant::Double:
487 case QVariant::String:
493 if ( parts.size() >= 3 )
505 if ( !def.
name().isEmpty() || !def.
comment().isEmpty() )
525 mFileName = filenameForProject( project );
532 : mFileName( filename )
542 QFile::remove( mTmpFileName );
557 if ( mFileName.isEmpty() )
564 if ( QFile::exists( mFileName ) )
565 QFile::remove( mFileName );
567 return QFile::copy( mTmpFileName, mFileName );
582 if ( mValid && layer )
584 const QString table( layer->
id() );
588 if ( !tableExists( table, database.get() ) )
590 if ( !createTable( field.
typeName(), table, database.get() ) )
611 database = openDB( uri.
database() );
615 QString sql = QStringLiteral(
"DROP TABLE %1" ).arg( uri.
table() );
616 rc = exec( sql, database.get() );
618 sql = QStringLiteral(
"VACUUM" );
619 rc = exec( sql, database.get() );
634 database = openDB( uri.
database() );
638 QString sql = QStringLiteral(
"CREATE TABLE %1 AS SELECT * FROM %2" ).arg( newTable, uri.
table() );
639 rc = exec( sql, database.get() );
653 mErrorString.clear();
655 QFile dest( filename );
656 if ( dest.exists() && !dest.remove() )
658 mErrorString = dest.errorString();
663 if ( !origin.copy( filename ) )
665 mErrorString = origin.errorString();
674 return saveAs( filenameForProject( project ) );
684 const QFileInfo fileinfo( filenameForProject( project ) );
685 return fileinfo.exists() && fileinfo.isFile();
688 bool QgsAuxiliaryStorage::exec(
const QString &sql,
sqlite3 *handler )
694 const int err = sqlite3_exec( handler, sql.toStdString().c_str(),
nullptr,
nullptr,
nullptr );
696 if ( err == SQLITE_OK )
699 debugMsg( sql, handler );
705 void QgsAuxiliaryStorage::debugMsg(
const QString &sql,
sqlite3 *handler )
708 const QString err = QString::fromUtf8( sqlite3_errmsg( handler ) );
709 const QString msg = QObject::tr(
"Unable to execute" );
710 const QString errMsg = QObject::tr(
"%1 '%2': %3" ).arg( msg, sql, err );
718 bool QgsAuxiliaryStorage::createTable(
const QString &type,
const QString &table,
sqlite3 *handler )
720 const QString sql = QStringLiteral(
"CREATE TABLE IF NOT EXISTS '%1' ( '%2' %3 )" ).arg( table,
AS_JOINFIELD, type );
722 if ( !exec( sql, handler ) )
733 rc = database.
open_v2( filename, SQLITE_OPEN_READWRITE | SQLITE_OPEN_CREATE,
nullptr );
736 debugMsg( QStringLiteral(
"sqlite3_open_v2" ), database.get() );
740 exec( QStringLiteral(
"PRAGMA foreign_keys = 1" ), database.get() );
748 int rc = database.
open_v2( filename, SQLITE_OPEN_READWRITE,
nullptr );
752 debugMsg( QStringLiteral(
"sqlite3_open_v2" ), database.get() );
758 bool QgsAuxiliaryStorage::tableExists(
const QString &table,
sqlite3 *handler )
760 const QString sql = QStringLiteral(
"SELECT 1 FROM sqlite_master WHERE type='table' AND name='%1'" ).arg( table );
763 char **results =
nullptr;
764 const int rc = sqlite3_get_table( handler, sql.toStdString().c_str(), &results, &rows, &columns,
nullptr );
765 if ( rc != SQLITE_OK )
767 debugMsg( sql, handler );
771 sqlite3_free_table( results );
782 if ( filename.isEmpty() )
787 else if ( QFile::exists( filename ) )
790 QFile::copy( filename, mTmpFileName );
806 return open( filenameForProject( project ) );
809 QString QgsAuxiliaryStorage::filenameForProject(
const QgsProject &project )
812 const QString path = info.path() + QDir::separator() + info.baseName();
816 void QgsAuxiliaryStorage::initTmpFileName()
818 QTemporaryFile tmpFile;
821 mTmpFileName = tmpFile.fileName();
826 if ( mCopy || mFileName.isEmpty() )
838 QStringList uriParts = uri.
uri().split(
'|' );
839 if ( uriParts.count() < 2 )
842 const QString databasePath = uriParts[0].replace(
' ', QString() );
844 const QString table = uriParts[1];
845 QStringList tableParts = table.split(
' ' );
847 if ( tableParts.count() < 1 )
850 const QString tableName = tableParts[0].replace( QStringLiteral(
"layername=" ), QString() );
QgsFeatureIterator getFeatures(const QgsFeatureRequest &request=QgsFeatureRequest()) const FINAL
Queries the layer for features specified in request.
QgsCoordinateReferenceSystem crs
static QgsProperty fromField(const QString &fieldName, bool isActive=true)
Returns a new FieldBasedProperty created from the specified field name.
@ Hali
Horizontal alignment for data defined label position (Left, Center, Right)
Q_GLOBAL_STATIC_WITH_ARGS(PalPropertyList, palHiddenProperties,({ QgsPalLayerSettings::PositionX, QgsPalLayerSettings::PositionY, QgsPalLayerSettings::Show, QgsPalLayerSettings::LabelRotation, QgsPalLayerSettings::Family, QgsPalLayerSettings::FontStyle, QgsPalLayerSettings::Size, QgsPalLayerSettings::Bold, QgsPalLayerSettings::Italic, QgsPalLayerSettings::Underline, QgsPalLayerSettings::Color, QgsPalLayerSettings::Strikeout, QgsPalLayerSettings::MultiLineAlignment, QgsPalLayerSettings::BufferSize, QgsPalLayerSettings::BufferDraw, QgsPalLayerSettings::BufferColor, QgsPalLayerSettings::LabelDistance, QgsPalLayerSettings::Hali, QgsPalLayerSettings::Vali, QgsPalLayerSettings::ScaleVisibility, QgsPalLayerSettings::MinScale, QgsPalLayerSettings::MaxScale, QgsPalLayerSettings::AlwaysShow, QgsPalLayerSettings::CalloutDraw, QgsPalLayerSettings::LabelAllParts })) QgsAuxiliaryLayer
static QgsField createAuxiliaryField(const QgsPropertyDefinition &definition)
Creates a new auxiliary field from a property definition.
Q_INVOKABLE QgsWkbTypes::Type wkbType() const FINAL
Returns the WKBType or WKBUnknown in case of error.
A store for object properties.
QgsPropertyDefinition propertyDefinitionFromIndex(int index) const
Returns the property definition for the underlying field index.
void updateFields()
Will regenerate the fields property of this layer by obtaining all fields from the dataProvider,...
QgsPropertyCollection & dataDefinedProperties()
Returns a reference to the diagram's property collection, used for data defined overrides.
bool save()
Commits changes and starts editing then.
int indexOfPropertyDefinition(const QgsPropertyDefinition &definition) const
Returns the index of the auxiliary field for a specific property definition.
@ DataTypeString
Property requires a string value.
@ PositionY
Y-coordinate data defined label position.
bool exists(const QgsPropertyDefinition &definition) const
Returns true if the property is stored in the layer already, false otherwise.
int propertyFromIndex(int index) const
Returns the underlying property key for the field index.
int count() const
Returns number of items.
@ Strikeout
Use strikeout.
bool save() const
Saves the current database.
@ DataTypeBoolean
Property requires a boolean value.
QString fileName() const
Returns the target filename of the database.
QString typeName() const
Gets the field type.
@ DataTypeNumeric
Property requires a numeric value.
void setDatabase(const QString &database)
Sets the URI database name.
void setDataDefinedProperties(const QgsPropertyCollection &collection)
Sets the diagram's property collection, used for data defined overrides.
QgsAuxiliaryLayer * auxiliaryLayer()
Returns the current auxiliary layer.
void setDiagramLayerSettings(const QgsDiagramLayerSettings &s)
@ Vali
Vertical alignment for data defined label position (Bottom, Base, Half, Cap, Top)
Q_INVOKABLE bool startEditing()
Makes the layer editable.
static bool exists(const QgsProject &project)
Returns true if the auxiliary database yet exists for a project, false otherwise.
bool append(const QgsField &field, FieldOrigin origin=OriginProvider, int originIndex=-1)
Appends a field. The field must have unique name, otherwise it is rejected (returns false)
QgsVectorLayer * toSpatialLayer() const
An auxiliary layer is not spatial.
bool isValid() const
Returns the status of the auxiliary storage currently defined.
virtual void setSettings(QgsPalLayerSettings *settings, const QString &providerId=QString())=0
Set pal settings for a specific provider (takes ownership).
static QString extension()
Returns the extension used for auxiliary databases.
bool isEditable() const FINAL
Returns true if the provider is in editing mode.
int open_v2(const QString &path, int flags, const char *zVfs)
Opens the database at the specified file path.
void setEditorWidgetSetup(int index, const QgsEditorWidgetSetup &setup)
The editor widget setup defines which QgsFieldFormatter and editor widget will be used for the field ...
QgsFeatureRequest & setFilterExpression(const QString &expression)
Set the filter expression.
QgsAuxiliaryLayer * createAuxiliaryLayer(const QgsField &field, QgsVectorLayer *layer) const
Creates an auxiliary layer for a vector layer.
virtual QgsFeatureIds allFeatureIds() const
Returns a list of all feature IDs for features present in the source.
QVector< QgsPalLayerSettings::Property > PalPropertyList
QString targetFieldName() const
Returns name of the field of our layer that will be used for join.
static int createProperty(QgsPalLayerSettings::Property property, QgsVectorLayer *vlayer)
Creates if necessary a new auxiliary field for a PAL property and activates this property in settings...
QgsEditorWidgetSetup editorWidgetSetup(int index) const
The editor widget setup defines which QgsFieldFormatter and editor widget will be used for the field ...
DataType dataType() const
Returns the allowable field/value data type for the property.
static const QgsPropertiesDefinition & propertyDefinitions()
Returns the symbol layer property definitions.
QgsFields fields() const FINAL
Returns the list of fields of this layer.
@ MaxScale
Max scale (deprecated, for old project compatibility only)
void setComment(const QString &comment)
Sets comment of the property.
QMap< int, QgsPropertyDefinition > QgsPropertiesDefinition
Definition of available properties.
void setTypeName(const QString &typeName)
Set the field type.
static QgsVectorLayer * createMemoryLayer(const QString &name, const QgsFields &fields, QgsWkbTypes::Type geometryType=QgsWkbTypes::NoGeometry, const QgsCoordinateReferenceSystem &crs=QgsCoordinateReferenceSystem())
Creates a new memory layer using the specified parameters.
void setGeometry(const QgsGeometry &geometry)
Set the feature's geometry.
void setDataDefinedProperties(const QgsPropertyCollection &collection)
Sets the label's property collection, used for data defined overrides.
bool isValid() const
Returns the validity of this feature.
@ ColorWithAlpha
Color with alpha channel.
virtual QStringList subProviders() const
Gets list of sub-providers within the layer's labeling.
const QgsAbstractVectorLayerLabeling * labeling() const
Access to const labeling configuration.
@ LabelAllParts
Whether all parts of multi-part features should be labeled.
@ CalloutDraw
Show callout.
QVector< QgsAttributeTableConfig::ColumnConfig > columns() const
Gets the list with all columns and their configuration.
bool clear()
Deletes all features from the layer.
QgsAuxiliaryStorage(const QgsProject &project, bool copy=true)
Constructor.
@ LabelRotation
Label rotation.
Q_INVOKABLE bool commitChanges()
Attempts to commit to the underlying data provider any buffered changes made since the last to call t...
Stores the settings for rendering of all diagrams for a layer.
Definition for a property.
void setLength(int len)
Set the field length.
QgsVectorLayerJoinInfo joinInfo() const
Returns information to use for joining with primary key and so on.
QVariant attribute(const QString &name) const
Lookup attribute value from attribute name.
QString id() const
Returns the layer's unique ID, which is used to access this layer from QgsProject.
QgsAuxiliaryLayer(const QString &pkField, const QString &filename, const QString &table, QgsVectorLayer *vlayer)
Constructor.
StandardPropertyTemplate standardTemplate() const
Returns the property's standard template, if applicable.
static const QgsPropertiesDefinition & propertyDefinitions()
Returns the labeling property definitions.
void setColumns(const QVector< QgsAttributeTableConfig::ColumnConfig > &columns)
Set the list of columns visible in the attribute table.
QString origin() const
Returns the origin of the property.
QgsField field(int fieldIdx) const
Gets field at particular index (must be in range 0..N-1)
QString absoluteFilePath() const
Returns full absolute path to the project file if the project is stored in a file system - derived fr...
static bool duplicateTable(const QgsDataSourceUri &uri, const QString &newTable)
Duplicates a table and its content.
QString comment() const
Returns the comment of the property.
@ PositionX
X-coordinate data defined label position.
A grouped map of multiple QgsProperty objects, each referenced by a integer key value.
const QgsDiagramLayerSettings * diagramLayerSettings() const
QString source() const
Returns the source for the layer.
void setName(const QString &name)
Sets the name of the property.
virtual ~QgsAuxiliaryStorage()
Destructor.
static QString createFieldEqualityExpression(const QString &fieldName, const QVariant &value)
Create an expression allowing to evaluate if a field is equal to a value.
@ Italic
Use italic style.
void setAttributeTableConfig(const QgsAttributeTableConfig &attributeTableConfig)
Sets the attribute table configuration object.
bool nextFeature(QgsFeature &f)
bool deleteFeatures(const QgsFeatureIds &fids, DeleteContext *context=nullptr)
Deletes a set of features from the layer (but does not commit it)
As part of the API refactoring and improvements which landed in the Processing API was substantially reworked from the x version This was done in order to allow much of the underlying Processing framework to be ported into c
void setPrecision(int precision)
Set the field precision.
QString name() const
Returns the name of the property.
QgsAttributeTableConfig attributeTableConfig() const
Returns the attribute table configuration object.
void setDataSource(const QString &aSchema, const QString &aTable, const QString &aGeometryColumn, const QString &aSql=QString(), const QString &aKeyColumn=QString())
Sets all data source related members at once.
@ FontStyle
Font style name.
static QString nameFromProperty(const QgsPropertyDefinition &def, bool joined=false)
Returns the name of the auxiliary field for a property definition.
static const QgsPropertiesDefinition & propertyDefinitions()
Returns the diagram property definitions.
QString database() const
Returns the database name stored in the URI.
QString uri(bool expandAuthConfig=true) const
Returns the complete URI as a string.
QString errorString() const
Returns the underlying error string describing potential errors happening in saveAs().
virtual bool deleteAttribute(int attr)
Deletes an attribute field (but does not commit it).
void setType(QVariant::Type type)
Set variant type.
QgsFields auxiliaryFields() const
Returns a list of all auxiliary fields currently managed by the layer.
Property
Data definable properties.
bool deleteAttribute(int attr) override
Removes attribute from the layer and commits changes.
@ Underline
Use underline.
QString currentFileName() const
Returns the path of the current database used.
bool addAuxiliaryField(const QgsPropertyDefinition &definition)
Adds an auxiliary field for the given property.
int lookupField(const QString &fieldName) const
Looks up field's index from the field name.
static QgsPropertyDefinition propertyDefinitionFromField(const QgsField &field)
Returns the property definition from an auxiliary field.
QgsPropertyCollection & dataDefinedProperties()
Returns a reference to the label's property collection, used for data defined overrides.
QString table() const
Returns the table name stored in the URI.
Property
Data definable properties.
QgsVectorLayer * clone() const override
Returns a new instance equivalent to this one.
bool addFeature(QgsFeature &feature, QgsFeatureSink::Flags flags=QgsFeatureSink::Flags()) FINAL
Adds a single feature to the sink.
@ MinScale
Min scale (deprecated, for old project compatibility only)
QgsMapLayerType type() const
Returns the type of the layer.
void setDataType(DataType type)
Sets the data type.
@ ColorNoAlpha
Color with no alpha channel.
virtual QgsPalLayerSettings settings(const QString &providerId=QString()) const =0
Gets associated label settings.
void setName(const QString &name)
Set the field name.
bool saveAs(const QString &filename)
Saves the current database to a new path.
bool isHiddenProperty(int index) const
Returns true if the underlying field has to be hidden from editing tools like attribute table,...
void setOrigin(const QString &origin)
Sets the origin of the property.
int indexOf(const QString &fieldName) const
Gets the field index from the field name.
static bool deleteTable(const QgsDataSourceUri &uri)
Removes a table from the auxiliary storage.
bool addAttribute(const QgsField &field)
Add an attribute field (but does not commit it) returns true if the field was added.
void update(const QgsFields &fields)
Update the configuration with the given fields.