Mercurial > projects > qtd
view generator/docparser.cpp @ 145:7648ee2e023b
fix classwizard
author | mandel |
---|---|
date | Wed, 10 Jun 2009 18:34:48 +0000 |
parents | e78566595089 |
children |
line wrap: on
line source
/**************************************************************************** ** ** Copyright (C) 1992-2008 Nokia. All rights reserved. ** ** This file is part of Qt Jambi. ** ** * Commercial Usage * Licensees holding valid Qt Commercial licenses may use this file in * accordance with the Qt Commercial License Agreement provided with the * Software or, alternatively, in accordance with the terms contained in * a written agreement between you and Nokia. * * * GNU General Public License Usage * Alternatively, this file may be used under the terms of the GNU * General Public License versions 2.0 or 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 GNU General Public Licensing requirements will be met: * http://www.fsf.org/licensing/licenses/info/GPLv2.html and * http://www.gnu.org/copyleft/gpl.html. In addition, as a special * exception, Nokia gives you certain additional rights. These rights * are described in the Nokia Qt GPL Exception version 1.2, included in * the file GPL_EXCEPTION.txt in this package. * * Qt for Windows(R) Licensees * As a special exception, Nokia, as the sole copyright holder for Qt * Designer, grants users of the Qt/Eclipse Integration plug-in the * right for the Qt/Eclipse Integration to link to functionality * provided by Qt Designer and its related libraries. * * * If you are unsure which license is appropriate for your use, please * contact the sales department at qt-sales@nokia.com. ** ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. ** ****************************************************************************/ #include "docparser.h" #include "metajava.h" #include "reporthandler.h" #include <QtCore/QFileInfo> #include <QtCore/QFile> #include <QtXml> DocParser::DocParser(const QString &name) : m_doc_file(name), m_dom(0) { build(); } DocParser::~DocParser() { delete m_dom; } QString DocParser::documentation(const AbstractMetaClass *meta_class) const { if (!m_dom) return QString(); QDomElement root_node = m_dom->documentElement(); QString class_name = root_node.attribute("name"); QString doc = root_node.attribute("doc"); if (class_name != meta_class->name()) { ReportHandler::warning("Documentelement file contains unexpected class: " + class_name + ", file=" + m_doc_file); } return doc; } QString DocParser::documentationForFunction(const QString &signature, const QString &tag) const { if (!m_dom) return QString(); QDomElement root_node = m_dom->documentElement(); QDomNodeList functions = root_node.elementsByTagName(tag); for (int i=0; i<functions.size(); ++i) { QDomNode node = functions.item(i); QDomElement *e = (QDomElement *) &node; Q_ASSERT(e->isElement()); if (e->attribute("name") == signature) return e->attribute("doc"); } return QString(); } QString DocParser::documentationForSignal(const QString &signature) const { return documentationForFunction(signature, "signal"); } QString DocParser::documentationForFunction(const QString &signature) const { return documentationForFunction(signature, "method"); } QString DocParser::documentation(const AbstractMetaEnum *java_enum) const { if (!m_dom) return QString(); QDomElement root_node = m_dom->documentElement(); QDomNodeList enums = root_node.elementsByTagName("enum"); for (int i=0; i<enums.size(); ++i) { QDomNode node = enums.item(i); QDomElement *e = (QDomElement *) &node; Q_ASSERT(e->isElement()); if (e->attribute("name") == java_enum->name()) { return e->attribute("doc"); } } return QString(); } QString DocParser::documentation(const AbstractMetaEnumValue *java_enum_value) const { if (!m_dom) return QString(); QDomElement root_node = m_dom->documentElement(); QDomNodeList enums = root_node.elementsByTagName("enum"); for (int i=0; i<enums.size(); ++i) { QDomNode node = enums.item(i); QDomElement *e = (QDomElement *) &node; Q_ASSERT(e->isElement()); QDomNodeList enumValues = e->elementsByTagName("enum-value"); for (int j=0; j<enumValues.size(); ++j) { QDomNode node = enumValues.item(j); QDomElement *ev = (QDomElement *) &node; if (ev->attribute("name") == java_enum_value->name()) { return ev->attribute("doc"); } } } return QString(); } void DocParser::build() { if (!QFileInfo(m_doc_file).exists()) { ReportHandler::warning("Missing documentation file: " + m_doc_file); return; } QFile f(m_doc_file); if (!f.open(QFile::ReadOnly | QFile::Text)) { ReportHandler::warning("Failed to open documentation file: " + m_doc_file); return; } m_dom = new QDomDocument(); QString error; int line, column; if (!m_dom->setContent(&f, &error, &line, &column)) { ReportHandler::warning(QString("Failed to parse the documentation file:" " '%1' %2 line=%3 column=%4") .arg(m_doc_file) .arg(error) .arg(line) .arg(column)); delete m_dom; m_dom = 0; return; } }