| /**************************************************************************** |
| ** |
| ** Copyright (C) 2016 The Qt Company Ltd. |
| ** Contact: https://www.qt.io/licensing/ |
| ** |
| ** This file is part of the QtXmlPatterns 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 The Qt Company. For licensing terms |
| ** and conditions see https://www.qt.io/terms-conditions. For further |
| ** information use the contact form at https://www.qt.io/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 3 as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.LGPL3 included in the |
| ** packaging of this file. Please review the following information to |
| ** ensure the GNU Lesser General Public License version 3 requirements |
| ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. |
| ** |
| ** GNU General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU |
| ** General Public License version 2.0 or (at your option) the GNU General |
| ** Public license version 3 or any later version approved by the KDE Free |
| ** Qt Foundation. The licenses are as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 |
| ** included in the packaging of this file. Please review the following |
| ** information to ensure the GNU General Public License requirements will |
| ** be met: https://www.gnu.org/licenses/gpl-2.0.html and |
| ** https://www.gnu.org/licenses/gpl-3.0.html. |
| ** |
| ** $QT_END_LICENSE$ |
| ** |
| ****************************************************************************/ |
| |
| // |
| // W A R N I N G |
| // ------------- |
| // |
| // This file is not part of the Qt API. It exists purely as an |
| // implementation detail. This header file may change from version to |
| // version without notice, or even be removed. |
| // |
| // We mean it. |
| |
| #ifndef Patternist_AnyURI_H |
| #define Patternist_AnyURI_H |
| |
| #include <QUrl> |
| #include <QtDebug> |
| |
| #include <private/qatomicstring_p.h> |
| #include <private/qbuiltintypes_p.h> |
| #include <private/qpatternistlocale_p.h> |
| #include <private/qreportcontext_p.h> |
| |
| QT_BEGIN_NAMESPACE |
| |
| namespace QPatternist |
| { |
| /** |
| * @short A value of type <tt>xs:anyURI</tt>. |
| * |
| * Due to bugs in QUrl and slight differences in behavior and |
| * interpretation, QUrl can never be used directly for dealing with URIs, |
| * values of type @c xs:anyURI. Therefore, it's important to use the |
| * functionality this class provides, such as the functions toQUrl(), |
| * fromLexical(), isValid(), and resolveURI(). |
| * |
| * @see QUrl |
| * @author Frans Englich <frans.englich@nokia.com> |
| * @ingroup Patternist_xdm |
| */ |
| class AnyURI : public AtomicString |
| { |
| public: |
| typedef QExplicitlySharedDataPointer<AnyURI> Ptr; |
| |
| /** |
| * Creates an instance representing @p value. |
| * |
| * @note @p value must be a valid @c xs:anyURI. If it is of interest |
| * to construct from a lexical representation, use fromLexical(). |
| */ |
| static AnyURI::Ptr fromValue(const QString &value); |
| |
| static AnyURI::Ptr fromValue(const QUrl &uri); |
| |
| /** |
| * @short Treates @p value as a lexical representation of @c xs:anyURI |
| * but returns the value instance as a QUrl. |
| * |
| * If @p value is not a valid lexical representation of @c xs:anyURI, |
| * an error is issued via @p context. |
| * |
| * If @p isValid is passed, no error is raised and it is instead set |
| * appropriately. |
| */ |
| template<const ReportContext::ErrorCode code, typename TReportContext> |
| static inline QUrl toQUrl(const QString &value, |
| const TReportContext &context, |
| const SourceLocationReflection *const r, |
| bool *const isValid = 0, |
| const bool issueError = true) |
| { |
| /* QUrl doesn't flag ":/..." so we workaround it. */ |
| const QString simplified(value.simplified()); |
| const QUrl uri(simplified, QUrl::StrictMode); |
| |
| if(uri.isEmpty() || (uri.isValid() && (!simplified.startsWith(QLatin1Char(':')) || !uri.isRelative()))) |
| { |
| if(isValid) |
| *isValid = true; |
| |
| return uri; |
| } |
| else |
| { |
| if(isValid) |
| *isValid = false; |
| |
| if(issueError) |
| { |
| context->error(QtXmlPatterns::tr("%1 is not a valid value of type %2.").arg(formatURI(value), formatType(context->namePool(), BuiltinTypes::xsAnyURI)), |
| code, r); |
| } |
| |
| return QUrl(); |
| } |
| } |
| |
| /** |
| * @short Return @c true if @p candidate is a valid @c xs:anyURI, |
| * otherwise @c false. |
| */ |
| static bool isValid(const QString &candidate); |
| |
| /** |
| * @short Constructs a @c xs:anyURI value from the lexical representation @p value. |
| * |
| * If @p value is not a valid lexical representation of @c xs:anyURI, |
| * an error is issued via @p context. |
| */ |
| template<const ReportContext::ErrorCode code, typename TReportContext> |
| static inline AnyURI::Ptr fromLexical(const QString &value, |
| const TReportContext &context, |
| const SourceLocationReflection *const r) |
| { |
| return AnyURI::Ptr(new AnyURI(toQUrl<code>(value, context, r).toString())); |
| } |
| |
| /** |
| * If @p value is not a valid lexical representation for @c xs:anyURI, |
| * a ValidationError is returned. |
| */ |
| static AnyURI::Ptr fromLexical(const QString &value); |
| |
| /** |
| * Creates an AnyURI instance representing an absolute URI which |
| * is created from resolving @p relative against @p base. |
| * |
| * This function must be compatible with the resolution semantics |
| * specified for fn:resolve-uri. In fact, the implementation of fn:resolve-uri, |
| * ResourceURIFN, relies on this function. |
| * |
| * @see <a href="http://www.faqs.org/rfcs/rfc3986.html">RFC 3986 - Uniform |
| * Resource Identifier (URI): Generic Syntax</a> |
| * @see <a href ="http://www.w3.org/TR/xpath-functions/#func-resolve-uri">XQuery 1.0 |
| * and XPath 2.0 Functions and Operators, 8.1 fn:resolve-uri</a> |
| */ |
| static AnyURI::Ptr resolveURI(const QString &relative, |
| const QString &base); |
| |
| virtual ItemType::Ptr type() const; |
| |
| /** |
| * @short Returns this @c xs:anyURI value in a QUrl. |
| */ |
| inline QUrl toQUrl() const |
| { |
| Q_ASSERT_X(QUrl(m_value).isValid(), Q_FUNC_INFO, |
| qPrintable(QString::fromLatin1("%1 is apparently not ok for QUrl.").arg(m_value))); |
| return QUrl(m_value); |
| } |
| protected: |
| friend class CommonValues; |
| |
| AnyURI(const QString &value); |
| }; |
| |
| /** |
| * @short Formats @p uri, that's considered to be a URI, for display. |
| */ |
| static inline QString formatURI(const NamePool::Ptr &np, const QXmlName::NamespaceCode &uri) |
| { |
| return formatURI(np->stringForNamespace(uri)); |
| } |
| } |
| |
| QT_END_NAMESPACE |
| |
| #endif |