source: trunk/src/xmlpatterns/api/qxmlquery_p.h@ 350

Last change on this file since 350 was 2, checked in by Dmitry A. Kuminov, 16 years ago

Initially imported qt-all-opensource-src-4.5.1 from Trolltech.
File size: 12.5 KB
Line 
1/****************************************************************************
2**
3** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
4** Contact: Qt Software Information ([email protected])
5**
6** This file is part of the QtXmlPatterns module of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL$
9** Commercial Usage
10** Licensees holding valid Qt Commercial licenses may use this file in
11** accordance with the Qt Commercial License Agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and Nokia.
14**
15** GNU Lesser General Public License Usage
16** Alternatively, this file may be used under the terms of the GNU Lesser
17** General Public License version 2.1 as published by the Free Software
18** Foundation and appearing in the file LICENSE.LGPL included in the
19** packaging of this file. Please review the following information to
20** ensure the GNU Lesser General Public License version 2.1 requirements
21** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
22**
23** In addition, as a special exception, Nokia gives you certain
24** additional rights. These rights are described in the Nokia Qt LGPL
25** Exception version 1.0, included in the file LGPL_EXCEPTION.txt in this
26** package.
27**
28** GNU General Public License Usage
29** Alternatively, this file may be used under the terms of the GNU
30** General Public License version 3.0 as published by the Free Software
31** Foundation and appearing in the file LICENSE.GPL included in the
32** packaging of this file. Please review the following information to
33** ensure the GNU General Public License version 3.0 requirements will be
34** met: http://www.gnu.org/copyleft/gpl.html.
35**
36** If you are unsure which license is appropriate for your use, please
37** contact the sales department at [email protected].
38** $QT_END_LICENSE$
39**
40****************************************************************************/
41
42//
43// W A R N I N G
44// -------------
45//
46// This file is not part of the Qt API. It exists purely as an
47// implementation detail. This header file may change from version to
48// version without notice, or even be removed.
49//
50// We mean it.
51
52#ifndef QXMLQUERY_P_H
53#define QXMLQUERY_P_H
54
55#include <QAbstractMessageHandler>
56#include <QAbstractUriResolver>
57#include <QCoreApplication>
58#include <QPointer>
59#include <QSourceLocation>
60#include <QUrl>
61#include <QVariant>
62#include <QXmlName>
63#include <QXmlNamePool>
64#include <QXmlQuery>
65
66#include "qacceltreebuilder_p.h"
67#include "qacceltreeresourceloader_p.h"
68#include "qcoloringmessagehandler_p.h"
69#include "qcommonsequencetypes_p.h"
70#include "qexpressionfactory_p.h"
71#include "qfocus_p.h"
72#include "qfunctionfactorycollection_p.h"
73#include "qgenericdynamiccontext_p.h"
74#include "qgenericstaticcontext_p.h"
75#include "qnamepool_p.h"
76#include "qnetworkaccessdelegator_p.h"
77#include "qreferencecountedvalue_p.h"
78#include "qresourcedelegator_p.h"
79#include "qstaticfocuscontext_p.h"
80#include "quriloader_p.h"
81#include "qvariableloader_p.h"
82
83QT_BEGIN_NAMESPACE
84
85class QXmlQueryPrivate
86{
87public:
88
89 inline QXmlQueryPrivate(const QXmlNamePool &np = QXmlNamePool()) : namePool(np)
90 , messageHandler(0)
91 , uriResolver(0)
92 , queryLanguage(QXmlQuery::XQuery10)
93 , m_networkAccessDelegator(new QPatternist::NetworkAccessDelegator(0, 0))
94 {
95 m_networkAccessDelegator->m_variableURIManager = new QPatternist::URILoader(ownerObject(), namePool.d, variableLoader());
96 }
97
98 void detach()
99 {
100 if(m_variableLoader)
101 m_variableLoader = QPatternist::VariableLoader::Ptr(new QPatternist::VariableLoader(namePool.d, m_variableLoader));
102
103 delete m_networkAccessDelegator->m_variableURIManager;
104 m_networkAccessDelegator->m_variableURIManager = new QPatternist::URILoader(ownerObject(), namePool.d, m_variableLoader);
105
106 if(m_resourceLoader)
107 {
108 const QPatternist::AccelTreeResourceLoader::Ptr nev(new QPatternist::AccelTreeResourceLoader(namePool.d,
109 m_networkAccessDelegator));
110 m_resourceLoader = QPatternist::ResourceLoader::Ptr(new QPatternist::ResourceDelegator(m_resourceLoader->deviceURIs(),
111 m_resourceLoader,
112 nev));
113 }
114 }
115
116 bool isValid()
117 {
118 return expression();
119 }
120
121 inline void recompileRequired()
122 {
123 m_expr.reset();
124 }
125
126 inline QPatternist::VariableLoader::Ptr variableLoader()
127 {
128 if(!m_variableLoader)
129 m_variableLoader = QPatternist::VariableLoader::Ptr(new QPatternist::VariableLoader(namePool.d));
130
131 return m_variableLoader;
132 }
133
134 inline QPatternist::GenericStaticContext::Ptr staticContext()
135 {
136 if(m_staticContext && m_expr)
137 return m_staticContext;
138 /* Else, re-create the staticContext. */
139
140 if(!messageHandler)
141 messageHandler = new QPatternist::ColoringMessageHandler(ownerObject());
142
143 if(!m_functionFactory)
144 {
145 if(queryLanguage == QXmlQuery::XQuery10)
146 m_functionFactory = QPatternist::FunctionFactoryCollection::xpath20Factory(namePool.d);
147 else
148 {
149 Q_ASSERT(queryLanguage == QXmlQuery::XSLT20);
150 m_functionFactory = QPatternist::FunctionFactoryCollection::xslt20Factory(namePool.d);
151 }
152 }
153
154 const QPatternist::GenericStaticContext::Ptr genericStaticContext(new QPatternist::GenericStaticContext(namePool.d,
155 messageHandler,
156 queryURI,
157 m_functionFactory,
158 queryLanguage));
159 genericStaticContext->setResourceLoader(resourceLoader());
160
161 genericStaticContext->setExternalVariableLoader(variableLoader());
162
163 m_staticContext = genericStaticContext;
164
165 if(!contextItem.isNull())
166 m_staticContext = QPatternist::StaticContext::Ptr(new QPatternist::StaticFocusContext(QPatternist::AtomicValue::qtToXDMType(contextItem), m_staticContext));
167
168 return m_staticContext;
169 }
170
171 inline QPatternist::DynamicContext::Ptr dynamicContext(QAbstractXmlReceiver *const callback = 0)
172 {
173 const QPatternist::StaticContext::Ptr statContext(staticContext());
174 Q_ASSERT(statContext);
175
176 QPatternist::GenericDynamicContext::Ptr dynContext(new QPatternist::GenericDynamicContext(namePool.d, statContext->messageHandler(),
177 statContext->sourceLocations()));
178
179 QPatternist::AutoPtr<QPatternist::NodeBuilder> nodeBuilder(new QPatternist::AccelTreeBuilder<false>(QUrl(), QUrl(), namePool.d,
180 dynContext.data()));
181 dynContext->setNodeBuilder(nodeBuilder);
182
183 dynContext->setResourceLoader(statContext->resourceLoader());
184 dynContext->setExternalVariableLoader(statContext->externalVariableLoader());
185 dynContext->setUriResolver(uriResolver);
186
187 if(callback)
188 dynContext->setOutputReceiver(callback);
189
190 if(contextItem.isNull())
191 return dynContext;
192 else
193 {
194 QPatternist::DynamicContext::Ptr focus(new QPatternist::Focus(dynContext));
195 QPatternist::Item::Iterator::Ptr it(QPatternist::makeSingletonIterator(QPatternist::Item::fromPublic(contextItem)));
196 it->next();
197 focus->setFocusIterator(it);
198 return focus;
199 }
200 }
201
202 inline QPatternist::AccelTreeResourceLoader::Ptr resourceLoader()
203 {
204 if(!m_resourceLoader)
205 m_resourceLoader = (new QPatternist::AccelTreeResourceLoader(namePool.d, m_networkAccessDelegator));
206
207 return m_resourceLoader;
208 }
209
210
211 static inline QUrl normalizeQueryURI(const QUrl &uri)
212 {
213 Q_ASSERT_X(uri.isEmpty() || uri.isValid(), Q_FUNC_INFO,
214 "The URI passed to QXmlQuery::setQuery() must be valid or empty.");
215 if(uri.isEmpty())
216 return QUrl::fromLocalFile(QCoreApplication::applicationFilePath());
217 else if(uri.isRelative())
218 return QUrl::fromLocalFile(QCoreApplication::applicationFilePath()).resolved(uri);
219 else
220 return uri;
221 }
222
223 void setRequiredType(const QPatternist::SequenceType::Ptr &seqType)
224 {
225 Q_ASSERT(seqType);
226 if(!m_requiredType || m_requiredType->is(seqType))
227 return;
228
229 m_requiredType = seqType;
230 m_staticContext.reset();
231 }
232
233 QPatternist::SequenceType::Ptr requiredType()
234 {
235 if(m_requiredType)
236 return m_requiredType;
237 else
238 {
239 m_requiredType = QPatternist::CommonSequenceTypes::ZeroOrMoreItems;
240 return m_requiredType;
241 }
242 }
243
244 QPatternist::Expression::Ptr expression(QIODevice *const queryDevice = 0)
245 {
246 if(m_expr && !queryDevice)
247 return m_expr;
248
249 /* If we need to update, but we don't have any source code, we can
250 * never create an Expression. */
251 if(!queryDevice)
252 return QPatternist::Expression::Ptr();
253
254 try
255 {
256 /* The static context has source locations, and they need to be
257 * updated to the new query. */
258 m_staticContext.reset();
259
260 if(!m_expressionFactory)
261 m_expressionFactory = QPatternist::ExpressionFactory::Ptr(new QPatternist::ExpressionFactory());
262
263 m_expr = m_expressionFactory->createExpression(queryDevice, staticContext(),
264 queryLanguage,
265 requiredType(),
266 queryURI,
267 initialTemplateName);
268 }
269 catch(const QPatternist::Exception)
270 {
271 m_expr.reset();
272
273 /* We don't call m_staticContext.reset() because it shouldn't be
274 * necessary, since m_staticContext is changed when the expression
275 * is changed. */
276 }
277
278 return m_expr;
279 }
280
281 QXmlNamePool namePool;
282 QPointer<QAbstractMessageHandler> messageHandler;
283 /**
284 * Must be absolute and valid.
285 */
286 QUrl queryURI;
287 const QAbstractUriResolver * uriResolver;
288 QXmlItem contextItem;
289 QXmlName initialTemplateName;
290
291 inline void setExpressionFactory(const QPatternist::ExpressionFactory::Ptr &expr)
292 {
293 m_expressionFactory = expr;
294 }
295
296 QXmlQuery::QueryLanguage queryLanguage;
297 QPointer<QNetworkAccessManager> userNetworkManager;
298
299 inline QObject *ownerObject()
300 {
301 if(!m_owner)
302 m_owner = new QPatternist::ReferenceCountedValue<QObject>(new QObject());
303
304 return m_owner->value;
305 }
306
307 QPatternist::ExpressionFactory::Ptr m_expressionFactory;
308 QPatternist::StaticContext::Ptr m_staticContext;
309 QPatternist::VariableLoader::Ptr m_variableLoader;
310 QPatternist::DeviceResourceLoader::Ptr m_resourceLoader;
311 /**
312 * This is the AST for the query.
313 */
314 QPatternist::Expression::Ptr m_expr;
315 QPatternist::ReferenceCountedValue<QObject>::Ptr m_owner;
316
317 /**
318 * This is our effective network manager, that we end up using. The one the
319 * user sets is userNetworkManager.
320 */
321 QPatternist::SequenceType::Ptr m_requiredType;
322 QPatternist::FunctionFactory::Ptr m_functionFactory;
323 QPatternist::NetworkAccessDelegator::Ptr m_networkAccessDelegator;
324};
325
326QT_END_NAMESPACE
327
328QT_END_HEADER
329
330#endif
Note: See TracBrowser for help on using the repository browser.