Specializzazione di una connessione per sorgenti dati vettoriali. Continua...

#include <ConnectionVector.hpp>

Diagramma delle classi per fire::source::vector::ConnectionVector

Tipi pubblici
typedef shared::ConnectionVectorSh	ConnectionVectorShp

Tipi pubblici ereditati da fire::source::Connection
enum	paramName { HOST = 1, DATASOURCE = 2, USER = 3, PASSWORD = 4, PORT = 5 }

typedef std::map< int, std::string >	ConnectionParams

typedef std::vector< std::string >	LayerList

typedef shared::ConnectionSh	ConnectionShp

Tipi pubblici ereditati da fire::Object
typedef boost::unique_lock < boost::mutex >	LockGuard
	Guardia per la sincronizzazione dell'oggetto.

Membri pubblici
	ConnectionVector ()
	Costruttore oggetto.

virtual	~ConnectionVector ()
	Distruttore oggetto. Nel caso fosse aperta la connessione verrà chiusa richiamando il metodo close.

virtual VectorLayerInfo::VectorLayerInfoShp	getLayerInfo (std::string const &name) const =0
	Estrae le informazioni relative ad un contenitore di dati vettoriali. Continua...

virtual DataSet::DataSetShp const	getData (const std::string &schema, std::string const &tbl) const =0
	Interroga il livello tematico restituendo un cursore sui dati in sola lettura. Continua...

virtual DataSet::DataSetShp	getData (const std::string &schema, std::string const &tbl)=0
	Interroga il livello tematico restituendo un cursore sui dati. Continua...

virtual DataSet::DataSetShp const	getData (const std::string &schema, std::string const &tbl, gear::geom::Envelope::EnvelopeShp const &rect) const =0
	Interroga il livello tematico restituendo un cursore sui dati. Continua...

virtual DataSet::DataSetShp	getData (const std::string &schema, std::string const &tbl, gear::geom::Envelope::EnvelopeShp const &rect)=0
	Interroga il livello tematico restituendo un cursore sui dati. Continua...

virtual DataSet::DataSetShp const	execQuery (std::string const &query, const DataRow::MapSqlParam &params=DataRow::MapSqlParam()) const =0
	Esegue una interrogazione restituendo un cursore sui dati. Continua...

virtual DataSet::DataSetShp	execQuery (std::string const &query, const DataRow::MapSqlParam &params=DataRow::MapSqlParam())=0
	Esegue una interrogazione restituendo un cursore sui dati. Continua...

virtual void	execUpdate (std::string const &query)
	Esegue una interrogazione di modifica (INSERIMENTO, MODIFICA O CANCELLAZIONE) sul contenitore dei dati. Continua...

virtual void	execUpdate (std::string const &query, DataRow::MapSqlParam const &params)=0
	Esegue una interrogazione di modifica (INSERIMENTO, MODIFICA O CANCELLAZIONE) sul contenitore dei dati. Continua...

virtual ConnectionType::ConnectionType	getType () const
	getType Continua...

virtual VectorLayerInfo::VectorLayerInfoShp	createTable (const Metadata::MetadataShp &mtd)
	createTable Continua...

virtual VectorLayerInfo::VectorLayerInfoShp	createTable (const Metadata::MetadataShp &mtd, const source::vector::VectorLayerInfo::VctEnvelope &extents)=0
	crea una nuova tabella geografica sulla sorgente dati allineando il catalogo spaziale Continua...

virtual void	eraseTable (const std::string &schema, const std::string &tbl, const VectorLayerType::VectorLayerType vlt)=0
	Rimuove completamente una tabella dalla connessione vettoriale. Continua...

virtual void	saveOrUpdate (DataRow &row)=0
	Salva la row sulla tabella e nella connessione dati indicata nell'istanza fire::source::vector::Metadata della row stessa. Il metodo effettua sulla sorgente dati una interrogazione per verificare la presenza/assenza della riga e decidere se effettuare un update oppura una insert. La presenza viene effettuata cercando una riga con un valore di chiave primaria uguale a quello della row. La presenza della chiave primaria è obbligatoria per concludere la chiamata con successo. Continua...

virtual void	insert (DataRow &row)=0
	Inserisce una nuova riga con i parametri scritti in row all'interno della tabella che si trova nella sorgente dati indicata nell'istanza fire::source::vector::Metadata della row stessa. Continua...

virtual void	update (DataRow &row)=0
	Aggiorna la riga con i parametri scritti in row. La tabella e la sorgente dati che verranno aggiornate, sono indicate nell'istanza fire::source::vector::Metadata della row stessa. Continua...

virtual void	erase (const DataRow &row)=0
	Elimina dalla sorgente dati la riga indicata. Continua...

Membri pubblici ereditati da fire::source::Connection
	Connection ()
	Costruttore oggetto.

virtual	~Connection ()
	Distruttore oggetto. Nel caso fosse aperta la connessione, essa verrà chiusa richiamando il metodo fire::data::Connection::close.

Membri pubblici ereditati da fire::Object
	Object ()
	Costruttore.

	Object (const Object &object)
	Costruttore di copia. Continua...

fire::Object &	operator= (const fire::Object &object)
	Operatore di assegnamento. Continua...

virtual	~Object ()
	Distruttore.

virtual fire::Class < fire::Object > *	getClass () const
	Restituisce la classe dell'oggetto. Continua...

virtual bool	equals (const Object &object) const
	Restituisce l'indicazione se l'oggetto è uguale ad un altro oggetto. Continua...

virtual bool	operator== (const Object &object) const
	Operatore di uguaglianza. Continua...

std::size_t	hashCode () const
	Restituisce il codice dell'oggetto. Continua...

void	notify () const
	Notifica.

void	notifyAll () const
	Notifica tutti.

virtual std::string	toString () const
	Restituisce la rappresentazione alfabetica dell'oggetto. Continua...

void	wait () const
	Aspetta.

void	waitFor (std::size_t timeout) const
	Aspetta per un determinato tempo (in millisecondi) Continua...

void	waitFor (std::size_t timeout, int nanos) const
	Aspetta per un determinato tempo (in millisecondi) Continua...

virtual bool	operator< (const Object &object) const
	Operatore di minoranza. Continua...

Altri membri ereditati

Membri pubblici statici ereditati da fire::source::Connection

static std::string idFromParams (Connection::ConnectionParams const &params)

Costruisceun stringa univoca basandosi sui parametri di connessione di una Connection. Continua...

Membri protetti ereditati da fire::source::Connection

ConnectionParams const & getConnectionString () const

Restituisce i parametri usati per la connessione alla sorgente dati. Continua...

void open ()

Apre la connessione alla sorgente dati

Eccezioni

fire::plugin::data::exception::ConnectionException se l'apertura non viene eseguita.

void open (ConnectionParams const &cnnStr)

Apre la connessione alla sorgente dati usando la stringa di connessione indicata

Eccezioni

fire::plugin::data::exception::ConnectionException se l'apertura non viene eseguita.

Continua...

bool isOpen () const

Indica se la connessione risulta aperta. Continua...

virtual bool isValid () const =0

Indica se la connessione risulta operativa. Continua...

void close ()

Chiude la connessione alla sorgente dati, rilasciando le risorse allocate.

virtual Features const getFeatures () const =0

Restituisce un oggetto indicante le caratteristiche supportate da questa connessione. Continua...

virtual LayerList getLayers () const =0

Restituisce la lista degli identificativi testuali dei livelli tematici presenti nella connessione. Continua...

virtual std::string getNamespace () const =0

Restituisce il namespace univoco che identifica l'istanza concreta dell'oggetto Connection. Continua...

void setId (const std::string &pool, const std::string &id)

Valorizza l'identificativo del fire::gis::data::ConnectionPool e delle istanza di Connection attribuiti ad essa quando viene inserita all'interno di un pool pool - valore testuale identificante il fire::gis::data::ConnectionPool in cui la connessione è inserita id - valore testuale identificante l'istanza di Connection all'interno del pool.

std::string getId () const

Valore testuale identificante l'istanza di Connection all'interno del pool. Continua...

std::string getInstanceId () const

Valore testuale identificante l'istanza di Connection a livello di sessione. Continua...

std::string getPoolId () const

getPoolId Continua...

void setConnectionString (const Connection::ConnectionParams &val)

Imposta la stringa di connessione secondo le specifiche indicate dalla implementazione concreta della connessione dati. Continua...

virtual void _openNoWait ()=0

virtual void _closeNoWait ()=0

const ConnectionParams & _getConnectionStringNoWait () const

const std::string _readParam (ConnectionParams const &pars, unsigned int const &name) const

Estrae un parametro per nome interpretandolo come stringa. Continua...

const int _readIntParam (ConnectionParams const &pars, unsigned int const &name) const

Estrae un parametro per nome interpretandolo come intero. Continua...

std::string _getPoolIdNoWait () const

std::string _getInstanceIdNoWait () const

virtual bool _isOpenNoWait () const

Membri protetti ereditati da fire::Object

Object * clone () const

Duplica l'oggetto. Continua...

void finalize ()

Finalizza l'oggetto.

Attributi protetti ereditati da fire::source::Connection

bool _isOpen

fire::logging::Logger * _log

boost::mutex _mtx

Attributi protetti ereditati da fire::Object

boost::mutex mutex

Variabile per la sincronizzazione dell'oggetto.

Descrizione dettagliata

Specializzazione di una connessione per sorgenti dati vettoriali.

Documentazione delle funzioni membro

virtual VectorLayerInfo::VectorLayerInfoShp fire::source::vector::ConnectionVector::createTable ( const Metadata::MetadataShp & mtd )

virtual

createTable

Parametri

mtd	- Metadato contenente la struttura della tabella dati da creare

Restituisce: Istanza di source::vector::VectorLayerInfo con le informazioni di dettaglio della tabella creata

virtual VectorLayerInfo::VectorLayerInfoShp fire::source::vector::ConnectionVector::createTable	(	const Metadata::MetadataShp &	mtd,
		const source::vector::VectorLayerInfo::VctEnvelope &	extents
	)

pure virtual

crea una nuova tabella geografica sulla sorgente dati allineando il catalogo spaziale

Parametri

mtd	- istanza condivisa di fire::source::vector::Metadata descrivente la struttura del livello da creare
extents	- lista eventualmente vuota degli ingombri delle colonne geografiche presenti nei metadati

Restituisce: istanza di fire::source::vector::VectorLayerInfo che descrive il nuovo livello creato

Implementato in fire::connection::qt::ConnectionQtSql.

virtual void fire::source::vector::ConnectionVector::erase ( const DataRow & row )

pure virtual

Elimina dalla sorgente dati la riga indicata.

Parametri

row	- riga da eliminare

Implementato in fire::source::vector::ConnectionSpatialDb.

virtual void fire::source::vector::ConnectionVector::eraseTable	(	const std::string &	schema,
		const std::string &	tbl,
		const VectorLayerType::VectorLayerType	vlt
	)

pure virtual

Rimuove completamente una tabella dalla connessione vettoriale.

Parametri

schema	- std::string con lo schema di appartenenza della tabella da rimuovere
tbl	- std:::string identificante la tabella da rimuovere
vlt	- tipologia fire::source::vector::VectorLayerType::VectorLayerType descrivente l'elemento da cancellare

Implementato in fire::connection::qt::ConnectionQtPostgres, e fire::connection::qt::ConnectionQtOracle.

virtual DataSet::DataSetShp const fire::source::vector::ConnectionVector::execQuery	(	std::string const &	query,
		const DataRow::MapSqlParam &	params = `DataRow::MapSqlParam()`
	)		const

pure virtual

Esegue una interrogazione restituendo un cursore sui dati.

Parametri

query - valore testuale con il testo SQL da eseguire

Restituisce: puntatore condiviso in sola lettura su un oggetto DataSet

Implementato in fire::connection::qt::ConnectionQtSql.

virtual DataSet::DataSetShp fire::source::vector::ConnectionVector::execQuery	(	std::string const &	query,
		const DataRow::MapSqlParam &	params = `DataRow::MapSqlParam()`
	)

pure virtual

Esegue una interrogazione restituendo un cursore sui dati.

Parametri

query - valore testuale con il testo SQL da eseguire

Restituisce: puntatore condiviso su un oggetto DataSet

Implementato in fire::connection::qt::ConnectionQtSql.

virtual void fire::source::vector::ConnectionVector::execUpdate ( std::string const & query )

virtual

Esegue una interrogazione di modifica (INSERIMENTO, MODIFICA O CANCELLAZIONE) sul contenitore dei dati.

Parametri

query - valore testuale con il testo SQL da eseguire

Restituisce: valore booleano true se e solo se l'esecuzione del comando si è conclusa con successo

virtual void fire::source::vector::ConnectionVector::execUpdate	(	std::string const &	query,
		DataRow::MapSqlParam const &	params
	)

pure virtual

Esegue una interrogazione di modifica (INSERIMENTO, MODIFICA O CANCELLAZIONE) sul contenitore dei dati.

Parametri

query	- valore testuale con il testo SQL da eseguire
params	- Mappa di coppie std::string, fire::source::vector::DataValue::DataValueShp

Restituisce: valore booleano true se e solo se l'esecuzione del comando si è conclusa con successo

Implementato in fire::connection::qt::ConnectionQtSql.

virtual DataSet::DataSetShp const fire::source::vector::ConnectionVector::getData	(	const std::string &	schema,
		std::string const &	tbl
	)		const

pure virtual

Interroga il livello tematico restituendo un cursore sui dati in sola lettura.

Parametri

tbl	- valore testuale con il nome del livello tematico di interesse

Restituisce: puntatore condiviso in sola lettura su un oggetto DataSet

Implementato in fire::connection::qt::ConnectionQtSql.

virtual DataSet::DataSetShp fire::source::vector::ConnectionVector::getData	(	const std::string &	schema,
		std::string const &	tbl
	)

pure virtual

Interroga il livello tematico restituendo un cursore sui dati.

Parametri

tbl	- valore testuale con il nome del livello tematico di interesse

Restituisce: puntatore condiviso su un oggetto DataSet

Implementato in fire::connection::qt::ConnectionQtSql.

virtual DataSet::DataSetShp const fire::source::vector::ConnectionVector::getData	(	const std::string &	schema,
		std::string const &	tbl,
		gear::geom::Envelope::EnvelopeShp const &	rect
	)		const

pure virtual

Interroga il livello tematico restituendo un cursore sui dati.

Parametri

tbl	- valore testuale con il nome del livello tematico di interesse
rect	- Riferimento al rettangolo di interesse. Saranno estratti dalla sorgente dati, solo gli elementi che hanno uno dei campi geometrici che ha intersezione non vuota con il rettangolo di interesse

Restituisce: puntatore condiviso in sola lettura su un oggetto DataSet

Implementato in fire::connection::qt::ConnectionQtSql.

virtual DataSet::DataSetShp fire::source::vector::ConnectionVector::getData	(	const std::string &	schema,
		std::string const &	tbl,
		gear::geom::Envelope::EnvelopeShp const &	rect
	)

pure virtual

Interroga il livello tematico restituendo un cursore sui dati.

Parametri

tbl	- valore testuale con il nome del livello tematico di interesse
rect	- Riferimento al rettangolo di interesse. Saranno estratti dalla sorgente dati, solo gli elementi che hanno uno dei campi geometrici che ha intersezione non vuota con il rettangolo di interesse

Restituisce: puntatore condiviso su un oggetto DataSet

Implementato in fire::connection::qt::ConnectionQtSql.

virtual VectorLayerInfo::VectorLayerInfoShp fire::source::vector::ConnectionVector::getLayerInfo ( std::string const & name ) const

pure virtual

Estrae le informazioni relative ad un contenitore di dati vettoriali.

Parametri

name	- valore testuale che identifica il livello tematico di interesse

Restituisce: un puntatore condiviso ad un oggetto VectorLayerInfo

Implementato in fire::connection::qt::ConnectionQtSql.

virtual ConnectionType::ConnectionType fire::source::vector::ConnectionVector::getType ( ) const

virtual

getType

Restituisce: Restituisce il tipo di connessione vettoriale. Vedi fire::source::ConnectionType come insieme di valori

Reimplementa fire::source::Connection.

Reimplementata in fire::source::vector::ConnectionSpatialDb.

virtual void fire::source::vector::ConnectionVector::insert ( DataRow & row )

pure virtual

Inserisce una nuova riga con i parametri scritti in row all'interno della tabella che si trova nella sorgente dati indicata nell'istanza fire::source::vector::Metadata della row stessa.

Parametri

row	- riga da inserire

Si veda anche: fire::source::vector::Metadata::getSource, fire::source::vector::Metadata::setSource

Implementato in fire::source::vector::ConnectionSpatialDb.

virtual void fire::source::vector::ConnectionVector::saveOrUpdate ( DataRow & row )

pure virtual

Salva la row sulla tabella e nella connessione dati indicata nell'istanza fire::source::vector::Metadata della row stessa. Il metodo effettua sulla sorgente dati una interrogazione per verificare la presenza/assenza della riga e decidere se effettuare un update oppura una insert. La presenza viene effettuata cercando una riga con un valore di chiave primaria uguale a quello della row. La presenza della chiave primaria è obbligatoria per concludere la chiamata con successo.

Parametri

row	- riga da salvare

Si veda anche: fire::source::vector::Metadata::getSource, fire::source::vector::Metadata::setSource

Implementato in fire::source::vector::ConnectionSpatialDb.

virtual void fire::source::vector::ConnectionVector::update ( DataRow & row )

pure virtual

Aggiorna la riga con i parametri scritti in row. La tabella e la sorgente dati che verranno aggiornate, sono indicate nell'istanza fire::source::vector::Metadata della row stessa.

Parametri

row	- riga da inserire

Si veda anche: fire::source::vector::Metadata::getSource, fire::source::vector::Metadata::setSource

Implementato in fire::source::vector::ConnectionSpatialDb.

La documentazione per questa classe è stata generata a partire dal seguente file:

/home/luca/Scrivania/FIRE8/core/include/fire/source/vector/ConnectionVector.hpp

Tipi pubblici

Membri pubblici

Altri membri ereditati

Descrizione dettagliata

Documentazione delle funzioni membro