You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by im...@apache.org on 2005/05/18 20:29:10 UTC
svn commit: r170789 - in /jakarta/commons/sandbox/vfs/trunk/xdocs:
download.xml filesystems.xml
Author: imario
Date: Wed May 18 11:29:09 2005
New Revision: 170789
URL: http://svn.apache.org/viewcvs?rev=170789&view=rev
Log:
added tar, tbz2, tgz and res documentation
updated dependency ist
Modified:
jakarta/commons/sandbox/vfs/trunk/xdocs/download.xml
jakarta/commons/sandbox/vfs/trunk/xdocs/filesystems.xml
Modified: jakarta/commons/sandbox/vfs/trunk/xdocs/download.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/vfs/trunk/xdocs/download.xml?rev=170789&r1=170788&r2=170789&view=diff
==============================================================================
--- jakarta/commons/sandbox/vfs/trunk/xdocs/download.xml (original)
+++ jakarta/commons/sandbox/vfs/trunk/xdocs/download.xml Wed May 18 11:29:09 2005
@@ -80,6 +80,14 @@
</td>
<td>SFTP</td>
</tr>
+ <tr>
+ <td>
+ <a href="http://jakarta.apache.org/commons/sandbox/compress/">Commons Compress</a> Nightly build 20040530<br />
+ There are no other nigtlies than the one I created for maven, so please download it from the link below until this changes:<br/>
+ <a href="http://www.ibiblio.org/maven/commons-compress/jars/commons-compress-20040530.jar">http://www.ibiblio.org/maven/commons-compress/jars/commons-compress-20040530.jar</a>
+ </td>
+ <td>tar, bz2</td>
+ </tr>
</table>
</section>
<section name="Building Commons VFS">
Modified: jakarta/commons/sandbox/vfs/trunk/xdocs/filesystems.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/vfs/trunk/xdocs/filesystems.xml?rev=170789&r1=170788&r2=170789&view=diff
==============================================================================
--- jakarta/commons/sandbox/vfs/trunk/xdocs/filesystems.xml (original)
+++ jakarta/commons/sandbox/vfs/trunk/xdocs/filesystems.xml Wed May 18 11:29:09 2005
@@ -32,11 +32,14 @@
<a href="#WebDAV">WebDAV</a>
</li>
<li>
- <a href="#Zip and Jar">Zip and Jar</a>
+ <a href="#Zip, Jar and Tar">Zip, Jar and Tar (uncompressed, tgz or tbz2)</a>
</li>
<li>
<a href="#gzip and bzip2">gzip and bzip2</a>
</li>
+ <li>
+ <a href="#res">res</a>
+ </li>
</ul>
</section>
@@ -107,9 +110,9 @@
</ul>
</section>
- <section name="Zip and Jar">
+ <section name="Zip, Jar and Tar">
- <p>Provides read-only access to the contents of Zip and Jar files.</p>
+ <p>Provides read-only access to the contents of Zip, Jar and Tar files.</p>
<p>
<b>URI Format</b>
@@ -117,23 +120,42 @@
<p>
<code>zip://
- <i>zip-file-uri</i>[!
+ <i>arch-file-uri</i>[!
<i>absolute-path</i>]
</code>
</p>
<p>
<code>jar://
- <i>zip-file-uri</i>[!
+ <i>arch-file-uri</i>[!
+ <i>absolute-path</i>]
+ </code>
+ </p>
+ <p>
+ <code>tar://
+ <i>arch-file-uri</i>[!
+ <i>absolute-path</i>]
+ </code>
+ </p>
+ <p>
+ <code>tgz://
+ <i>arch-file-uri</i>[!
+ <i>absolute-path</i>]
+ </code>
+ </p>
+ <p>
+ <code>tbz2://
+ <i>arch-file-uri</i>[!
<i>absolute-path</i>]
</code>
</p>
<p>
Where
- <code>zip-file-uri</code> refers to a file of any
+ <code>arch-file-uri</code> refers to a file of any
supported type, including other zip files. Note: if you would like
to use the ! as normal character it must be escaped
- using <code>%21</code>.
+ using <code>%21</code>.<br />
+ <code>tgz</code> and <code>tbz2</code> are convenience for <code>tar:gz</code> and <code>tar:bz2</code>.
</p>
<p>
@@ -152,6 +174,12 @@
<li>
<code>jar:zip:outer.zip!/nested.jar!/some%21dir</code>
</li>
+ <li>
+ <code>tar:gz:http://anyhost/dir/mytar.tar.gz!/mytar.tar!/path/in/tar/README.txt</code>
+ </li>
+ <li>
+ <code>tgz:file://anyhost/dir/mytar.tgz!/somepath/somefile</code>
+ </li>
</ul>
</section>
@@ -380,6 +408,36 @@
<ul>
<li>
<code>tmp://dir/somefile.txt</code>
+ </li>
+ </ul>
+ </section>
+
+ <section name="res">
+
+ <p>
+ This is not really a filesystem, it just tries to lookup a resource using javas <code>ClassLoader.getResource()</code>
+ and creates a VFS url for further processing.
+ </p>
+
+ <p>
+ <b>RES Format</b>
+ </p>
+
+ <p>
+ <code>res://[
+ <i>path</i>]
+ </code>
+ </p>
+
+ <p>
+ <b>Examples</b>
+ </p>
+
+ <ul>
+ <li>
+ <code>res:path/in/classpath/image.png</code><br/>
+ might result in
+ <code>jar:file://my/path/to/images.jar!/path/in/classpath/image.png</code><br/>
</li>
</ul>
</section>
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org