The RCRT XML-Space

Downloading and Installing XML-Space Software

The XML-Space distribution comes in the form of a zip archive, which includes all of the necessary software, see the: 'Getting Started with the RCRT XML-Space' document for details.

• The distribution can be downloaded from: our downloads area.

Contents of the XML-Space Distribution

The contents of the distribution are shown below:

 --# XMLSpace-<version>
   |
   |-- ReadMe.txt
   |
   |--# clients
   |  |-- XMLSpaceClient.jar
   |  |-- XMLSpaceSOAPClient.jar
   |  |-- XMLSpaceTCPClient.jar
   |  |-- XMLSpaceJiniClient.jar
   |  |-- XMLSpaceRMIClient.jar
   |  '-- XMLClientObjects.jar
   |
   |--# server
   |  '-- XMLSpace.war
   |
   |--# dl-archives
   |  |-- XMLSpaceRMIConnector-dl.jar
   |  |-- XMLSpaceRMIClient-dl.jar
   |  |-- XMLSpaceJiniConnector-dl.jar
   |  '-- XMLSpaceJiniClient-dl.jar
   |
   |--# junit
   |  |
   |  |--# lib
   |  |  '-- XMLSpaceJUnit.jar
   |  |
   |  |--# scripts
   |  |  |-- runJUnit.cmd
   |  |  |-- setTCPClientPath.cmd
   |  |  |-- setSOAPClientPath.cmd
   |  |  |-- setRMIClientPath.cmd
   |  |  |-- setJiniClientPath.cmd
   |  |  |
   |  |  '--# policy
   |  |     '-- policy.all
   |  |
   |  '--# src
   |     '-- (junit source files)
   |
   |--# docs
   |  |
   |  |--# manuals
   |  |  |-- XMLSpaceGettingStarted.pdf
   |  |  |-- XMLSpaceTechManual.pdf
   |  |  '-- XMLSpaceTechManual.chm
   |  |
   |  '--# javadoc
   |     '-- (client & junit javadoc files)
   |
   '--# thirdparty
      '-- (other jar archives required by clients)

» 'clients' directory

This directory contains the various client library archives:

• XMLSpaceClient.jar
  Contains the client components that are shared by all client types.
• XMLSpace***Client.jar
  Contains the individual client implementations for the different communication protocols.
• XMLClientObjects.jar
  Contains a set of java convenience classes that can be used to create and manipulate the xml-space api elements programmatically.

» 'server' directory

This contains the following web archive:

• XMLSpace.war
  This is self-contained, it does not need to be unpacked. It can be used 'as-is' to install the xml-space server directly onto an Apache Tomcat web server.

» 'junit' directory

This contains three sub-directories, 'src', 'lib' and 'scripts':

• src directory.
  Contains the source code for the junit test suites.
• lib directory.
  Contains the XMLSpaceJUnit.jar archive, which contains all the corresponding java class files.
• scripts directory.
  Contains the runJUnit.cmd script that can be used to run the test suite(s) under Windows.
  The other set***ClientPath.cmd scripts are called by runJUnit to set the the classpath, according to the type of client is being used to run the tests. The policy subdirectory contains a security policy file, which is required by both the RMI and Jini space clients.
  • Note: 'policy.all' is an insecure policy file is only suitable for test purposes.

» 'docs' directory

This contains two sub-directories, 'javadoc' and 'manuals':

• javadoc directory
  Contains javadoc documentation for the relevant xml-space client and junit classes.
• manuals directory
  Contains the 'Getting Started with the RCRT XML-Space' guide in pdf format, and two copies of the 'XML-Space Technical Manual'; one in pdf format and one in chm (html help file) format.

» 'thirdparty' directory

• This contains all of the various thirdparty libraries/archives which are needed in different combinations by the various xml-space client components.