/************************************************************************** ** ** This file is part of Qt Creator ** ** Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies). ** ** Contact: Nokia Corporation (qt-info@nokia.com) ** ** No Commercial Usage ** ** This file contains pre-release code and may not be distributed. ** You may use this file in accordance with the terms and conditions ** contained in the Technology Preview License Agreement accompanying ** this package. ** ** 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, Nokia gives you certain additional ** rights. These rights are described in the Nokia Qt LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ** If you have questions regarding the use of this file, please contact ** Nokia at qt-info@nokia.com. ** **************************************************************************/ #include "qmljsdocument.h" #include "qmljsbind.h" #include #include #include #include #include #include using namespace QmlJS; using namespace QmlJS::AST; /*! \class QmlJS::Document \brief A Qml or JavaScript document. \sa QmlJS::Snapshot Documents are usually created by the \l{QmlJSEditor::Internal::ModelManager} and stored in a \l{QmlJS::Snapshot}. They allow access to data such as the file path, source code, abstract syntax tree and the \l{QmlJS::Bind} instance for the document. To make sure unused and outdated documents are removed correctly, Document instances are usually accessed through a shared pointer, see \l{Document::Ptr}. */ /*! \class QmlJS::LibraryInfo \brief A Qml library. \sa QmlJS::Snapshot A LibraryInfo is created when the \l{QmlJSEditor::Internal::ModelManager} finds a Qml library and parses the qmldir file. The instance holds information about which Components the library provides and which plugins to load. The ModelManager will try to extract detailed information about the types defined in the plugins this library loads. Once it is done, the data will be available through the metaObjects() function. */ /*! \class QmlJS::Snapshot \brief A set of Document::Ptr and LibraryInfo instances. \sa QmlJS::Document QmlJS::LibraryInfo A Snapshot holds and offers access to a set of Document and LibraryInfo instances. Usually Snapshots are copies of the snapshot maintained and updated by the \l{QmlJSEditor::Internal::ModelManager} that updates its instance as parsing threads finish and new information becomes available. */ Document::Document(const QString &fileName) : _engine(0) , _pool(0) , _ast(0) , _bind(0) , _isQmlDocument(false) , _editorRevision(0) , _parsedCorrectly(false) , _fileName(QDir::cleanPath(fileName)) { QFileInfo fileInfo(fileName); _path = QDir::cleanPath(fileInfo.absolutePath()); // ### Should use mime type if (fileInfo.suffix() == QLatin1String("qml") || fileInfo.suffix() == QLatin1String("qmlproject")) { _isQmlDocument = true; _componentName = fileInfo.baseName(); if (! _componentName.isEmpty()) { // ### TODO: check the component name. if (! _componentName.at(0).isUpper()) _componentName.clear(); } } } Document::~Document() { if (_bind) delete _bind; if (_engine) delete _engine; if (_pool) delete _pool; } Document::Ptr Document::create(const QString &fileName) { Document::Ptr doc(new Document(fileName)); return doc; } bool Document::isQmlDocument() const { return _isQmlDocument; } bool Document::isJSDocument() const { return ! _isQmlDocument; } AST::UiProgram *Document::qmlProgram() const { return cast(_ast); } AST::Program *Document::jsProgram() const { return cast(_ast); } AST::ExpressionNode *Document::expression() const { if (_ast) return _ast->expressionCast(); return 0; } AST::Node *Document::ast() const { return _ast; } QList Document::diagnosticMessages() const { return _diagnosticMessages; } QString Document::source() const { return _source; } void Document::setSource(const QString &source) { _source = source; } int Document::editorRevision() const { return _editorRevision; } void Document::setEditorRevision(int revision) { _editorRevision = revision; } QString Document::fileName() const { return _fileName; } QString Document::path() const { return _path; } QString Document::componentName() const { return _componentName; } bool Document::parse_helper(int startToken) { Q_ASSERT(! _engine); Q_ASSERT(! _pool); Q_ASSERT(! _ast); Q_ASSERT(! _bind); _engine = new Engine(); _pool = new NodePool(_fileName, _engine); Lexer lexer(_engine); Parser parser(_engine); QString source = _source; if (startToken == QmlJSGrammar::T_FEED_JS_PROGRAM) extractPragmas(&source); lexer.setCode(source, /*line = */ 1); switch (startToken) { case QmlJSGrammar::T_FEED_UI_PROGRAM: _parsedCorrectly = parser.parse(); break; case QmlJSGrammar::T_FEED_JS_PROGRAM: _parsedCorrectly = parser.parseProgram(); break; case QmlJSGrammar::T_FEED_JS_EXPRESSION: _parsedCorrectly = parser.parseExpression(); break; default: Q_ASSERT(0); } _ast = parser.rootNode(); _diagnosticMessages = parser.diagnosticMessages(); _bind = new Bind(this, &_diagnosticMessages); return _parsedCorrectly; } bool Document::parse() { if (isQmlDocument()) return parseQml(); return parseJavaScript(); } bool Document::parseQml() { return parse_helper(QmlJSGrammar::T_FEED_UI_PROGRAM); } bool Document::parseJavaScript() { return parse_helper(QmlJSGrammar::T_FEED_JS_PROGRAM); } bool Document::parseExpression() { return parse_helper(QmlJSGrammar::T_FEED_JS_EXPRESSION); } Bind *Document::bind() const { return _bind; } // this is essentially a copy of QDeclarativeScriptParser::extractPragmas void Document::extractPragmas(QString *source) { const QChar forwardSlash(QLatin1Char('/')); const QChar star(QLatin1Char('*')); const QChar newline(QLatin1Char('\n')); const QChar dot(QLatin1Char('.')); const QChar semicolon(QLatin1Char(';')); const QChar space(QLatin1Char(' ')); const QString pragma(QLatin1String(".pragma ")); const QChar *pragmaData = pragma.constData(); QString &script = *source; const QChar *data = script.constData(); const int length = script.count(); for (int ii = 0; ii < length; ++ii) { const QChar &c = data[ii]; if (c.isSpace()) continue; if (c == forwardSlash) { ++ii; if (ii >= length) return; const QChar &c = data[ii]; if (c == forwardSlash) { // Find next newline while (ii < length && data[++ii] != newline) {}; } else if (c == star) { // Find next star while (true) { while (ii < length && data[++ii] != star) {}; if (ii + 1 >= length) return; if (data[ii + 1] == forwardSlash) { ++ii; break; } } } else { return; } } else if (c == dot) { // Could be a pragma! if (ii + pragma.length() >= length || 0 != ::memcmp(data + ii, pragmaData, sizeof(QChar) * pragma.length())) return; int pragmaStatementIdx = ii; ii += pragma.length(); while (ii < length && data[ii].isSpace()) { ++ii; } int startIdx = ii; while (ii < length && data[ii].isLetter()) { ++ii; } int endIdx = ii; if (ii != length && data[ii] != forwardSlash && !data[ii].isSpace() && data[ii] != semicolon) return; QString p(data + startIdx, endIdx - startIdx); if (p != QLatin1String("library")) return; for (int jj = pragmaStatementIdx; jj < endIdx; ++jj) script[jj] = space; } else { return; } } } LibraryInfo::LibraryInfo() : _valid(false) { } LibraryInfo::LibraryInfo(const QmlDirParser &parser) : _valid(true) , _components(parser.components()) , _plugins(parser.plugins()) , _dumped(false) { } LibraryInfo::~LibraryInfo() { } Snapshot::Snapshot() { } Snapshot::~Snapshot() { } void Snapshot::insert(const Document::Ptr &document) { if (document && (document->qmlProgram() || document->jsProgram())) { const QString fileName = document->fileName(); const QString path = document->path(); remove(fileName); _documentsByPath[path].append(document); _documents.insert(fileName, document); } } void Snapshot::insertLibraryInfo(const QString &path, const LibraryInfo &info) { _libraries.insert(QDir::cleanPath(path), info); } void Snapshot::remove(const QString &fileName) { Document::Ptr doc = _documents.value(fileName); if (!doc.isNull()) { const QString &path = doc->path(); QList docs = _documentsByPath.value(path); docs.removeAll(doc); _documentsByPath[path] = docs; _documents.remove(fileName); } } Document::Ptr Snapshot::documentFromSource(const QString &code, const QString &fileName) const { Document::Ptr newDoc = Document::create(fileName); if (Document::Ptr thisDocument = document(fileName)) { newDoc->_editorRevision = thisDocument->_editorRevision; } newDoc->setSource(code); return newDoc; } Document::Ptr Snapshot::document(const QString &fileName) const { return _documents.value(QDir::cleanPath(fileName)); } QList Snapshot::documentsInDirectory(const QString &path) const { return _documentsByPath.value(QDir::cleanPath(path)); } LibraryInfo Snapshot::libraryInfo(const QString &path) const { return _libraries.value(QDir::cleanPath(path)); }