| <document> |
| |
| <properties> |
| <title>Supported File Systems</title> |
| <author email="adammurdoch@apache.org">Adam Murdoch</author> |
| <author email="imario@apache.org">Mario Ivankovits</author> |
| </properties> |
| |
| <body> |
| <section name="Supported File Systems"> |
| <p>Commons VFS currently supports the following file systems:</p> |
| <ul> |
| <li> |
| <a href="#CIFS">CIFS</a> |
| </li> |
| <li> |
| <a href="#FTP">FTP</a> |
| </li> |
| <li> |
| <a href="#Local Files">Local Files</a> |
| </li> |
| <li> |
| <a href="#HTTP and HTTPS">HTTP and HTTPS</a> |
| </li> |
| <li> |
| <a href="#SFTP">SFTP</a> |
| </li> |
| <li> |
| <a href="#Temporary Files">Temporary Files</a> |
| </li> |
| <li> |
| <a href="#WebDAV">WebDAV</a> |
| </li> |
| <li> |
| <a href="#Zip and Jar">Zip and Jar</a> |
| </li> |
| <li> |
| <a href="#gzip and bzip2">gzip and bzip2</a> |
| </li> |
| </ul> |
| </section> |
| |
| <section name="Local Files"> |
| |
| <p>Provides access to the files on the local physical file system.</p> |
| |
| <p> |
| <b>URI Format</b> |
| </p> |
| |
| <p> |
| <code>[file://] |
| <i>absolute-path</i> |
| </code> |
| </p> |
| |
| <p> |
| Where |
| <code> |
| <i>absolute-path</i> |
| </code> is a valid absolute |
| file name for the local platform. UNC names are supported |
| under Windows. |
| </p> |
| |
| <p> |
| <b>Examples</b> |
| </p> |
| <ul> |
| <li> |
| <code>file:///home/someuser/somedir</code> |
| </li> |
| <li> |
| <code>file://C:/Documents and Settings</code> |
| </li> |
| <li> |
| <code>file:////somehost/someshare/afile.txt</code> |
| </li> |
| <li> |
| <code>/home/someuser/somedir</code> |
| </li> |
| <li> |
| <code>c:\program files\some dir</code> |
| </li> |
| <li> |
| <code>c:/program files/some dir</code> |
| </li> |
| </ul> |
| </section> |
| |
| <section name="Zip and Jar"> |
| |
| <p>Provides read-only access to the contents of Zip and Jar files.</p> |
| |
| <p> |
| <b>URI Format</b> |
| </p> |
| |
| <p> |
| <code>zip:// |
| <i>zip-file-uri</i>[! |
| <i>absolute-path</i>] |
| </code> |
| </p> |
| <p> |
| <code>jar:// |
| <i>zip-file-uri</i>[! |
| <i>absolute-path</i>] |
| </code> |
| </p> |
| |
| <p> |
| Where |
| <code>zip-file-uri</code> refers to a file of any |
| supported type, including other zip files. Note that any |
| ! characters in |
| <code> |
| <i>zip-file-uri</i> |
| </code> must be escaped |
| using |
| <code>%21</code>. |
| </p> |
| |
| <p> |
| <b>Examples</b> |
| </p> |
| <ul> |
| <li> |
| <code>jar:../lib/classes.jar!/META-INF/manifest.mf</code> |
| </li> |
| <li> |
| <code>zip:http://somehost/downloads/somefile.zip</code> |
| </li> |
| <li> |
| <code>jar:zip:outer.zip%21/nested.jar!/somedir</code> |
| </li> |
| </ul> |
| |
| </section> |
| |
| <section name="gzip and bzip2"> |
| |
| <p>Provides read-only access to the contents of gzip and bzip2 files.</p> |
| |
| <p> |
| <b>URI Format</b> |
| </p> |
| |
| <p> |
| <code>gz:// |
| <i>compressed-file-uri</i> |
| </code> |
| </p> |
| <p> |
| <code>bz2:// |
| <i>compressed-file-uri</i> |
| </code> |
| </p> |
| |
| <p> |
| Where |
| <code>compressed-file-uri</code> refers to a file of any |
| supported type. There is no need to add a ! part to the uri if |
| you read the content of the file you always will get the uncompressed |
| version. |
| </p> |
| |
| <p> |
| <b>Examples</b> |
| </p> |
| <ul> |
| <li> |
| <code>gz:/my/gz/file.gz</code> |
| </li> |
| </ul> |
| |
| </section> |
| |
| <section name="HTTP and HTTPS"> |
| |
| <p>Provides access to files on an HTTP server.</p> |
| |
| <p> |
| <b>URI Format</b> |
| </p> |
| |
| <p> |
| <code>http://[ |
| <i>username</i>[: |
| <i>password</i>]@] |
| <i>hostname</i>[: |
| <i>port</i>][ |
| <i>absolute-path</i>] |
| </code> |
| </p> |
| <p> |
| <code>https://[ |
| <i>username</i>[: |
| <i>password</i>]@] |
| <i>hostname</i>[: |
| <i>port</i>][ |
| <i>absolute-path</i>] |
| </code> |
| </p> |
| |
| <p> |
| <b>Examples</b> |
| </p> |
| <ul> |
| <li> |
| <code>http://somehost:8080/downloads/somefile.jar</code> |
| </li> |
| <li> |
| <code>http://myusername@somehost/index.html</code> |
| </li> |
| </ul> |
| </section> |
| |
| <section name="WebDAV"> |
| |
| <p>Provides access to files on a WebDAV server.</p> |
| |
| <p> |
| <b>URI Format</b> |
| </p> |
| |
| <p> |
| <code>webdav://[ |
| <i>username</i>[: |
| <i>password</i>]@] |
| <i>hostname</i>[: |
| <i>port</i>][ |
| <i>absolute-path</i>] |
| </code> |
| </p> |
| |
| <p> |
| <b>Examples</b> |
| </p> |
| <ul> |
| <li> |
| <code>webdav://somehost:8080/dist</code> |
| </li> |
| </ul> |
| </section> |
| |
| <section name="FTP"> |
| |
| <p>Provides access to the files on an FTP server.</p> |
| |
| <p> |
| <b>URI Format</b> |
| </p> |
| |
| <p> |
| <code>ftp://[ |
| <i>username</i>[: |
| <i>password</i>]@] |
| <i>hostname</i>[: |
| <i>port</i>][ |
| <i>absolute-path</i>] |
| </code> |
| </p> |
| |
| <p> |
| <b>Examples</b> |
| </p> |
| <ul> |
| <li> |
| <code>ftp://myusername:mypassword@somehost/pub/downloads/somefile.tgz</code> |
| </li> |
| </ul> |
| |
| </section> |
| |
| <section name="SFTP"> |
| |
| <p> |
| Provides access to the files on an SFTP server (that is, an SSH |
| or SCP server). |
| </p> |
| |
| <p> |
| <b>URI Format</b> |
| </p> |
| |
| <p> |
| <code>sftp://[ |
| <i>username</i>[: |
| <i>password</i>]@] |
| <i>hostname</i>[: |
| <i>port</i>][ |
| <i>absolute-path</i>] |
| </code> |
| </p> |
| |
| <p> |
| <b>Examples</b> |
| </p> |
| <ul> |
| <li> |
| <code>sftp://myusername:mypassword@somehost/pub/downloads/somefile.tgz</code> |
| </li> |
| </ul> |
| |
| </section> |
| |
| <section name="CIFS"> |
| |
| <p> |
| Provides access to the files on a CIFS server, such as |
| a Samba server, or a Windows share. |
| </p> |
| <p> |
| <b>URI Format</b> |
| </p> |
| |
| <p> |
| <code>smb://[ |
| <i>username</i>[: |
| <i>password</i>]@] |
| <i>hostname</i>[: |
| <i>port</i>][ |
| <i>absolute-path</i>] |
| </code> |
| </p> |
| |
| <p> |
| <b>Examples</b> |
| </p> |
| |
| <ul> |
| <li> |
| <code>smb://somehost/home</code> |
| </li> |
| </ul> |
| |
| </section> |
| |
| <section name="Temporary Files"> |
| |
| <p> |
| Provides access to a temporary file system, or scratchpad, |
| that is deleted when Commons VFS shuts down. The temporary file |
| system is backed by a local file system. |
| </p> |
| |
| <p> |
| <b>URI Format</b> |
| </p> |
| |
| <p> |
| <code>tmp://[ |
| <i>absolute-path</i>] |
| </code> |
| </p> |
| |
| <p> |
| <b>Examples</b> |
| </p> |
| |
| <ul> |
| <li> |
| <code>tmp://dir/somefile.txt</code> |
| </li> |
| </ul> |
| </section> |
| |
| </body> |
| </document> |