| <!-- |
| Licensed to the Apache Software Foundation (ASF) under one or more |
| contributor license agreements. See the NOTICE file distributed with |
| this work for additional information regarding copyright ownership. |
| The ASF licenses this file to You under the Apache License, Version 2.0 |
| (the "License"); you may not use this file except in compliance with |
| the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| See the License for the specific language governing permissions and |
| limitations under the License. |
| --> |
| <document> |
| |
| <properties> |
| <title>Download</title> |
| <author email="dev@commons.apache.org">Apache Commons Developers</author> |
| </properties> |
| |
| <body> |
| <section name="Download"> |
| <p> |
| The latest release (binaries and source) of Commons VFS can be found |
| <a href="download_vfs.cgi">here</a>. |
| </p> |
| <p> |
| You will also need to download the <a href="commons-vfs2/dependencies.html">dependencies</a> (jars) used by Apache Commons VFS. |
| You can download the jars from the list below; with Apache Maven dependency resolution is automatic. |
| </p> |
| <table> |
| <tr> |
| <th>Dependency</th> |
| <th>Required For</th> |
| </tr> |
| <tr> |
| <td> |
| <a href="http://commons.apache.org/logging/">Apache Commons Logging</a> |
| </td> |
| <td>All</td> |
| </tr> |
| <tr> |
| <td> |
| <a href="http://commons.apache.org/lang/">Apache Commons Lang</a> |
| </td> |
| <td>All</td> |
| </tr> |
| <tr> |
| <td> |
| <a href="http://commons.apache.org/collections/">Apache Commons Collections</a> |
| </td> |
| <td>LRU Cache (optional)</td> |
| </tr> |
| <tr> |
| <td> |
| <a href="http://commons.apache.org/compress/">Apache Commons Compress</a> |
| </td> |
| <td>TAR, Bzip2</td> |
| </tr> |
| <tr> |
| <td> |
| <a href="http://commons.apache.org/net/">Apache Commons Net</a> |
| </td> |
| <td>FTP</td> |
| </tr> |
| <tr> |
| <td> |
| <a href="http://commons.apache.org/httpclient/">Apache Commons Httpclient</a><br/> |
| Requires <a href="http://commons.apache.org/proper/commons-codec/">Commons Codec</a> |
| </td> |
| <td>WebDAV, HTTP, URI Utils</td> |
| </tr> |
| <tr> |
| <td> |
| <a href="http://jackrabbit.apache.org/jackrabbit-webdav-library.html">Apache Jackrabbit WebDAV Library</a><br/> |
| Requires <a href="http://jackrabbit.apache.org/jackrabbit-jcr-commons.html">Jackrabbit JCR Commons</a> |
| and <a href="http://www.slf4j.org">SLF4J</a> (Api and Impl). |
| </td> |
| <td>WebDAV</td> |
| </tr> |
| <tr> |
| <td> |
| <a href="http://www.jcraft.com/jsch/">JSch</a> |
| </td> |
| <td>SFTP</td> |
| </tr> |
| <tr> |
| <td> |
| <a href="http://hadoop.apache.org/docs/stable/">Apache Hadoop Common</a><br/> |
| <a href="http://hadoop.apache.org/docs/stable/">Apache Hadoop HDFS Common</a><br/> |
| This requires a number of dependencies, use <code>$HADOOP_HOME/bin/hadoop classpath</code> command. |
| </td> |
| <td>HDFS</td> |
| </tr> |
| <tr> |
| <td> |
| <a href="http://jcifs.samba.org/">jCIFS</a> |
| </td> |
| <td>CIFS (VFS sandbox)</td> |
| </tr> |
| <tr> |
| <td> |
| <a href="http://java.sun.com/products/javamail/">javamail</a> |
| </td> |
| <td>mime (VFS sandbox)</td> |
| </tr> |
| </table> |
| </section> |
| <section name="Building Commons VFS"> |
| <p> |
| To build Commons VFS, get the <a href="scm.html">sources</a> and use <a href="http://maven.apache.org">Apache Maven</a> 3.2.5 or later. |
| You need to use Java 8 or later. Production builds can be done with the |
| <code>-Pjava-1.8</code> profile from Commons Parent (which will compile and test with a JDK |
| from the JAVA_1_8_HOME environment variable). |
| </p><p> |
| Use <code>mvn clean verify</code> to locally build and test the <code>core</code> and |
| <code>examples</code> modules. This will build the core JAR files in |
| <code>commons-vfs/core/target/commons-vfs2-<version>.jar</code>. |
| </p><p> |
| If you want to build the additional sandbox file systems as well, use |
| <code>mvn -Pinclude-sandbox clean verify</code>. This will also create the sandbox |
| components in <code>commons-vfs/sandbox/target/commons-vfs2-sandbox-<version>.jar</code>. |
| </p><p> |
| See the <a href="commons-vfs2-example/index.html">commons-vfs2-example</a> Module on how |
| to use VFS Example Shell to verify the result. |
| </p> |
| </section> |
| </body> |
| </document> |