/**
* Returns the fully qualified name, i.e. all package prefixes and then m_name.
*
* @param separator The separator string to use (optional.)
* If not given then the separator is chosen according
* to the currently selected active programming language
* of import and code generation.
* @param includeRoot Whether to prefix the root folder name to the FQN.
* See UMLDoc::getRootFolder(). Default: false.
* @return The fully qualified name of this UMLObject.
*/
QString UMLObject::fullyQualifiedName(const QString& separator,
bool includeRoot /* = false */) const
{
QString fqn;
if (m_pUMLPackage && m_pUMLPackage != this) {
bool skipPackage = false;
if (!includeRoot) {
UMLDoc *umldoc = UMLApp::app()->document();
if (umldoc->rootFolderType(m_pUMLPackage) != Uml::ModelType::N_MODELTYPES ||
m_pUMLPackage == umldoc->datatypeFolder())
skipPackage = true;
}
if (!skipPackage) {
QString tempSeparator = separator;
if (tempSeparator.isEmpty())
tempSeparator = UMLApp::app()->activeLanguageScopeSeparator();
fqn = m_pUMLPackage->fullyQualifiedName(tempSeparator, includeRoot);
fqn.append(tempSeparator);
}
}
fqn.append(m_name);
return fqn;
}
/**
* This method loads the generic parts of the XMI common to most model
* classes. It is not usually reimplemented by child classes.
* Instead, it invokes the load() method which implements the loading
* of the specifics of each child class.
*
* @param element The QDomElement from which to load.
*/
bool UMLObject::loadFromXMI(QDomElement & element)
{
UMLDoc* umldoc = UMLApp::app()->document();
if (umldoc == 0) {
uError() << "umldoc is NULL";
return false;
}
// Read the name first so that if we encounter a problem, the error
// message can say the name.
m_name = element.attribute(QLatin1String("name"));
QString id = Model_Utils::getXmiId(element);
if (id.isEmpty() || id == QLatin1String("-1")) {
// Before version 1.4, Umbrello did not save the xmi.id of UMLRole objects.
// Some tools (such as Embarcadero's) do not have an xmi.id on all attributes.
m_nId = UniqueID::gen();
uWarning() << m_name << ": xmi.id not present, generating a new one";
} else {
Uml::ID::Type nId = Uml::ID::fromString(id);
if (m_BaseType == ot_Role) {
// Some older Umbrello versions had a problem with xmi.id's
// of other objects being reused for the UMLRole, see e.g.
// attachment 21179 at http://bugs.kde.org/147988 .
// If the xmi.id is already being used then we generate a new one.
UMLObject *o = umldoc->findObjectById(nId);
if (o) {
uError() << "loadFromXMI(UMLRole): id " << id
<< " is already in use!!! Please fix your XMI file.";
}
}
m_nId = nId;
}
if (element.hasAttribute(QLatin1String("documentation"))) // for bkwd compat.
m_Doc = element.attribute(QLatin1String("documentation"));
else
m_Doc = element.attribute(QLatin1String("comment")); //CHECK: need a UML:Comment?
m_visibility = Uml::Visibility::Public;
if (element.hasAttribute(QLatin1String("scope"))) { // for bkwd compat.
QString scope = element.attribute(QLatin1String("scope"));
if (scope == QLatin1String("instance_level")) // nsuml compat.
m_bStatic = false;
else if (scope == QLatin1String("classifier_level")) // nsuml compat.
m_bStatic = true;
else {
int nScope = scope.toInt();
switch (nScope) {
case 200:
m_visibility = Uml::Visibility::Public;
break;
case 201:
m_visibility = Uml::Visibility::Private;
break;
case 202:
m_visibility = Uml::Visibility::Protected;
break;
default:
uError() << m_name << ": illegal scope " << nScope;
}
}
} else {
QString visibility = element.attribute(QLatin1String("visibility"), QLatin1String("public"));
if (visibility == QLatin1String("private")
|| visibility == QLatin1String("private_vis")) // for compatibility with other programs
m_visibility = Uml::Visibility::Private;
else if (visibility == QLatin1String("protected")
|| visibility == QLatin1String("protected_vis")) // for compatibility with other programs
m_visibility = Uml::Visibility::Protected;
else if (visibility == QLatin1String("implementation"))
m_visibility = Uml::Visibility::Implementation;
}
QString stereo = element.attribute(QLatin1String("stereotype"));
if (!stereo.isEmpty()) {
Uml::ID::Type stereoID = Uml::ID::fromString(stereo);
m_pStereotype = umldoc->findStereotypeById(stereoID);
if (m_pStereotype) {
m_pStereotype->incrRefCount();
} else {
uDebug() << m_name << ": UMLStereotype " << Uml::ID::toString(stereoID)
<< " not found, creating now.";
setStereotypeCmd(stereo);
}
}
if (element.hasAttribute(QLatin1String("abstract"))) { // for bkwd compat.
QString abstract = element.attribute(QLatin1String("abstract"), QLatin1String("0"));
m_bAbstract = (bool)abstract.toInt();
} else {
QString isAbstract = element.attribute(QLatin1String("isAbstract"), QLatin1String("false"));
m_bAbstract = (isAbstract == QLatin1String("true"));
}
if (element.hasAttribute(QLatin1String("static"))) { // for bkwd compat.
QString staticScope = element.attribute(QLatin1String("static"), QLatin1String("0"));
m_bStatic = (bool)staticScope.toInt();
} else {
QString ownerScope = element.attribute(QLatin1String("ownerScope"), QLatin1String("instance"));
m_bStatic = (ownerScope == QLatin1String("classifier"));
}
// If the node has child nodes, check whether attributes can be
// extracted from them.
if (element.hasChildNodes()) {
QDomNode node = element.firstChild();
if (node.isComment())
node = node.nextSibling();
QDomElement elem = node.toElement();
while (!elem.isNull()) {
QString tag = elem.tagName();
if (UMLDoc::tagEq(tag, QLatin1String("name"))) {
m_name = elem.attribute(QLatin1String("xmi.value"));
if (m_name.isEmpty())
m_name = elem.text();
} else if (UMLDoc::tagEq(tag, QLatin1String("visibility"))) {
QString vis = elem.attribute(QLatin1String("xmi.value"));
if (vis.isEmpty())
vis = elem.text();
if (vis == QLatin1String("private") || vis == QLatin1String("private_vis"))
m_visibility = Uml::Visibility::Private;
else if (vis == QLatin1String("protected") || vis == QLatin1String("protected_vis"))
m_visibility = Uml::Visibility::Protected;
else if (vis == QLatin1String("implementation"))
m_visibility = Uml::Visibility::Implementation;
} else if (UMLDoc::tagEq(tag, QLatin1String("isAbstract"))) {
QString isAbstract = elem.attribute(QLatin1String("xmi.value"));
if (isAbstract.isEmpty())
isAbstract = elem.text();
m_bAbstract = (isAbstract == QLatin1String("true"));
} else if (UMLDoc::tagEq(tag, QLatin1String("ownerScope"))) {
QString ownerScope = elem.attribute(QLatin1String("xmi.value"));
if (ownerScope.isEmpty())
ownerScope = elem.text();
m_bStatic = (ownerScope == QLatin1String("classifier"));
} else {
loadStereotype(elem);
}
node = node.nextSibling();
if (node.isComment())
node = node.nextSibling();
elem = node.toElement();
}
}
// Operations, attributes, enum literals, templates, stereotypes,
// and association role objects get added and signaled elsewhere.
if (m_BaseType != ot_Operation && m_BaseType != ot_Attribute &&
m_BaseType != ot_EnumLiteral && m_BaseType != ot_EntityAttribute &&
m_BaseType != ot_Template && m_BaseType != ot_Stereotype &&
m_BaseType != ot_Role && m_BaseType != ot_UniqueConstraint &&
m_BaseType != ot_ForeignKeyConstraint && m_BaseType != ot_CheckConstraint) {
if (m_pUMLPackage) {
m_pUMLPackage->addObject(this);
} else if (umldoc->rootFolderType(this) == Uml::ModelType::N_MODELTYPES) {
// m_pUMLPackage is not set on the root folders.
uDebug() << m_name << ": m_pUMLPackage is not set";
}
}
return load(element);
}