Skip to main content

Source code file content

Revision: 14

more fixes to docs
» Project Revision History

» Checkout URL

svn / trunk / www / download.html

Size: 13581 bytes, 1 line
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><meta content="Website XSL Stylesheet V2.5.0" name="generator"><link rel="home" href="index.html" title="JABBER Stream Objects"><link rel="up"
href="/" title="JABBER Stream Objects"><link rel="previous" href="/" title="JABBER Stream Objects"><link rel="next" href="docs.html" title="Documentation"><link rel="last" href="license.html" title="Licensing"><link href="doc/web-style.css" rel="stylesheet" type="text/css">
    <title>Obtaining and Using</title>
    
  </head><body class="tabular" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="webpage"><a name="download"></a><span class="banner"><h1><a
href="/">JSO</a> :: Obtaining and Using</h1></span><table border="0" cellpadding="0" cellspacing="0" width="100%" summary="Navigation"><tr><td><img height="1" width="1" alt=" " src="graphics/spacer.gif"></td><td valign="top" align="left" bgcolor="white" class="content" rowspan="2"><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="NF0013"></a>Prerequisites</h2></div></div><div></div></div><p>JSO has a number of dependencies. Depending on the JARs used, the only dependency that must be met is the J2SE runtime environment.</p><div class="informaltable"><table border="0" style="border-collapse: collapse;"><colgroup><col><col><col><col></colgroup><thead><tr><th style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Name</th><th style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Version</th><th style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">License</th><th style="border-bottom: 0.5pt solid ; ">Additional Information</th></tr></thead><tbody><tr><td style="border-right: 0.5pt solid ; ">J2SE</td><td style="border-right: 0.5pt solid ; ">1.4 or higher</td><td style="border-right: 0.5pt solid ; ">Sun Microsystems, Inc. Binary Code License Agreement</td><td style=""><a href="http://java.sun.com/j2se/1.4/" target="_top">http://java.sun.com/j2se/1.4/</a></td></tr><tr><td style="border-right: 0.5pt solid ; ">Jaxen</td><td style="border-right: 0.5pt solid ; ">1.0-FCS</td><td style="border-right: 0.5pt solid ; "><a href="doc/licenses/jaxen.txt" target="_top">Apache-style</a></td><td style=""><a href="http://jaxen.sourceforge.net/" target="_top">http://jaxen.sourceforge.net/</a></td></tr><tr><td style="border-right: 0.5pt solid ; ">SAXPath</td><td style="border-right: 0.5pt solid ; ">1.0 or higher</td><td style="border-right: 0.5pt solid ; "><a href="doc/licenses/jaxen.txt" target="_top">Apache-style</a></td><td style=""><a href="http://jaxen.sourceforge.net/" target="_top">http://jaxen.sourceforge.net/</a></td></tr><tr><td style="border-right: 0.5pt solid ; ">Jakarta log4j</td><td style="border-right: 0.5pt solid ; ">1.2.8 or higher</td><td style="border-right: 0.5pt solid ; "><a href="doc/licenses/log4j.txt" target="_top">Apache Public License</a></td><td style=""><a href="http://logging.apache.org/log4j/" target="_top">http://logging.apache.org/log4j/</a></td></tr><tr><td style="border-right: 0.5pt solid ; ">XP XML Parser</td><td style="border-right: 0.5pt solid ; ">0.5</td><td style="border-right: 0.5pt solid ; "><a href="doc/licenses/xp.txt" target="_top">BSD</a></td><td style=""><a href="http://jclark.com/xml/xp/" target="_top">http://jclark.com/xml/xp/</a></td></tr></tbody></table></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="NF006D"></a>Downloading</h2></div></div><div></div></div><p>There are two places a complete JSO binary distribution can be obtained from:</p><div class="itemizedlist"><ul type="disc"><li><p><a href="http://www.jabberstudio.org/projects/jso/releases/" target="_top">Stable Releases</a></p></li><li><p><a href="http://jso.jabberstudio.org/files/dev/" target="_top">Development Snapshots</a></p></li></ul></div><p>The most commonly-used binaries are listed below. These binaries rebundle all of their library dependencies into the single JAR<sup>[<a href="#ftn.NF007F" name="NF007F">1</a>]</sup>.</p><div class="informaltable"><table border="0" style="border-collapse: collapse;"><colgroup><col><col><col></colgroup><thead><tr><th style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Filename</th><th style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Checksum</th><th style="border-bottom: 0.5pt solid ; ">Description</th></tr></thead><tbody><tr><td style="border-right: 0.5pt solid ; "><a href="bin/jso-full.jar" target="_top">jso-full.jar</a></td><td style="border-right: 0.5pt solid ; "><a href="bin/jso-full.jar.md5" target="_top">MD5</a></td><td style="">The complete binary package, including dependencies.</td></tr><tr><td style="border-right: 0.5pt solid ; "><a href="bin/jso-full.src.jar" target="_top">jso-full.src.jar</a></td><td style="border-right: 0.5pt solid ; "><a href="bin/jso-full.src.jar.md5" target="_top">MD5</a></td><td style="">The complete binary + source package, including dependencies.</td></tr></tbody></table></div><p>Additionally, the following binaries are supplied for selecting just the functionality required:</p><div class="informaltable"><table border="0" style="border-collapse: collapse;"><colgroup><col><col><col></colgroup><thead><tr><th style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Filename</th><th style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Checksum</th><th style="border-bottom: 0.5pt solid ; ">Description</th></tr></thead><tbody><tr><td style="border-right: 0.5pt solid ; "><a href="bin/jso-core.jar" target="_top">jso-core.jar</a></td><td style="border-right: 0.5pt solid ; "><a href="bin/jso-core.jar.md5" target="_top">MD5</a></td><td style="">The core interfaces and classes to JSO, including the API and reference implementation.</td></tr><tr><td style="border-right: 0.5pt solid ; "><a href="bin/jso-sasl.jar" target="_top">jso-sasl.jar</a></td><td style="border-right: 0.5pt solid ; "><a href="bin/jso-sasl.jar.md5" target="_top">MD5</a></td><td style="">The interfaces and classes for SASL support.</td></tr><tr><td style="border-right: 0.5pt solid ; "><a href="bin/jso-x-core.jar" target="_top">jso-x-core.jar</a></td><td style="border-right: 0.5pt solid ; "><a href="bin/jso-x-core.jar.md5" target="_top">MD5</a></td><td style="">The interfaces and classes for the "core" extensions.</td></tr><tr><td style="border-right: 0.5pt solid ; "><a href="bin/jso-x-info.jar" target="_top">jso-x-info.jar</a></td><td style="border-right: 0.5pt solid ; "><a href="bin/jso-x-info.jar.md5" target="_top">MD5</a></td><td style="">The interfaces and classes for the "informational" extensions.</td></tr><tr><td style="border-right: 0.5pt solid ; "><a href="bin/jso-x-disco.jar" target="_top">jso-x-disco.jar</a></td><td style="border-right: 0.5pt solid ; "><a href="bin/jso-x-disco.jar.md5" target="_top">MD5</a></td><td style="">The interfaces and classes for the "Service Discovery" extensions.</td></tr><tr><td style="border-right: 0.5pt solid ; "><a href="bin/jso-x-xdata.jar" target="_top">jso-x-xdata.jar</a></td><td style="border-right: 0.5pt solid ; "><a href="bin/jso-x-xdata.jar.md5" target="_top">MD5</a></td><td style="">The interfaces and classes for the "jabber:x:data" extension.</td></tr><tr><td style="border-right: 0.5pt solid ; "><a href="bin/jso-x-fneg.jar" target="_top">jso-x-fneg.jar</a></td><td style="border-right: 0.5pt solid ; "><a href="bin/jso-x-fneg.jar.md5" target="_top">MD5</a></td><td style="">The interfaces and classes for the "Feature Negotiation" extensions.</td></tr><tr><td style="border-right: 0.5pt solid ; "><a href="bin/jso-x-si.jar" target="_top">jso-x-si.jar</a></td><td style="border-right: 0.5pt solid ; "><a href="bin/jso-x-si.jar.md5" target="_top">MD5</a></td><td style="">The interfaces and classes for the "Stream Initiation" extensions.</td></tr><tr><td style="border-right: 0.5pt solid ; "><a href="bin/jso-x-sift.jar" target="_top">jso-x-sift.jar</a></td><td style="border-right: 0.5pt solid ; "><a href="bin/jso-x-sift.jar.md5" target="_top">MD5</a></td><td style="">The interfaces and classes for the "Stream Initiation: File Tranfer Profile" extensions.</td></tr><tr><td style="border-right: 0.5pt solid ; "><a href="bin/jso-x-commands.jar" target="_top">jso-x-commands.jar</a></td><td style="border-right: 0.5pt solid ; "><a href="bin/jso-x-commands.jar.md5" target="_top">MD5</a></td><td style="">The interfaces and classes for the "Ad-Hoc Commands" extensions.</td></tr></tbody></table></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="NF0171"></a>Building</h2></div></div><div></div></div><p>The project distribution is needed to build JSO. It is available through CVS. There is a branch for each "major" version (e.g. 0.2, 0.4), labelled <span class="strong">RLS-&lt;version&gt;</span>, where &lt;version&gt; is the release number (with decimals replaced with underscores). The HEAD branch contains the latest unreleased, usually unstable, development work.</p><div class="informaltable"><table border="0" style="border-collapse: collapse;"><colgroup><col><col></colgroup><thead><tr><th style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">CVSROOT</th><th style="border-bottom: 0.5pt solid ; ">module</th></tr></thead><tbody><tr><td style="border-right: 0.5pt solid ; ">:pserver:anonymous@jabberstudio.org:/home/cvs</td><td style="">jso</td></tr></tbody></table></div><p>The project is built using <a href="http://ant.apache.org/" target="_top">ant</a>(version 1.5.3 or higher). The build scripts require <a href="http://junit.org/" target="_top">junit</a> (version 3.8 or higher) and Xalan (2.4.x) to complete successfully.</p><p>In the project root directory, running "ant" with no additional arguments will create a "dist" directory, which contains the "package" directory. This final directory contains exactly what is provided by the binary distributions.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="NF0199"></a>Installing</h2></div></div><div></div></div><p>The easiest method of installing JSO is to place "jso-full.jar" in the classpath. This JAR contains the interfaces, implementation, and dependencies (aside from the JRE). Alternatively, "jso-full.src.jar" can be used.</p><p>For a more granular installation, include "jso-core.jar" and any extensions desired. This method is especially useful if the dependencies are already met, and/or the provided extensions are replaced by other implementations.</p></div><div class="footnotes"><hr align="left" width="100"><div class="footnote"><p><sup>[<a href="#NF007F" name="ftn.NF007F">1</a>] </sup>This rebundling does not include the following packages (or their sub-packages):</p><div class="itemizedlist"><ul type="disc"><li><p><tt class="literal">org.apache.log4j.chainsaw</tt></p></li><li><p><tt class="literal">org.apache.log4j.jdbc</tt></p></li><li><p><tt class="literal">org.apache.log4j.jmx</tt></p></li><li><p><tt class="literal">org.apache.log4j.lf5</tt></p></li><li><p><tt class="literal">org.apache.log4j.net</tt></p></li><li><p><tt class="literal">org.apache.log4j.nt</tt></p></li><li><p><tt class="literal">org.apache.log4j.or.jms</tt></p></li><li><p><tt class="literal">com.jclark.xml</tt> (only classes/interfaces excluded)</p></li><li><p><tt class="literal">com.jclark.xml.apps</tt></p></li><li><p><tt class="literal">com.jclark.xml.output</tt></p></li><li><p><tt class="literal">com.jclark.xml.parse</tt></p></li><li><p><tt class="literal">com.jclark.xml.sax</tt></p></li></ul></div></div></div><br></td></tr><tr><td valign="top" align="left" bgcolor="" width="160"><p class="navtoc"><span class="toplevel">&nbsp;&nbsp;&nbsp;+<span class="curpage">Obtaining</span><br></span><span class="toplevel">&nbsp;&nbsp;&nbsp;&nbsp;<span class="otherpage"><a href="docs.html">Documentation</a></span><br></span><span class="toplevel">&nbsp;&nbsp;&nbsp;&nbsp;<span class="otherpage"><a href="faq.html">FAQ</a></span><br></span><span class="toplevel">&nbsp;&nbsp;&nbsp;&nbsp;<span class="otherpage"><a href="status.html">Status</a></span><br></span><span class="toplevel">&nbsp;&nbsp;&nbsp;&nbsp;<span class="otherpage"><a href="resources.html">Resources</a></span><br></span><span class="toplevel">&nbsp;&nbsp;&nbsp;&nbsp;<span class="otherpage"><a href="license.html">Licensing</a></span><br></span><br></p></td></tr></table><div class="navfoot"><table summary="Footer navigation" border="0" width="100%"><tr><td align="left" width="33%"><span class="footdate">Version JSO-0.12.5</span></td><td align="center" width="34%"><span class="foothome"><a
href="/">Home</a></span></td><td align="right" width="33%">&nbsp;</td></tr><tr><td align="center" colspan="3"><span class="footcopy"><span class="copyright">Copyright &copy; 2002, 2003, 2004 Matthew A. Miller. </span></span></td></tr><tr><td align="center" colspan="3"><span class="footcopy"><span class="strong"><span class="trademark">Jabber</span>&reg;</span> is a registered trademark of Jabber, Inc.</span></td></tr><tr><td align="center" colspan="3"><span class="footcopy"><span class="strong"><span class="trademark">Java</span>&reg;</span> is a registered trademark of Sun Microsystems, Inc.</span></td></tr></table></div></div></body></html>
 
 
Close
loading
Please Confirm
Close