This XQuery Module provides functions to fetch the content of resources identified by URIs. Resources can be stored locally or remotely and e.g. use the file://
or http://
scheme. The [HTML Module] can be used to convert retrieved HTML documents to XML.
The module has been inspired by Zorba’s Fetch Module.
Conventions
All functions in this module are assigned to the http://basex.org/modules/fetch
namespace, which is statically bound to the fetch
prefix.
All errors are assigned to the http://basex.org/errors
namespace, which is statically bound to the bxerr
prefix.
Functions
fetch:content
Signatures
|
fetch:content($uri as xs:string) as xs:string
fetch:content($uri as xs:string, $encoding as xs:string) as xs:string
|
Summary
|
Fetches the resource referred to by the given URI and returns it as string.
|
Errors
|
BXFE0001 : the URI could not be resolved, or the resource could not be retrieved.
BXFE0002 : the specified encoding is not supported, or unknown.
|
Examples
|
fetch:content("http://en.wikipedia.org") returns a string representation of the English Wikipedia main HTML page.
|
fetch:content-binary
Signatures
|
fetch:content-binary($uri as xs:string) as xs:base64Binary
|
Summary
|
Fetches the resource referred to by the given URI and returns it as base64Binary.
|
Errors
|
BXFE0001 : the URI could not be resolved, or the resource could not be retrieved.
|
Examples
|
fetch:content-binary("http://images.trulia.com/blogimg/c/5/f/4/679932_1298401950553_o.jpg") returns the addressed image.
|
Errors
Code
|
Description
|
BXFE0001
|
The URI could not be resolved, or the resource could not be retrieved.
|
BXFE0002
|
The specified encoding is not supported, or unknown.
|
Changelog
The module was introduced with Version 7.5.1.