jicarilla-sandbox/platform/components/http/api/src/java/org/jicarilla/io Filesystem.java,1.2,1.3

Update of /cvsroot/jicarilla/jicarilla-sandbox/platform/components/http/api/src/java/org/jicarilla/io
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv20979/platform/components/http/api/src/java/org/jicarilla/io

Modified Files:
	Filesystem.java 
Log Message:
seperate plumbing material from the basic HTTP logic, and work on solidifying the I/O code.

Index: Filesystem.java
===================================================================
RCS file: /cvsroot/jicarilla/jicarilla-sandbox/platform/components/http/api/src/java/org/jicarilla/io/Filesystem.java,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -d -r1.2 -r1.3
--- Filesystem.java	4 Jan 2004 16:10:17 -0000	1.2
+++ Filesystem.java	31 Mar 2004 12:10:58 -0000	1.3
@@ -36,6 +36,25 @@
  */
 public interface Filesystem
 {
-    ReadableByteChannel getFile( String relativePath ) throws FileNotFoundException;
+    /**
+     * Retrieve a file from the filesystem for reading.
+     * 
+     * @param relativePath the path to the file relative to the filesystem
+     *    root.
+     * @return a channel which points to the contents of the file.
+     * @throws FileNotFoundException if the specified file cannot be found,
+     *    the provided path points to a directory or to a file from which
+     *    cannot be read.
+     * @throws SecurityException if there is a security manager present and it
+     *    denies access to the specified file.
+     */ 
+    ReadableByteChannel getFile( String relativePath )
+            throws FileNotFoundException;
+    /**
+     * Return a file to the filesystem after reading.
+     * 
+     * @param channel the channel that was retrieved through
+     *     {@link #getFile(String)}.
+     */ 
     void returnFile( ReadableByteChannel channel );
 }



-------------------------------------------------------
This SF.Net email is sponsored by: IBM Linux Tutorials
Free Linux tutorial presented by Daniel Robbins, President and CEO of
GenToo technologies. Learn everything from fundamentals to system
administration.http://ads.osdn.com/?ad_id=1470&alloc_id=3638&op=click