QAbstractUriResolver

Detailed Description

The PySide.QtXmlPatterns.QAbstractUriResolver class is a callback interface for resolving Uniform Resource Identifiers.

A Uniform Resource Identifier (URI) is a string that uniquely identifies a resource. URIs are versatile global identifiers. It is often useful to transform a URI that identifies something logical into a URI that locates something physical (a URL), or to simply map a URI to a different URI. QAbstractUriResolver.resolve() provides this functionality.

For example, one could write a PySide.QtXmlPatterns.QAbstractUriResolver subclass that rewrites library ISBN number URIs as book title URLs, e.g., urn:isbn:0-345-33973-8 would be rewritten as file:///books/returnOfTheKing.doc . Or a PySide.QtXmlPatterns.QAbstractUriResolver subclass could be written for a web browser to let the web browser protect the user’s private files by mapping incoming requests for them to null URIs.

See also

class PySide.QtXmlPatterns.QAbstractUriResolver([parent=None])

Parameters:parent – PySide.QtCore.QObject

Constructs a PySide.QtXmlPatterns.QAbstractUriResolver with the specified parent .

PySide.QtXmlPatterns.QAbstractUriResolver.resolve(relative, baseURI)

Parameters:

• relative – PySide.QtCore.QUrl
• baseURI – PySide.QtCore.QUrl

Return type:

PySide.QtCore.QUrl

Returns the relative URI resolved using the baseURI .

The caller guarantees that both relative and baseURI are valid, and that baseURI is absolute. relative can be relative, absolute, or empty.

The returned PySide.QtCore.QUrl can be a default constructed PySide.QtCore.QUrl . If it is not a default constructed PySide.QtCore.QUrl , it will be absolute and valid. If a default constructed PySide.QtCore.QUrl is returned, it means the relative URI was not accepted to be resolved.

If the reimplemented PySide.QtXmlPatterns.QAbstractUriResolver.resolve() function decides it has nothing to do about resolving the relative URI, it should simply return the relative URI resolved against the baseURI , i.e.:

return baseURI.resolved(relative);

See also

QUrl.isRelative() QUrl.isValid()