/**************************************************************************** ** ** 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 "qumllifeline.h" #include "private/qumllifelineobject_p.h" #include #include #include #include #include #include #include #include #include #include #include QT_BEGIN_NAMESPACE /*! \class QUmlLifeline \inmodule QtUml \brief A lifeline represents an individual participant in the interaction. While parts and structural features may have multiplicity greater than 1, lifelines represent only one interacting entity. */ /*! Creates a new QUmlLifeline. Also creates the corresponding QObject-based representation returned by asQModelingObject() if \a createQModelingObject is true. */ QUmlLifeline::QUmlLifeline(bool createQModelingObject) : _decomposedAs(0), _interaction(0), _represents(0), _selector(0) { if (createQModelingObject) _qModelingObject = qobject_cast(new QUmlLifelineObject(this)); } /*! Destroys the QUmlLifeline. */ QUmlLifeline::~QUmlLifeline() { QModelingElement::deleteQModelingObject(); } /*! Returns a deep-copied clone of the QUmlLifeline. */ QModelingElement *QUmlLifeline::clone() const { QUmlLifeline *c = new QUmlLifeline; 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()); if (selector()) c->setSelector(dynamic_cast(selector()->clone())); return c; } // OWNED ATTRIBUTES /*! References the InteractionFragments in which this Lifeline takes part. \sa addCoveredBy(), removeCoveredBy() \b {Opposite property(ies):} QUmlInteractionFragment::covered(). */ const QSet QUmlLifeline::coveredBy() const { // This is a read-write association end return _coveredBy; } /*! Adds \a coveredBy to coveredBy. \sa coveredBy(), removeCoveredBy() */ void QUmlLifeline::addCoveredBy(QUmlInteractionFragment *coveredBy) { // This is a read-write association end if (!_coveredBy.contains(coveredBy)) { _coveredBy.insert(coveredBy); if (coveredBy && coveredBy->asQModelingObject() && this->asQModelingObject()) QObject::connect(coveredBy->asQModelingObject(), SIGNAL(destroyed(QObject*)), this->asQModelingObject(), SLOT(removeCoveredBy(QObject *))); // Adjust opposite properties if (coveredBy) { coveredBy->addCovered(this); } } } /*! Removes \a coveredBy from coveredBy. \sa coveredBy(), addCoveredBy() */ void QUmlLifeline::removeCoveredBy(QUmlInteractionFragment *coveredBy) { // This is a read-write association end if (_coveredBy.contains(coveredBy)) { _coveredBy.remove(coveredBy); // Adjust opposite properties if (coveredBy) { coveredBy->removeCovered(this); } } } /*! References the Interaction that represents the decomposition. */ QUmlPartDecomposition *QUmlLifeline::decomposedAs() const { // This is a read-write association end return _decomposedAs; } /*! Adjusts decomposedAs to \a decomposedAs. */ void QUmlLifeline::setDecomposedAs(QUmlPartDecomposition *decomposedAs) { // This is a read-write association end if (_decomposedAs != decomposedAs) { _decomposedAs = decomposedAs; if (decomposedAs && decomposedAs->asQModelingObject() && this->asQModelingObject()) QObject::connect(decomposedAs->asQModelingObject(), SIGNAL(destroyed()), this->asQModelingObject(), SLOT(setDecomposedAs())); } } /*! References the Interaction enclosing this Lifeline. \b {Subsetted property(ies):} QUmlNamedElement::namespace_(). \b {Opposite property(ies):} QUmlInteraction::lifelines(). */ QUmlInteraction *QUmlLifeline::interaction() const { // This is a read-write association end return _interaction; } /*! Adjusts interaction to \a interaction. */ void QUmlLifeline::setInteraction(QUmlInteraction *interaction) { // This is a read-write association end if (_interaction != interaction) { // Adjust subsetted properties _interaction = interaction; if (interaction && interaction->asQModelingObject() && this->asQModelingObject()) QObject::connect(interaction->asQModelingObject(), SIGNAL(destroyed()), this->asQModelingObject(), SLOT(setInteraction())); // Adjust subsetted properties setNamespace(interaction); } } /*! References the ConnectableElement within the classifier that contains the enclosing interaction. */ QUmlConnectableElement *QUmlLifeline::represents() const { // This is a read-write association end return _represents; } /*! Adjusts represents to \a represents. */ void QUmlLifeline::setRepresents(QUmlConnectableElement *represents) { // This is a read-write association end if (_represents != represents) { _represents = represents; if (represents && represents->asQModelingObject() && this->asQModelingObject()) QObject::connect(represents->asQModelingObject(), SIGNAL(destroyed()), this->asQModelingObject(), SLOT(setRepresents())); } } /*! If the referenced ConnectableElement is multivalued, then this specifies the specific individual part within that set. \b {Subsetted property(ies):} QUmlElement::ownedElements(). */ QUmlValueSpecification *QUmlLifeline::selector() const { // This is a read-write association end return _selector; } /*! Adjusts selector to \a selector. */ void QUmlLifeline::setSelector(QUmlValueSpecification *selector) { // This is a read-write association end if (_selector != selector) { // Adjust subsetted properties removeOwnedElement(_selector); _selector = selector; if (selector && selector->asQModelingObject() && this->asQModelingObject()) QObject::connect(selector->asQModelingObject(), SIGNAL(destroyed()), this->asQModelingObject(), SLOT(setSelector())); selector->asQModelingObject()->setParent(this->asQModelingObject()); // Adjust subsetted properties if (selector) { addOwnedElement(selector); } } } QT_END_NAMESPACE