/**************************************************************************** ** ** Copyright (C) 2013 Sandro S. Andrade ** Contact: http://www.qt-project.org/legal ** ** This file is part of the QtUml module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and Digia. For licensing terms and ** conditions see http://qt.digia.com/licensing. For further information ** use the contact form at http://qt.digia.com/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 2.1 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 2.1 requirements ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** In addition, as a special exception, Digia gives you certain additional ** rights. These rights are described in the Digia Qt LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 3.0 as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL included in the ** packaging of this file. Please review the following information to ** ensure the GNU General Public License version 3.0 requirements will be ** met: http://www.gnu.org/copyleft/gpl.html. ** ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #include "qumlproperty.h" #include "private/qumlpropertyobject_p.h" #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include QT_BEGIN_NAMESPACE /*! \class QUmlProperty \inmodule QtUml \brief Property represents a declared state of one or more instances in terms of a named relationship to a value or values. When a property is an attribute of a classifier, the value or values are related to the instance of the classifier by being held in slots of the instance. When a property is an association end, the value or values are related to the instance or instances at the other end(s) of the association. The range of valid values represented by the property can be controlled by setting the property's type.A property is a structural feature of a classifier that characterizes instances of the classifier. A property related by ownedAttribute to a classifier (other than an association) represents an attribute and might also represent an association end. It relates an instance of the class to a value or set of values of the type of the attribute. A property related by memberEnd or its specializations to an association represents an end of the association. The type of the property is the type of the end of the association.A property has the capability of being a deployment target in a deployment relationship. This enables modeling the deployment to hierarchical nodes that have properties functioning as internal parts.Property specializes ParameterableElement to specify that a property can be exposed as a formal template parameter, and provided as an actual parameter in a binding of a template.A property represents a set of instances that are owned by a containing classifier instance. */ /*! Creates a new QUmlProperty. Also creates the corresponding QObject-based representation returned by asQModelingObject() if \a createQModelingObject is true. */ QUmlProperty::QUmlProperty(bool createQModelingObject) : _aggregation(QtUml::AggregationKindNone), _association(0), _associationEnd(0), _class_(0), _datatype(0), _defaultValue(0), _interface_(0), _isDerived(false), _isDerivedUnion(false), _isID(false), _isReadOnly(false), _owningAssociation(0) { if (createQModelingObject) _qModelingObject = qobject_cast(new QUmlPropertyObject(this)); } /*! Destroys the QUmlProperty. */ QUmlProperty::~QUmlProperty() { QModelingElement::deleteQModelingObject(); } /*! Returns a deep-copied clone of the QUmlProperty. */ QModelingElement *QUmlProperty::clone() const { QUmlProperty *c = new QUmlProperty; c->asQModelingObject()->setObjectName(this->asQModelingObject()->objectName()); c->asQModelingObject()->setProperty("role", this->asQModelingObject()->property("role")); foreach (QUmlComment *element, ownedComments()) c->addOwnedComment(dynamic_cast(element->clone())); c->setName(name()); if (nameExpression()) c->setNameExpression(dynamic_cast(nameExpression()->clone())); c->setVisibility(visibility()); c->setOrdered(isOrdered()); c->setUnique(isUnique()); if (lowerValue()) c->setLowerValue(dynamic_cast(lowerValue()->clone())); if (upperValue()) c->setUpperValue(dynamic_cast(upperValue()->clone())); c->setLeaf(isLeaf()); c->setStatic(isStatic()); foreach (QUmlDeployment *element, deployments()) c->addDeployment(dynamic_cast(element->clone())); c->setAggregation(aggregation()); if (defaultValue()) c->setDefaultValue(dynamic_cast(defaultValue()->clone())); c->setDerived(isDerived()); c->setDerivedUnion(isDerivedUnion()); c->setID(isID()); c->setReadOnly(isReadOnly()); foreach (QUmlProperty *element, qualifiers()) c->addQualifier(dynamic_cast(element->clone())); return c; } // OWNED ATTRIBUTES /*! Specifies the kind of aggregation that applies to the Property. */ QtUml::AggregationKind QUmlProperty::aggregation() const { // This is a read-write property return _aggregation; } /*! Adjusts aggregation to \a aggregation. */ void QUmlProperty::setAggregation(QtUml::AggregationKind aggregation) { // This is a read-write property if (_aggregation != aggregation) { _aggregation = aggregation; _qModelingObject->modifiedResettableProperties() << QStringLiteral("aggregation"); } } /*! References the association of which this property is a member, if any. \b {Subsetted property(ies):} . \b {Opposite property(ies):} QUmlAssociation::memberEnds(). */ QUmlAssociation *QUmlProperty::association() const { // This is a read-write association end return _association; } /*! Adjusts association to \a association. */ void QUmlProperty::setAssociation(QUmlAssociation *association) { // This is a read-write association end if (_association != association) { _association = association; if (association && association->asQModelingObject() && this->asQModelingObject()) QObject::connect(association->asQModelingObject(), SIGNAL(destroyed()), this->asQModelingObject(), SLOT(setAssociation())); } } /*! Designates the optional association end that owns a qualifier attribute. \b {Subsetted property(ies):} QUmlElement::owner(). \b {Opposite property(ies):} QUmlProperty::qualifiers(). */ QUmlProperty *QUmlProperty::associationEnd() const { // This is a read-write association end return _associationEnd; } /*! Adjusts associationEnd to \a associationEnd. */ void QUmlProperty::setAssociationEnd(QUmlProperty *associationEnd) { // This is a read-write association end if (_associationEnd != associationEnd) { // Adjust subsetted properties _associationEnd = associationEnd; if (associationEnd && associationEnd->asQModelingObject() && this->asQModelingObject()) QObject::connect(associationEnd->asQModelingObject(), SIGNAL(destroyed()), this->asQModelingObject(), SLOT(setAssociationEnd())); // Adjust subsetted properties setOwner(associationEnd); } } /*! References the Class that owns the Property.References the Class that owns the Property. \b {Subsetted property(ies):} QUmlNamedElement::namespace_(). \b {Opposite property(ies):} QUmlClass::ownedAttributes(). */ QUmlClass *QUmlProperty::class_() const { // This is a read-write association end return _class_; } /*! Adjusts class_ to \a class_. */ void QUmlProperty::setClass(QUmlClass *class_) { // This is a read-write association end if (_class_ != class_) { // Adjust subsetted properties _class_ = class_; if (class_ && class_->asQModelingObject() && this->asQModelingObject()) QObject::connect(class_->asQModelingObject(), SIGNAL(destroyed()), this->asQModelingObject(), SLOT(setClass())); // Adjust subsetted properties setNamespace(class_); } } /*! The DataType that owns this Property. \b {Subsetted property(ies):} QUmlNamedElement::namespace_(). \b {Opposite property(ies):} QUmlDataType::ownedAttributes(). */ QUmlDataType *QUmlProperty::datatype() const { // This is a read-write association end return _datatype; } /*! Adjusts datatype to \a datatype. */ void QUmlProperty::setDatatype(QUmlDataType *datatype) { // This is a read-write association end if (_datatype != datatype) { // Adjust subsetted properties _datatype = datatype; if (datatype && datatype->asQModelingObject() && this->asQModelingObject()) QObject::connect(datatype->asQModelingObject(), SIGNAL(destroyed()), this->asQModelingObject(), SLOT(setDatatype())); // Adjust subsetted properties setNamespace(datatype); } } /*! Specifies a String that represents a value to be used when no argument is supplied for the Property.A String that is evaluated to give a default value for the Property when an object of the owning Classifier is instantiated. \b {This is a derived property.} */ QString QUmlProperty::default_() const { // This is a read-write derived property qWarning("QUmlProperty::default_(): to be implemented (this is a derived property)"); return QString(); } /*! Adjusts default_ to \a default_. */ void QUmlProperty::setDefault(QString default_) { // This is a read-write derived property qWarning("QUmlProperty::setDefault(): to be implemented (this is a derived property)"); Q_UNUSED(default_); if (false /* */) { // } } /*! A ValueSpecification that is evaluated to give a default value for the Property when an object of the owning Classifier is instantiated. \b {Subsetted property(ies):} QUmlElement::ownedElements(). */ QUmlValueSpecification *QUmlProperty::defaultValue() const { // This is a read-write association end return _defaultValue; } /*! Adjusts defaultValue to \a defaultValue. */ void QUmlProperty::setDefaultValue(QUmlValueSpecification *defaultValue) { // This is a read-write association end if (_defaultValue != defaultValue) { // Adjust subsetted properties removeOwnedElement(_defaultValue); _defaultValue = defaultValue; if (defaultValue && defaultValue->asQModelingObject() && this->asQModelingObject()) QObject::connect(defaultValue->asQModelingObject(), SIGNAL(destroyed()), this->asQModelingObject(), SLOT(setDefaultValue())); defaultValue->asQModelingObject()->setParent(this->asQModelingObject()); // Adjust subsetted properties if (defaultValue) { addOwnedElement(defaultValue); } } } /*! References the Interface that owns the Property \b {Subsetted property(ies):} QUmlNamedElement::namespace_(). \b {Opposite property(ies):} QUmlInterface::ownedAttributes(). */ QUmlInterface *QUmlProperty::interface_() const { // This is a read-write association end return _interface_; } /*! Adjusts interface_ to \a interface_. */ void QUmlProperty::setInterface(QUmlInterface *interface_) { // This is a read-write association end if (_interface_ != interface_) { // Adjust subsetted properties _interface_ = interface_; if (interface_ && interface_->asQModelingObject() && this->asQModelingObject()) QObject::connect(interface_->asQModelingObject(), SIGNAL(destroyed()), this->asQModelingObject(), SLOT(setInterface())); // Adjust subsetted properties setNamespace(interface_); } } /*! If isComposite is true, the object containing the attribute is a container for the object or value contained in the attribute.This is a derived value, indicating whether the aggregation of the Property is composite or not. \b {This is a derived property.} */ bool QUmlProperty::isComposite() const { // This is a read-write derived property return _aggregation == QtUml::AggregationKindComposite; } /*! Adjusts isComposite to \a isComposite. */ void QUmlProperty::setComposite(bool isComposite) { // This is a read-write derived property qWarning("QUmlProperty::setComposite(): to be implemented (this is a derived property)"); Q_UNUSED(isComposite); if (false /* */) { // } } /*! If isDerived is true, the value of the attribute is derived from information elsewhere.Specifies whether the Property is derived, i.e., whether its value or values can be computed from other information. */ bool QUmlProperty::isDerived() const { // This is a read-write property return _isDerived; } /*! Adjusts isDerived to \a isDerived. */ void QUmlProperty::setDerived(bool isDerived) { // This is a read-write property if (_isDerived != isDerived) { _isDerived = isDerived; _qModelingObject->modifiedResettableProperties() << QStringLiteral("isDerived"); } } /*! Specifies whether the property is derived as the union of all of the properties that are constrained to subset it. */ bool QUmlProperty::isDerivedUnion() const { // This is a read-write property return _isDerivedUnion; } /*! Adjusts isDerivedUnion to \a isDerivedUnion. */ void QUmlProperty::setDerivedUnion(bool isDerivedUnion) { // This is a read-write property if (_isDerivedUnion != isDerivedUnion) { _isDerivedUnion = isDerivedUnion; _qModelingObject->modifiedResettableProperties() << QStringLiteral("isDerivedUnion"); } } /*! True indicates this property can be used to uniquely identify an instance of the containing Class. */ bool QUmlProperty::isID() const { // This is a read-write property return _isID; } /*! Adjusts isID to \a isID. */ void QUmlProperty::setID(bool isID) { // This is a read-write property if (_isID != isID) { _isID = isID; _qModelingObject->modifiedResettableProperties() << QStringLiteral("isID"); } } /*! If true, the attribute may only be read, and not written.If isReadOnly is true, the attribute may not be written to after initialization. \b {Redefined property(ies):} QUmlStructuralFeature::isReadOnly(). */ bool QUmlProperty::isReadOnly() const { // This is a read-write property return _isReadOnly; } /*! Adjusts isReadOnly to \a isReadOnly. */ void QUmlProperty::setReadOnly(bool isReadOnly) { // This is a read-write property if (_isReadOnly != isReadOnly) { _isReadOnly = isReadOnly; _qModelingObject->modifiedResettableProperties() << QStringLiteral("isReadOnly"); // Adjust redefined properties QUmlStructuralFeature::setReadOnly(isReadOnly); } } /*! In the case where the property is one navigable end of a binary association with both ends navigable, this gives the other end. \b {This is a derived property.} */ QUmlProperty *QUmlProperty::opposite() const { // This is a read-write derived association end qWarning("QUmlProperty::opposite(): to be implemented (this is a derived association end)"); return 0; } /*! Adjusts opposite to \a opposite. */ void QUmlProperty::setOpposite(QUmlProperty *opposite) { // This is a read-write derived association end qWarning("QUmlProperty::setOpposite(): to be implemented (this is a derived association end)"); Q_UNUSED(opposite); if (false /* */) { // } } /*! References the owning association of this property, if any. \b {Subsetted property(ies):} QUmlFeature::featuringClassifiers(), QUmlRedefinableElement::redefinitionContexts(), QUmlNamedElement::namespace_(), QUmlProperty::association(). \b {Opposite property(ies):} QUmlAssociation::ownedEnds(). */ QUmlAssociation *QUmlProperty::owningAssociation() const { // This is a read-write association end return _owningAssociation; } /*! Adjusts owningAssociation to \a owningAssociation. */ void QUmlProperty::setOwningAssociation(QUmlAssociation *owningAssociation) { // This is a read-write association end if (_owningAssociation != owningAssociation) { // Adjust subsetted properties removeFeaturingClassifier(_owningAssociation); removeRedefinitionContext(_owningAssociation); _owningAssociation = owningAssociation; if (owningAssociation && owningAssociation->asQModelingObject() && this->asQModelingObject()) QObject::connect(owningAssociation->asQModelingObject(), SIGNAL(destroyed()), this->asQModelingObject(), SLOT(setOwningAssociation())); // Adjust subsetted properties if (owningAssociation) { addFeaturingClassifier(owningAssociation); } if (owningAssociation) { addRedefinitionContext(owningAssociation); } setNamespace(owningAssociation); setAssociation(owningAssociation); } } /*! An optional list of ordered qualifier attributes for the end. If the list is empty, then the Association is not qualified. \sa addQualifier(), removeQualifier() \b {Subsetted property(ies):} QUmlElement::ownedElements(). \b {Opposite property(ies):} QUmlProperty::associationEnd(). */ const QList QUmlProperty::qualifiers() const { // This is a read-write association end return _qualifiers; } /*! Adds \a qualifier to qualifiers. \sa qualifiers(), removeQualifier() */ void QUmlProperty::addQualifier(QUmlProperty *qualifier) { // This is a read-write association end if (!_qualifiers.contains(qualifier)) { _qualifiers.append(qualifier); if (qualifier && qualifier->asQModelingObject() && this->asQModelingObject()) QObject::connect(qualifier->asQModelingObject(), SIGNAL(destroyed(QObject*)), this->asQModelingObject(), SLOT(removeQualifier(QObject *))); qualifier->asQModelingObject()->setParent(this->asQModelingObject()); // Adjust subsetted properties addOwnedElement(qualifier); // Adjust opposite properties if (qualifier) { qualifier->setAssociationEnd(this); } } } /*! Removes \a qualifier from qualifiers. \sa qualifiers(), addQualifier() */ void QUmlProperty::removeQualifier(QUmlProperty *qualifier) { // This is a read-write association end if (_qualifiers.contains(qualifier)) { _qualifiers.removeAll(qualifier); if (qualifier->asQModelingObject()) qualifier->asQModelingObject()->setParent(0); // Adjust subsetted properties removeOwnedElement(qualifier); // Adjust opposite properties if (qualifier) { qualifier->setAssociationEnd(0); } } } /*! References the properties that are redefined by this property. \sa addRedefinedProperty(), removeRedefinedProperty() \b {Subsetted property(ies):} QUmlRedefinableElement::redefinedElements(). */ const QSet QUmlProperty::redefinedProperties() const { // This is a read-write association end return _redefinedProperties; } /*! Adds \a redefinedProperty to redefinedProperties. \sa redefinedProperties(), removeRedefinedProperty() */ void QUmlProperty::addRedefinedProperty(QUmlProperty *redefinedProperty) { // This is a read-write association end if (!_redefinedProperties.contains(redefinedProperty)) { _redefinedProperties.insert(redefinedProperty); if (redefinedProperty && redefinedProperty->asQModelingObject() && this->asQModelingObject()) QObject::connect(redefinedProperty->asQModelingObject(), SIGNAL(destroyed(QObject*)), this->asQModelingObject(), SLOT(removeRedefinedProperty(QObject *))); // Adjust subsetted properties addRedefinedElement(redefinedProperty); } } /*! Removes \a redefinedProperty from redefinedProperties. \sa redefinedProperties(), addRedefinedProperty() */ void QUmlProperty::removeRedefinedProperty(QUmlProperty *redefinedProperty) { // This is a read-write association end if (_redefinedProperties.contains(redefinedProperty)) { _redefinedProperties.remove(redefinedProperty); // Adjust subsetted properties removeRedefinedElement(redefinedProperty); } } /*! References the properties of which this property is constrained to be a subset. \sa addSubsettedProperty(), removeSubsettedProperty() */ const QSet QUmlProperty::subsettedProperties() const { // This is a read-write association end return _subsettedProperties; } /*! Adds \a subsettedProperty to subsettedProperties. \sa subsettedProperties(), removeSubsettedProperty() */ void QUmlProperty::addSubsettedProperty(QUmlProperty *subsettedProperty) { // This is a read-write association end if (!_subsettedProperties.contains(subsettedProperty)) { _subsettedProperties.insert(subsettedProperty); if (subsettedProperty && subsettedProperty->asQModelingObject() && this->asQModelingObject()) QObject::connect(subsettedProperty->asQModelingObject(), SIGNAL(destroyed(QObject*)), this->asQModelingObject(), SLOT(removeSubsettedProperty(QObject *))); } } /*! Removes \a subsettedProperty from subsettedProperties. \sa subsettedProperties(), addSubsettedProperty() */ void QUmlProperty::removeSubsettedProperty(QUmlProperty *subsettedProperty) { // This is a read-write association end if (_subsettedProperties.contains(subsettedProperty)) { _subsettedProperties.remove(subsettedProperty); } } // OPERATIONS /*! The query isAttribute() is true if the Property is defined as an attribute of some classifier. */ bool QUmlProperty::isAttribute(QUmlProperty *p) const { qWarning("QUmlProperty::isAttribute(): to be implemented (operation)"); Q_UNUSED(p); return bool (); } /*! The query isCompatibleWith() determines if this parameterable element is compatible with the specified parameterable element. By default parameterable element P is compatible with parameterable element Q if the kind of P is the same or a subtype as the kind of Q. In addition, for properties, the type must be conformant with the type of the specified parameterable element. */ bool QUmlProperty::isCompatibleWith(QUmlParameterableElement *p) const { qWarning("QUmlProperty::isCompatibleWith(): to be implemented (operation)"); Q_UNUSED(p); return bool (); } /*! The query isConsistentWith() specifies, for any two Properties in a context in which redefinition is possible, whether redefinition would be logically consistent. A redefining property is consistent with a redefined property if the type of the redefining property conforms to the type of the redefined property, the multiplicity of the redefining property (if specified) is contained in the multiplicity of the redefined property.The query isConsistentWith() specifies, for any two Properties in a context in which redefinition is possible, whether redefinition would be logically consistent. A redefining property is consistent with a redefined property if the type of the redefining property conforms to the type of the redefined property, and the multiplicity of the redefining property (if specified) is contained in the multiplicity of the redefined property. */ bool QUmlProperty::isConsistentWith(QUmlRedefinableElement *redefinee) const { qWarning("QUmlProperty::isConsistentWith(): to be implemented (operation)"); Q_UNUSED(redefinee); return bool (); } /*! The query isNavigable() indicates whether it is possible to navigate across the property. */ bool QUmlProperty::isNavigable() const { qWarning("QUmlProperty::isNavigable(): to be implemented (operation)"); return bool (); } /*! The query subsettingContext() gives the context for subsetting a property. It consists, in the case of an attribute, of the corresponding classifier, and in the case of an association end, all of the classifiers at the other ends. */ QSet QUmlProperty::subsettingContext() const { qWarning("QUmlProperty::subsettingContext(): to be implemented (operation)"); return QSet (); } QT_END_NAMESPACE