It models a foreign key constraint for a DataSetType. More...

#include <ForeignKey.h>

Inheritance diagram for te::da::ForeignKey:

Public Member Functions
void	add (te::dt::Property *p)
	It adds a property to the foreign key constraint. More...

void	addRefProperty (te::dt::Property *p)
	It adds a reference property (on the referenced DataSetType) of this foreign key constraint. More...

Constraint *	clone ()
	It returns a clone of the object. More...

	ForeignKey (unsigned int id=0)
	Constructor. More...

	ForeignKey (const std::string &name, unsigned int id=0)
	Constructor. More...

	ForeignKey (const ForeignKey &rhs)
	Copy constructor not allowed. More...

virtual DataSetType *	getDataSetType () const
	It returns the DataSetType associated to the constraint. More...

virtual unsigned int	getId () const
	It returns the constraint identifier. More...

virtual const std::string &	getName () const
	It returns the constraint name. More...

FKActionType	getOnDeleteAction () const
	It returns the action performed when a referenced element value in the referenced DataSetType is being deleted. More...

FKActionType	getOnUpdateAction () const
	It returns the action performed when a referenced element value in the referenced DataSetType is being updated to a new value. More...

const std::vector < te::dt::Property * > &	getProperties () const
	It returns the properties that take part of the foreign key constraint. More...

DataSetType *	getReferencedDataSetType () const
	It returns the referenced DataSetType of this foreign key constraint. More...

const std::vector < te::dt::Property * > &	getReferencedProperties () const
	It returns the referenced properties (on the referenced DataSetType) of this foreign key constraint. More...

ConstraintType	getType () const
	It returns the constraint type: FOREIGNKEY. More...

bool	has (te::dt::Property *p)
	It verifies if Property takes part of the foreign key. More...

bool	isReferenced (te::dt::Property *p)
	It verifies if Property is referenced by the foreign key. More...

ForeignKey &	operator= (const ForeignKey &rhs)
	Assignment operator. More...

void	replace (te::dt::Property p, te::dt::Property pp)
	It changes a reference to property p to pp. More...

virtual void	setDataSetType (DataSetType *dt)
	It sets the DataSetType associated to the constraint. More...

virtual void	setId (unsigned int id)
	It sets the constraint identifier. More...

virtual void	setName (const std::string &name)
	It sets the constraint name. More...

void	setOnDeleteAction (FKActionType a)
	It sets the action to be performed when a referenced element value in the referenced DataSetType is being deleted. More...

void	setOnUpdateAction (FKActionType a)
	It sets the action to be performed when a referenced element value in the referenced DataSetType is being updated to a new value. More...

void	setProperties (const std::vector< te::dt::Property * > &properties)
	It sets the properties that take part of the foreign key constraint. More...

void	setReferencedDataSetType (DataSetType *refDt)
	It sets the referenced DataSetType of this foreign key constraint. More...

void	setReferencedProperties (const std::vector< te::dt::Property * > &properties)
	It sets the referenced properties (on the referenced DataSetType) of this foreign key constraint. More...

	~ForeignKey ()
	Destructor. More...

Private Attributes
FKActionType	m_onDelete
	The action to be performed when a referenced element value in the referenced DataSetType is being deleted. More...

FKActionType	m_onUpdate
	The action to be performed when a referenced element value in the referenced DataSetType is being updated to a new value. More...

std::vector< te::dt::Property * >	m_properties
	The properties that are part of the foreign key constraint. More...

DataSetType *	m_refDt
	The referenced DataSetType of this foreign key constraint. More...

std::vector< te::dt::Property * >	m_refProperties
	The referenced properties (on the referenced DataSetType) of this foreign key constraint. More...

Detailed Description

It models a foreign key constraint for a DataSetType.

See also: DataSetType, PrimaryKey, UniqueKey, CheckConstraint

Definition at line 50 of file ForeignKey.h.

Constructor & Destructor Documentation

te::da::ForeignKey::ForeignKey ( unsigned int id = 0 )

Constructor.

The default fk will have the actions OnDelete and OnUpdate set as NO_ACTION.

Parameters

id	The fk identifier.

Warning: The identifier value (id) may be used by data source implementations. So, don't rely on its value!

Definition at line 31 of file ForeignKey.cpp.

te::da::ForeignKey::ForeignKey	(	const std::string &	name,
		unsigned int	id = `0`
	)

Constructor.

Parameters

name	The foreign key constraint name.
id	The fk identifier.

Warning: The identifier value (id) may be used by data source implementations. So, don't rely on its value!

Definition at line 39 of file ForeignKey.cpp.

te::da::ForeignKey::ForeignKey ( const ForeignKey & rhs )

Copy constructor not allowed.

The new object will not have an associated DataSetType.

Parameters

rhs	Right-hand-side instance.

Definition at line 48 of file ForeignKey.cpp.

te::da::ForeignKey::~ForeignKey ( )

inline

Destructor.

Definition at line 85 of file ForeignKey.h.

Member Function Documentation

void te::da::ForeignKey::add ( te::dt::Property * p )

inline

It adds a property to the foreign key constraint.

Parameters

p	The property to be added to the foreign key constraint.

Precondition: All properties added must belong to the same DataSetType.

Definition at line 112 of file ForeignKey.h.

Referenced by te::da::DataSetType::DataSetType(), te::pgis::Transactor::getConstraints(), and te::pgis::Transactor::getForeignKey().

void te::da::ForeignKey::addRefProperty ( te::dt::Property * p )

inline

It adds a reference property (on the referenced DataSetType) of this foreign key constraint.

Parameters

p	The referenced property (on the referenced DataSetType) of this foreign key constraint.

Precondition: All properties being added must reference the same DataSetType.

Definition at line 137 of file ForeignKey.h.

Referenced by te::pgis::Transactor::getConstraints(), and te::pgis::Transactor::getForeignKey().

te::da::Constraint * te::da::ForeignKey::clone ( )

virtual

It returns a clone of the object.

The new object will not have an associated DataSetType.

Returns: A clone of the object.

Implements te::da::Constraint.

Definition at line 125 of file ForeignKey.cpp.

virtual DataSetType* te::da::Constraint::getDataSetType ( ) const

inlinevirtualinherited

It returns the DataSetType associated to the constraint.

Returns: The DataSetType associated to the constraint.

Definition at line 133 of file Constraint.h.

Referenced by te::da::DataSourceCatalog::dropDependentFKs(), and te::da::DataSetType::remove().

virtual unsigned int te::da::Constraint::getId ( ) const

inlinevirtualinherited

It returns the constraint identifier.

Returns: A number that identifies the constraint.

Warning: The identifier value (id) may be used by data source implementations. So, don't rely on its value!

Definition at line 103 of file Constraint.h.

virtual const std::string& te::da::Constraint::getName ( ) const

inlinevirtualinherited

It returns the constraint name.

Returns: The constraint name.

Definition at line 119 of file Constraint.h.

Referenced by te::pgis::Transactor::addCheckConstraint(), te::qt::widgets::ConstraintsIndexesListWidget::addConstraint(), te::pgis::Transactor::addForeignKey(), te::pgis::Transactor::addPrimaryKey(), te::sqlite::DataSourceTransactor::addUniqueKey(), te::pgis::Transactor::addUniqueKey(), te::pgis::Transactor::createDataSet(), te::da::DataSetType::DataSetType(), te::da::DataSetTypeConverter::DataSetTypeConverter(), DSInfo::getCheckConstraintInfo(), te::pgis::Transactor::getConstraints(), te::attributefill::RasterToVector::getDataSetType(), DSInfo::getForeignKeyInfo(), te::sqlite::DataSourceCatalogLoader::getIndex(), te::pgis::Transactor::getIndexes(), te::pgis::Transactor::getPrimaryKey(), DSInfo::getPrimaryKeyInfo(), te::qt::widgets::TableLinkDialog::getProperties(), te::pgis::Transactor::getUniqueKey(), DSInfo::getUniqueKeyInfo(), te::qt::widgets::ConstraintsIndexesListWidget::onEditToolButtonClicked(), te::stmem::Transactor::primaryKeyExists(), te::qt::widgets::ConstraintsIndexesListWidget::removePrimaryKey(), te::qt::widgets::ConstraintsIndexesListWidget::removeUniqueKey(), te::qt::widgets::PrimaryKeyConstraintWidget::setConstraint(), and te::qt::widgets::UniqueKeyConstraintWidget::setConstraint().

FKActionType te::da::ForeignKey::getOnDeleteAction ( ) const

inline

It returns the action performed when a referenced element value in the referenced DataSetType is being deleted.

Returns: The action performed when a referenced element value in the referenced DataSetType is being deleted.

Definition at line 167 of file ForeignKey.h.

Referenced by te::pgis::Transactor::addForeignKey(), and te::da::DataSetType::DataSetType().

FKActionType te::da::ForeignKey::getOnUpdateAction ( ) const

inline

It returns the action performed when a referenced element value in the referenced DataSetType is being updated to a new value.

Returns: The action performed when a referenced element value in the referenced DataSetType is being updated to a new value.

Definition at line 181 of file ForeignKey.h.

Referenced by te::pgis::Transactor::addForeignKey(), and te::da::DataSetType::DataSetType().

const std::vector<te::dt::Property*>& te::da::ForeignKey::getProperties ( ) const

inline

It returns the properties that take part of the foreign key constraint.

Returns: The properties that take part of the foreign key constraint.

Definition at line 103 of file ForeignKey.h.

Referenced by te::ado::Transactor::addForeignKey(), te::pgis::Transactor::addForeignKey(), te::sqlite::DataSourceTransactor::createDataSet(), te::da::DataSetType::DataSetType(), and Utils::getFKPropertiesNames().

DataSetType* te::da::ForeignKey::getReferencedDataSetType ( ) const

inline

It returns the referenced DataSetType of this foreign key constraint.

Returns: The referenced DataSetType of this foreign key constraint.

Definition at line 153 of file ForeignKey.h.

Referenced by te::ado::Transactor::addForeignKey(), te::pgis::Transactor::addForeignKey(), te::da::DataSourceCatalog::addRef(), te::da::DataSourceCatalog::checkFKsDependency(), te::sqlite::DataSourceTransactor::createDataSet(), te::da::DataSetType::DataSetType(), te::da::DataSourceCatalog::indexFKs(), and te::da::DataSourceCatalog::removeRef().

const std::vector<te::dt::Property*>& te::da::ForeignKey::getReferencedProperties ( ) const

inline

It returns the referenced properties (on the referenced DataSetType) of this foreign key constraint.

Returns: The referenced properties (on the referenced DataSetType) of this foreign key constraint.

Definition at line 128 of file ForeignKey.h.

Referenced by te::ado::Transactor::addForeignKey(), te::pgis::Transactor::addForeignKey(), te::sqlite::DataSourceTransactor::createDataSet(), and te::da::DataSetType::DataSetType().

ConstraintType te::da::ForeignKey::getType ( ) const

inlinevirtual

It returns the constraint type: FOREIGNKEY.

Returns: The constraint type FOREIGNKEY.

Implements te::da::Constraint.

Definition at line 225 of file ForeignKey.h.

References te::da::FOREIGN_KEY.

bool te::da::ForeignKey::has ( te::dt::Property * p )

It verifies if Property takes part of the foreign key.

Parameters

p	The Property to be verified.

Returns: True if Property takes part of the foreign key, false otherwise.

Definition at line 78 of file ForeignKey.cpp.

bool te::da::ForeignKey::isReferenced ( te::dt::Property * p )

It verifies if Property is referenced by the foreign key.

Parameters

p	The Property to be verified.

Returns: True if Property is referenced by the foreign key, false otherwise.

Definition at line 89 of file ForeignKey.cpp.

te::da::ForeignKey & te::da::ForeignKey::operator= ( const ForeignKey & rhs )

Assignment operator.

The new object will not have an assigned DataSetType.

Parameters

rhs	Right-hand-side instance.

Returns: A reference to this.

Definition at line 58 of file ForeignKey.cpp.

References m_onDelete, m_onUpdate, m_properties, m_refDt, m_refProperties, and te::da::Constraint::operator=().

void te::da::ForeignKey::replace	(	te::dt::Property *	p,
		te::dt::Property *	pp
	)

It changes a reference to property p to pp.

Parameters

p	A property that takes part of the foreign key or is referenced by it.
pp	The property that will take p place.

Note: This method will replace property checking both property list (referenced and the properties in the fk).; If the property p is not in the fk attribute list this method does nothing.

Definition at line 100 of file ForeignKey.cpp.

virtual void te::da::Constraint::setDataSetType ( DataSetType * dt )

inlinevirtualinherited

It sets the DataSetType associated to the constraint.

Parameters

dt	The DataSetType associated to this constraint.

Warning: Take care when calling this method. If the constraint belongs to a DataSetType, remember to detach it from the DataSetType before calling this method.

Definition at line 143 of file Constraint.h.

Referenced by te::da::DataSetType::add(), te::da::DataSetType::DataSetType(), and te::da::DataSetType::setPrimaryKey().

virtual void te::da::Constraint::setId ( unsigned int id )

inlinevirtualinherited

It sets the constraint identifier.

Parameters

id	A number that identifies the constraint.

Warning: The identifier value (id) may be used by data source implementations. So, don't rely on its value!

Definition at line 112 of file Constraint.h.

Referenced by te::pgis::Transactor::getCheckConstraint(), and te::pgis::Transactor::getConstraints().

virtual void te::da::Constraint::setName ( const std::string & name )

inlinevirtualinherited

It sets the constraint name.

Parameters

name	The constraint name.

Definition at line 126 of file Constraint.h.

Referenced by te::pgis::Transactor::addPrimaryKey(), te::qt::widgets::DataSetOptionsWizardPage::applyChanges(), te::qt::plugins::terralib4::TL4ConverterWizard::commit(), te::sqlite::DataSourceTransactor::createDataSet(), te::qt::widgets::DirectExchangerDialog::exchangeToDatabase(), te::qt::widgets::PrimaryKeyConstraintWidget::getConstraint(), te::qt::widgets::UniqueKeyConstraintWidget::getConstraint(), te::attributefill::RasterToVector::getDataSetType(), and te::qt::widgets::DataSetOptionsWizardPage::set().

void te::da::ForeignKey::setOnDeleteAction ( FKActionType a )

inline

It sets the action to be performed when a referenced element value in the referenced DataSetType is being deleted.

Parameters

a	The action to be performed when a referenced element value in the referenced DataSetType is being deleted.

Definition at line 174 of file ForeignKey.h.

Referenced by te::da::DataSetType::DataSetType(), te::pgis::Transactor::getConstraints(), and te::pgis::Transactor::getForeignKey().

void te::da::ForeignKey::setOnUpdateAction ( FKActionType a )

inline

It sets the action to be performed when a referenced element value in the referenced DataSetType is being updated to a new value.

Parameters

a	The action to be performed when a referenced element value in the referenced DataSetType is being updated to a new value.

Definition at line 188 of file ForeignKey.h.

Referenced by te::da::DataSetType::DataSetType(), te::pgis::Transactor::getConstraints(), and te::pgis::Transactor::getForeignKey().

void te::da::ForeignKey::setProperties ( const std::vector< te::dt::Property * > & properties )

inline

It sets the properties that take part of the foreign key constraint.

Parameters

properties The properties that take part of the foreign key constraint.

Precondition: All properties added must belong to the same DataSetType.

Definition at line 121 of file ForeignKey.h.

Referenced by te::ado::Convert2Terralib().

void te::da::ForeignKey::setReferencedDataSetType ( DataSetType * refDt )

inline

It sets the referenced DataSetType of this foreign key constraint.

Parameters

refDt The referenced DataSetType of this foreign key constraint.

Definition at line 160 of file ForeignKey.h.

Referenced by te::da::DataSetType::DataSetType(), te::pgis::Transactor::getConstraints(), and te::pgis::Transactor::getForeignKey().

void te::da::ForeignKey::setReferencedProperties ( const std::vector< te::dt::Property * > & properties )

inline

It sets the referenced properties (on the referenced DataSetType) of this foreign key constraint.

Parameters

properties The referenced properties (on the referenced DataSetType) of this foreign key constraint.

Precondition: All properties must reference the same DataSetType.

Definition at line 146 of file ForeignKey.h.

Referenced by te::da::DataSetType::DataSetType().

Member Data Documentation

FKActionType te::da::ForeignKey::m_onDelete

private

The action to be performed when a referenced element value in the referenced DataSetType is being deleted.

Definition at line 238 of file ForeignKey.h.

Referenced by operator=().

FKActionType te::da::ForeignKey::m_onUpdate

private

The action to be performed when a referenced element value in the referenced DataSetType is being updated to a new value.

Definition at line 239 of file ForeignKey.h.

Referenced by operator=().

std::vector<te::dt::Property*> te::da::ForeignKey::m_properties

private

The properties that are part of the foreign key constraint.

Definition at line 241 of file ForeignKey.h.

Referenced by operator=().

DataSetType* te::da::ForeignKey::m_refDt

private

The referenced DataSetType of this foreign key constraint.

Definition at line 240 of file ForeignKey.h.

Referenced by operator=().

std::vector<te::dt::Property*> te::da::ForeignKey::m_refProperties

private

The referenced properties (on the referenced DataSetType) of this foreign key constraint.

Definition at line 242 of file ForeignKey.h.

Referenced by operator=().

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

C:/TL5_2015_release/terralib5/src/terralib/dataaccess/dataset/ForeignKey.h
C:/TL5_2015_release/terralib5/src/terralib/dataaccess/dataset/ForeignKey.cpp

Public Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation