|  |
Virtual XML Garden
An implementation of XPath and XQuery for processing (and combining) many kinds of structured and formatted data as if it were all XML. (This is an ETTK technology.)
Date Posted: November 3, 2005
|
This is an  technology.
|
|
|
|
Platform requirements
Software: Java2 Standard Edition (J2SE) run-time environment (JRE), Version 1.4 or above
Installation instructions
- Download and unpack the virtualxml.zip archive file. This action will create a subdirectory called Virtual-XML-Garden that includes the following files:
- licenses is a directory including the alphaWorks 90-day license (in several languages), to which you agreed when downloading, as well as the licenses for the included Xerces and Eclipse XSD libraries.
- index.html has links to the documentation and examples.
- virtualxml.jar is the Java archive file with the main executable file and libraries.
- lib is a directory that contains some necessary, extra Java archives.
- Decide which additional functionality you want enabled. Download any of the following external libraries
(it is your responsibility to verify in each case that your intended use is consistent with the specific license):
- An implementation of XPP3 (XmlPullParser Version 3) is strongly recommended because it significantly enhances the speed of reading "normal" XML documents from text files.
- Access to SDO (Service Data Objects, Version 2.0.1) allows the use of SDO support. Download tuscany-incubating-M1.zip and move the sdo-api-incubating-M1.jar archive file into your path.
- Access to Exif/JPEG images depends on the metadada-extractor for exif library, which provides an API for accessing Exif files.
- Converting HTML to XHTML requires jtidy, which loads and cleans up HTML files.
- Instructions for use of Virtual XML Garden with relational databases through the JDBC (Java DataBase Connectivity) mechanism are located in samples/sql-xml/index.html and samples/web-row-set/index.html (along with complete examples for IBM's DB2 database and the Apache Derby database).
- Use of Virtual XML Garden with IBM IMS (Information Management System) hierarchical databases requires specific Java libraries as described (with a complete example) in samples/ims/index.html.
- Make sure that all the Java archive (.jar) files in the lib subdirectory are included in the CLASSPATH to be used by your Java run-time environment.
- Make sure that any optional libraries necessary for additional functionality are also in the CLASSPATH to be used.
- Make sure that the main virtualxml.jar file is also in the CLASSPATH to be used.
- In order to verify that the installation is working, please perform the "smoke test" by executing the following:
java com.ibm.xml.xq.virtual.Virtual
|
That execution should write out something like the following:
Wrong number of arguments
Usage: [-help|-language=LANGUAGE| -optimize=N| -verbose=N|-timing|-safe|-output=FILE|-input=FILE] (EXPRESSION | -file FILE)
-LANGUAGE should be one of -XPath-1.0, -XPath-2.0, or -Xquery-1.0.
|
Significantly different output (such as a class path error) indicates an installation error.
For convenience, two scripts have been included that implement the above rules:
- virtualxml.sh is for POSIX "shell" command interpreters used, for example, by GNU/Linux systems.
- virtualxml.bat is for DOS "batch" command interpreters used by Microsoft systems.
The scripts work only when the script itself remains in the same directory as virtualxml.jar and lib directory and when the scripts do not include any optional libraries in the CLASSPATH.
|
|
|
|
| |
|
