mil.nga.geopackage.factory

Class GeoPackageCoreImpl

java.lang.Object

mil.nga.geopackage.factory.GeoPackageCoreImpl

All Implemented Interfaces:

Closeable, AutoCloseable, GeoPackageCore

public abstract class GeoPackageCoreImpl
extends Object
implements GeoPackageCore

A single GeoPackage database connection implementation

Author:

osbornb

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	GeoPackageCoreImpl(String name, String path, GeoPackageCoreConnection database, GeoPackageTableCreator tableCreator, boolean writable) Constructor

Method Summary

Modifier and Type	Method and Description
void	close() Close the GeoPackage connection
<T,S extends BaseDaoImpl<T,?>> S	createDao(Class<T> type) Create a dao
boolean	createDataColumnConstraintsTable() Create the Data Column Constraints table if it does not already exist
boolean	createDataColumnsTable() Create the Data Columns table if it does not already exist
boolean	createExtensionsTable() Create the Extensions table if it does not already exist
void	createFeatureTable(FeatureTable table) Create a new feature table
GeometryColumns	createFeatureTableWithMetadata(GeometryColumns geometryColumns, BoundingBox boundingBox, long srsId) Create a new feature table with GeoPackage metadata.
GeometryColumns	createFeatureTableWithMetadata(GeometryColumns geometryColumns, BoundingBox boundingBox, long srsId, List<FeatureColumn> columns) Create a new feature table with GeoPackage metadata.
GeometryColumns	createFeatureTableWithMetadata(GeometryColumns geometryColumns, List<FeatureColumn> additionalColumns, BoundingBox boundingBox, long srsId) Create a new feature table with GeoPackage metadata.
GeometryColumns	createFeatureTableWithMetadata(GeometryColumns geometryColumns, String idColumnName, BoundingBox boundingBox, long srsId) Create a new feature table with GeoPackage metadata.
GeometryColumns	createFeatureTableWithMetadata(GeometryColumns geometryColumns, String idColumnName, List<FeatureColumn> additionalColumns, BoundingBox boundingBox, long srsId) Create a new feature table with GeoPackage metadata.
boolean	createFeatureTileLinkTable() Create the Feature Tile Link Table if it does not exist
boolean	createGeometryColumnsTable() Create the Geometry Columns table if it does not already exist
boolean	createGeometryIndexTable() Create Geometry Index Table if it does not exist
boolean	createMetadataReferenceTable() Create the Metadata Reference table if it does not already exist
boolean	createMetadataTable() Create the Metadata table if it does not already exist
boolean	createTableIndexTable() Create the Table Index Table if it does not exist
boolean	createTileMatrixSetTable() Create the Tile Matrix Set table if it does not already exist
boolean	createTileMatrixTable() Create the Tile Matrix table if it does not already exist
void	createTileTable(TileTable table) Create a new tile table
TileMatrixSet	createTileTableWithMetadata(String tableName, BoundingBox contentsBoundingBox, long contentsSrsId, BoundingBox tileMatrixSetBoundingBox, long tileMatrixSetSrsId) Create a new tile table and the GeoPackage metadata
void	deleteTable(String table) Delete the user table (a feature or tile table) and all GeoPackage metadata
void	deleteTableQuietly(String tableName) Attempt to delete the user table (a feature or tile table) and all GeoPackage metadata quietly
protected void	dropSQLiteTriggers(GeometryColumns geometryColumns) GeoPackages created with SQLite version 4.2.0+ with GeoPackage support can contain triggers and functions that are not supported in previous versions.
void	dropTable(String table) Drop the table if it exists.
ContentsDao	getContentsDao() Get a Contents DAO
GeoPackageCoreConnection	getDatabase() Get the SQLite database
DataColumnConstraintsDao	getDataColumnConstraintsDao() Get a Data Column Constraints DAO
DataColumnsDao	getDataColumnsDao() Get a Data Columns DAO
ExtensionsDao	getExtensionsDao() Get an Extensions DAO
List<String>	getFeatureTables() Get the feature tables
FeatureTileLinkDao	getFeatureTileLinkDao() Get a Feature Tile Link DAO
GeometryColumnsDao	getGeometryColumnsDao() Get a Geometry Columns DAO
GeometryColumnsSfSqlDao	getGeometryColumnsSfSqlDao() Get a SF/SQL Geometry Columns DAO
GeometryColumnsSqlMmDao	getGeometryColumnsSqlMmDao() Get a SQL/MM Geometry Columns DAO
GeometryIndexDao	getGeometryIndexDao() Get a Geometry Index DAO
MetadataDao	getMetadataDao() Get a Metadata DAO
MetadataReferenceDao	getMetadataReferenceDao() Get a Metadata Reference DAO
String	getName() Get the GeoPackage name
String	getPath() Get the GeoPackage path
SpatialReferenceSystemDao	getSpatialReferenceSystemDao() Get a Spatial Reference System DAO
SpatialReferenceSystemSfSqlDao	getSpatialReferenceSystemSfSqlDao() Get a SF/SQL Spatial Reference System DAO
SpatialReferenceSystemSqlMmDao	getSpatialReferenceSystemSqlMmDao() Get a SQL/MM Spatial Reference System DAO
TableIndexDao	getTableIndexDao() Get a Table Index DAO
List<String>	getTables() Get the feature and tile tables
TileMatrixDao	getTileMatrixDao() Get a Tile Matrix DAO
TileMatrixSetDao	getTileMatrixSetDao() Get a Tile Matrix Set DAO
List<String>	getTileTables() Get the tile tables
boolean	isFeatureOrTileTable(String table) Check if the table exists as a feature or tile table
boolean	isFeatureTable(String table) Check if the table is a feature table
boolean	isTileTable(String table) Check if the table is a tile table
boolean	isWritable() Is the GeoPackage writable
void	verifyWritable() Verify the GeoPackage is writable and throw an exception if it is not

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface mil.nga.geopackage.GeoPackageCore

execSQL

Constructor Detail

GeoPackageCoreImpl

protected GeoPackageCoreImpl(String name,
                             String path,
                             GeoPackageCoreConnection database,
                             GeoPackageTableCreator tableCreator,
                             boolean writable)

Constructor

Parameters:

name -

path -

database -

connectionSource -

tableCreator -

writable -

Method Detail

close

public void close()

Close the GeoPackage connection

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface GeoPackageCore

getName

public String getName()

Get the GeoPackage name

Specified by:

getName in interface GeoPackageCore

Returns:

getPath

public String getPath()

Get the GeoPackage path

Specified by:

getPath in interface GeoPackageCore

Returns:

getDatabase

public GeoPackageCoreConnection getDatabase()

Get the SQLite database

Specified by:

getDatabase in interface GeoPackageCore

Returns:

isWritable

public boolean isWritable()

Is the GeoPackage writable

Specified by:

isWritable in interface GeoPackageCore

Returns:

getFeatureTables

public List<String> getFeatureTables()

Get the feature tables

Specified by:

getFeatureTables in interface GeoPackageCore

Returns:

getTileTables

public List<String> getTileTables()

Get the tile tables

Specified by:

getTileTables in interface GeoPackageCore

Returns:

getTables

public List<String> getTables()

Get the feature and tile tables

Specified by:

getTables in interface GeoPackageCore

Returns:

feature and tile table names

isFeatureTable

public boolean isFeatureTable(String table)

Check if the table is a feature table

Specified by:

isFeatureTable in interface GeoPackageCore

Parameters:

table - table name

Returns:

true if a feature table

isTileTable

public boolean isTileTable(String table)

Check if the table is a tile table

Specified by:

isTileTable in interface GeoPackageCore

Parameters:

table - table name

Returns:

true if a tile table

isFeatureOrTileTable

public boolean isFeatureOrTileTable(String table)

Check if the table exists as a feature or tile table

Specified by:

isFeatureOrTileTable in interface GeoPackageCore

Parameters:

table - table name

Returns:

true if a feature or tile table

getSpatialReferenceSystemDao

public SpatialReferenceSystemDao getSpatialReferenceSystemDao()

Get a Spatial Reference System DAO

Specified by:

getSpatialReferenceSystemDao in interface GeoPackageCore

Returns:

getSpatialReferenceSystemSqlMmDao

public SpatialReferenceSystemSqlMmDao getSpatialReferenceSystemSqlMmDao()

Get a SQL/MM Spatial Reference System DAO

Specified by:

getSpatialReferenceSystemSqlMmDao in interface GeoPackageCore

Returns:

getSpatialReferenceSystemSfSqlDao

public SpatialReferenceSystemSfSqlDao getSpatialReferenceSystemSfSqlDao()

Get a SF/SQL Spatial Reference System DAO

Specified by:

getSpatialReferenceSystemSfSqlDao in interface GeoPackageCore

Returns:

getContentsDao

public ContentsDao getContentsDao()

Get a Contents DAO

Specified by:

getContentsDao in interface GeoPackageCore

Returns:

getGeometryColumnsDao

public GeometryColumnsDao getGeometryColumnsDao()

Get a Geometry Columns DAO

Specified by:

getGeometryColumnsDao in interface GeoPackageCore

Returns:

getGeometryColumnsSqlMmDao

public GeometryColumnsSqlMmDao getGeometryColumnsSqlMmDao()

Get a SQL/MM Geometry Columns DAO

Specified by:

getGeometryColumnsSqlMmDao in interface GeoPackageCore

Returns:

getGeometryColumnsSfSqlDao

public GeometryColumnsSfSqlDao getGeometryColumnsSfSqlDao()

Get a SF/SQL Geometry Columns DAO

Specified by:

getGeometryColumnsSfSqlDao in interface GeoPackageCore

Returns:

createGeometryColumnsTable

public boolean createGeometryColumnsTable()

Create the Geometry Columns table if it does not already exist

Specified by:

createGeometryColumnsTable in interface GeoPackageCore

Returns:

true if created

createFeatureTable

public void createFeatureTable(FeatureTable table)

Create a new feature table

Specified by:

createFeatureTable in interface GeoPackageCore

createFeatureTableWithMetadata

public GeometryColumns createFeatureTableWithMetadata(GeometryColumns geometryColumns,
                                                      BoundingBox boundingBox,
                                                      long srsId)

Create a new feature table with GeoPackage metadata. Create the Geometry Columns table if needed, create a user feature table, create a new Contents, insert the new Geometry Columns. The user feature table will be created with 2 columns, an id column named "id" and a geometry column using GeometryColumns.getColumnName().

Specified by:

createFeatureTableWithMetadata in interface GeoPackageCore

Parameters:

geometryColumns - geometry columns to create

boundingBox - contents bounding box

srsId - spatial reference system id

Returns:

geometry columns

createFeatureTableWithMetadata

public GeometryColumns createFeatureTableWithMetadata(GeometryColumns geometryColumns,
                                                      String idColumnName,
                                                      BoundingBox boundingBox,
                                                      long srsId)

Create a new feature table with GeoPackage metadata. Create the Geometry Columns table if needed, create a user feature table, create a new Contents, insert the new Geometry Columns. The user feature table will be created with 2 columns, an id column with the provided name and a geometry column using GeometryColumns.getColumnName().

Specified by:

createFeatureTableWithMetadata in interface GeoPackageCore

Parameters:

geometryColumns - geometry columns to create

idColumnName - id column name

boundingBox - contents bounding box

srsId - spatial reference system id

Returns:

geometry columns

createFeatureTableWithMetadata

public GeometryColumns createFeatureTableWithMetadata(GeometryColumns geometryColumns,
                                                      List<FeatureColumn> additionalColumns,
                                                      BoundingBox boundingBox,
                                                      long srsId)

Create a new feature table with GeoPackage metadata. Create the Geometry Columns table if needed, create a user feature table, create a new Contents, insert the new Geometry Columns. The user feature table will be created with 2 + additionalColumns.size() columns, an id column named "id", a geometry column using GeometryColumns.getColumnName(), and the provided additional columns.

Specified by:

createFeatureTableWithMetadata in interface GeoPackageCore

Parameters:

geometryColumns - geometry columns to create

additionalColumns - additional user feature table columns to create in addition to id and geometry columns

boundingBox - contents bounding box

srsId - spatial reference system id

Returns:

geometry columns

createFeatureTableWithMetadata

public GeometryColumns createFeatureTableWithMetadata(GeometryColumns geometryColumns,
                                                      String idColumnName,
                                                      List<FeatureColumn> additionalColumns,
                                                      BoundingBox boundingBox,
                                                      long srsId)

Create a new feature table with GeoPackage metadata. Create the Geometry Columns table if needed, create a user feature table, create a new Contents, insert the new Geometry Columns. The user feature table will be created with 2 + additionalColumns.size() columns, an id column with the provided name, a geometry column using GeometryColumns.getColumnName(), and the provided additional columns.

Specified by:

createFeatureTableWithMetadata in interface GeoPackageCore

Parameters:

geometryColumns - geometry columns to create

idColumnName - id column name

additionalColumns - additional user feature table columns to create in addition to id and geometry columns

boundingBox - contents bounding box

srsId - spatial reference system id

Returns:

geometry columns

createFeatureTableWithMetadata

public GeometryColumns createFeatureTableWithMetadata(GeometryColumns geometryColumns,
                                                      BoundingBox boundingBox,
                                                      long srsId,
                                                      List<FeatureColumn> columns)

Create a new feature table with GeoPackage metadata. Create the Geometry Columns table if needed, create a user feature table, create a new Contents, insert the new Geometry Columns. The user feature table will be created using only the provided columns. These should include the id column and the geometry column defined in GeometryColumns.getColumnName()

Specified by:

createFeatureTableWithMetadata in interface GeoPackageCore

Parameters:

geometryColumns - geometry columns to create

boundingBox - contents bounding box

srsId - spatial reference system id

columns - user feature table columns to create

Returns:

geometry columns

getTileMatrixSetDao

public TileMatrixSetDao getTileMatrixSetDao()

Get a Tile Matrix Set DAO

Specified by:

getTileMatrixSetDao in interface GeoPackageCore

Returns:

createTileMatrixSetTable

public boolean createTileMatrixSetTable()

Create the Tile Matrix Set table if it does not already exist

Specified by:

createTileMatrixSetTable in interface GeoPackageCore

Returns:

true if created

getTileMatrixDao

public TileMatrixDao getTileMatrixDao()

Get a Tile Matrix DAO

Specified by:

getTileMatrixDao in interface GeoPackageCore

Returns:

createTileMatrixTable

public boolean createTileMatrixTable()

Create the Tile Matrix table if it does not already exist

Specified by:

createTileMatrixTable in interface GeoPackageCore

Returns:

true if created

createTileTable

public void createTileTable(TileTable table)

Create a new tile table

Specified by:

createTileTable in interface GeoPackageCore

createTileTableWithMetadata

public TileMatrixSet createTileTableWithMetadata(String tableName,
                                                 BoundingBox contentsBoundingBox,
                                                 long contentsSrsId,
                                                 BoundingBox tileMatrixSetBoundingBox,
                                                 long tileMatrixSetSrsId)

Create a new tile table and the GeoPackage metadata

Specified by:

createTileTableWithMetadata in interface GeoPackageCore

Returns:

tile matrix set

getDataColumnsDao

public DataColumnsDao getDataColumnsDao()

Get a Data Columns DAO

Specified by:

getDataColumnsDao in interface GeoPackageCore

Returns:

createDataColumnsTable

public boolean createDataColumnsTable()

Create the Data Columns table if it does not already exist

Specified by:

createDataColumnsTable in interface GeoPackageCore

Returns:

true if created

getDataColumnConstraintsDao

public DataColumnConstraintsDao getDataColumnConstraintsDao()

Get a Data Column Constraints DAO

Specified by:

getDataColumnConstraintsDao in interface GeoPackageCore

Returns:

createDataColumnConstraintsTable

public boolean createDataColumnConstraintsTable()

Create the Data Column Constraints table if it does not already exist

Specified by:

createDataColumnConstraintsTable in interface GeoPackageCore

Returns:

true if created

getMetadataDao

public MetadataDao getMetadataDao()

Get a Metadata DAO

Specified by:

getMetadataDao in interface GeoPackageCore

Returns:

createMetadataTable

public boolean createMetadataTable()

Create the Metadata table if it does not already exist

Specified by:

createMetadataTable in interface GeoPackageCore

Returns:

getMetadataReferenceDao

public MetadataReferenceDao getMetadataReferenceDao()

Get a Metadata Reference DAO

Specified by:

getMetadataReferenceDao in interface GeoPackageCore

Returns:

createMetadataReferenceTable

public boolean createMetadataReferenceTable()

Create the Metadata Reference table if it does not already exist

Specified by:

createMetadataReferenceTable in interface GeoPackageCore

Returns:

getExtensionsDao

public ExtensionsDao getExtensionsDao()

Get an Extensions DAO

Specified by:

getExtensionsDao in interface GeoPackageCore

Returns:

createExtensionsTable

public boolean createExtensionsTable()

Create the Extensions table if it does not already exist

Specified by:

createExtensionsTable in interface GeoPackageCore

Returns:

deleteTable

public void deleteTable(String table)

Delete the user table (a feature or tile table) and all GeoPackage metadata

Specified by:

deleteTable in interface GeoPackageCore

deleteTableQuietly

public void deleteTableQuietly(String tableName)

Attempt to delete the user table (a feature or tile table) and all GeoPackage metadata quietly

Specified by:

deleteTableQuietly in interface GeoPackageCore

dropSQLiteTriggers

protected void dropSQLiteTriggers(GeometryColumns geometryColumns)

GeoPackages created with SQLite version 4.2.0+ with GeoPackage support can contain triggers and functions that are not supported in previous versions. In order to edit tables, these triggers need to be dropped. It might be possible to define the missing functions as an alternative. In Android, this would require SQLite C through NDK.

Parameters:

geometryColumns -

createDao

public <T,S extends BaseDaoImpl<T,?>> S createDao(Class<T> type)

Create a dao

Specified by:

createDao in interface GeoPackageCore

Returns:

base dao implementation

verifyWritable

public void verifyWritable()

Verify the GeoPackage is writable and throw an exception if it is not

Specified by:

verifyWritable in interface GeoPackageCore

dropTable

public void dropTable(String table)

Drop the table if it exists. Drops the table with the table name, not limited to GeoPackage specific tables.

Specified by:

dropTable in interface GeoPackageCore

getTableIndexDao

public TableIndexDao getTableIndexDao()

Get a Table Index DAO

Specified by:

getTableIndexDao in interface GeoPackageCore

Returns:

table index dao

createTableIndexTable

public boolean createTableIndexTable()

Create the Table Index Table if it does not exist

Specified by:

createTableIndexTable in interface GeoPackageCore

Returns:

true if created

getGeometryIndexDao

public GeometryIndexDao getGeometryIndexDao()

Get a Geometry Index DAO

Specified by:

getGeometryIndexDao in interface GeoPackageCore

Returns:

geometry index dao

createGeometryIndexTable

public boolean createGeometryIndexTable()

Create Geometry Index Table if it does not exist

Specified by:

createGeometryIndexTable in interface GeoPackageCore

Returns:

true if created

getFeatureTileLinkDao

public FeatureTileLinkDao getFeatureTileLinkDao()

Get a Feature Tile Link DAO

Specified by:

getFeatureTileLinkDao in interface GeoPackageCore

Returns:

feature tile link dao

createFeatureTileLinkTable

public boolean createFeatureTileLinkTable()

Create the Feature Tile Link Table if it does not exist

Specified by:

createFeatureTileLinkTable in interface GeoPackageCore

Returns:

true if created