Overview

Stylus Studio can read and write well-formed XML documents ( .xml, .xsl, and so on) from/to Berkeley DB XML container files (containers). Containers typically have a .dbxml extension. In Stylus Studio, you reference external files using a URL. The URL used to access Berkeley DB XML files is dbxml:///container_pathname /filename .xml:

  • dbxml is the prefix that specifies that files will be read from Berkeley DB XML
  • container_pathname is the pathname of a Berkeley DB XML container
  • filename.xml is the name of the file you wish to access within that container

For example, to access one of the sample files provided with Berkeley DB XML, you might enter the following in the URL field of the Stylus Studio Open dialog box: dbxml:///C:/samples/simpleExampleData.dbxml/Allspice.xml.

Note that the container name ( C:/samples/simpleExampleData.dbxml in the example) appears in the URL field as if it were a directory name. This is because Stylus Studio treats Berkeley DB XML containers very much like directories, and the XML documents stored within a container are treated like files within a directory.

You can save files back to the same container from which they were read, to a new container, or to some other file system (your local machine, for example).

Note

 

You can use a Berkeley DB XML URL to open an XML document anywhere you can specify URLs in Stylus Studio. For example, you can use the Berkeley DB XML URL to specify the source document for XQuery Mapper.

Berkeley DB XML Support

Stylus Studio supports the following versions of Berkeley DB XML:

  • 1.2.1
  • 2.0.7
  • 2.0.9.
  • 2.1.8
  • 2.2.5
  • 2.2.8

Each version is associated with specific .dll and .jar files that Stylus Studio must be able to access. See Prerequisites for more information.

Usage Summary

The process for using Stylus Studio with Berkeley DB XML consists of the following steps:

1. Make Berkeley DB XML .jar and .dll files accessible to Stylus Studio. See Prerequisites for more information on this step.
2. Configure the BerkeleyDBXML.xml file as described in Configuring the BerkeleyDBXML.xml File.
3. Open Berkeley DB XML files in Stylus Studio as described in Opening a File Stored on Berkeley DB XML.
4. Optionally, save your work back to Berkeley DB XML as described in Saving a File Back to Berkeley DB XML.

Each of these steps is described in greater detail in the sections that follow.

 
Free Stylus Studio XML Training:
W3C Member