You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by ad...@apache.org on 2002/10/28 03:05:06 UTC
cvs commit: jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/impl StandardFileSystemManager.java DefaultFileSystemManager.java
adammurdoch 2002/10/27 18:05:06
Modified: vfs/src/java/org/apache/commons/vfs FileSelector.java
FileObject.java
vfs/src/java/org/apache/commons/vfs/provider
VfsComponent.java
AbstractOriginatingFileProvider.java
AbstractLayeredFileProvider.java
AbstractFileSystemProvider.java
vfs/src/java/org/apache/commons/vfs/provider/zip
ZipFileSystemProvider.java
vfs/src/java/org/apache/commons/vfs/provider/jar
JarFileSystemProvider.java
vfs/src/java/org/apache/commons/vfs/impl
StandardFileSystemManager.java
DefaultFileSystemManager.java
Added: vfs/src/java/org/apache/commons/vfs/provider/temp
package.html
Log:
Javadocs.
Revision Changes Path
1.4 +2 -0 jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/FileSelector.java
Index: FileSelector.java
===================================================================
RCS file: /home/cvs/jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/FileSelector.java,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- FileSelector.java 23 Oct 2002 11:59:39 -0000 1.3
+++ FileSelector.java 28 Oct 2002 02:05:06 -0000 1.4
@@ -58,6 +58,8 @@
/**
* This interface is used to select files when traversing a file hierarchy.
*
+ * @see Selectors
+ *
* @author <a href="mailto:adammurdoch@apache.org">Adam Murdoch</a>
* @version $Revision$ $Date$
*/
1.11 +2 -0 jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/FileObject.java
Index: FileObject.java
===================================================================
RCS file: /home/cvs/jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/FileObject.java,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- FileObject.java 27 Oct 2002 08:18:46 -0000 1.10
+++ FileObject.java 28 Oct 2002 02:05:06 -0000 1.11
@@ -257,6 +257,8 @@
* @return A list of matching {@link FileObject} files. The files are
* returned in depthwise order (that is, a child appears in the
* list before its parent).
+ *
+ * @todo Use the same return type for getChildren() and findFiles().
*/
List findFiles( FileSelector selector ) throws FileSystemException;
1.4 +2 -1 jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/provider/VfsComponent.java
Index: VfsComponent.java
===================================================================
RCS file: /home/cvs/jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/provider/VfsComponent.java,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- VfsComponent.java 23 Oct 2002 11:59:40 -0000 1.3
+++ VfsComponent.java 28 Oct 2002 02:05:06 -0000 1.4
@@ -65,6 +65,7 @@
* <li>{@link FileProvider}
* <li>{@link org.apache.commons.vfs.FileSystem}
* <li>{@link FileReplicator}
+ * <li>{@link TemporaryFileStore}
* </ul>
*
* @author <a href="mailto:adammurdoch@apache.org">Adam Murdoch</a>
1.6 +2 -2 jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/provider/AbstractOriginatingFileProvider.java
Index: AbstractOriginatingFileProvider.java
===================================================================
RCS file: /home/cvs/jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/provider/AbstractOriginatingFileProvider.java,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- AbstractOriginatingFileProvider.java 25 Oct 2002 11:07:39 -0000 1.5
+++ AbstractOriginatingFileProvider.java 28 Oct 2002 02:05:06 -0000 1.6
@@ -126,7 +126,7 @@
throws FileSystemException;
/**
- * Creates the filesystem.
+ * Creates the filesystem. The file system may implement {@link VfsComponent}.
*/
protected abstract FileSystem doCreateFileSystem( final ParsedUri uri )
throws FileSystemException;
1.3 +3 -2 jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/provider/AbstractLayeredFileProvider.java
Index: AbstractLayeredFileProvider.java
===================================================================
RCS file: /home/cvs/jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/provider/AbstractLayeredFileProvider.java,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- AbstractLayeredFileProvider.java 23 Oct 2002 11:59:40 -0000 1.2
+++ AbstractLayeredFileProvider.java 28 Oct 2002 02:05:06 -0000 1.3
@@ -114,7 +114,8 @@
/**
* Creates a layered file system. This method is called if the file system
- * is not cached.
+ * is not cached. The file system may implement {@link VfsComponent}.
+ *
* @param scheme The URI scheme.
* @param file The file to create the file system on top of.
* @return The file system.
1.11 +3 -2 jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/provider/AbstractFileSystemProvider.java
Index: AbstractFileSystemProvider.java
===================================================================
RCS file: /home/cvs/jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/provider/AbstractFileSystemProvider.java,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- AbstractFileSystemProvider.java 25 Oct 2002 11:07:39 -0000 1.10
+++ AbstractFileSystemProvider.java 28 Oct 2002 02:05:06 -0000 1.11
@@ -98,7 +98,7 @@
}
/**
- * Creates a layered file system.
+ * Creates a layered file system. This method throws a 'not supported' exception.
*/
public FileObject createFileSystem( final String scheme, final FileObject file )
throws FileSystemException
@@ -108,7 +108,8 @@
}
/**
- * Adds a file system to those cached by this provider.
+ * Adds a file system to those cached by this provider. The file system
+ * may implement {@link VfsComponent}.
*/
protected void addFileSystem( final Object key, final FileSystem fs )
throws FileSystemException
1.11 +1 -2 jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/provider/zip/ZipFileSystemProvider.java
Index: ZipFileSystemProvider.java
===================================================================
RCS file: /home/cvs/jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/provider/zip/ZipFileSystemProvider.java,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- ZipFileSystemProvider.java 23 Oct 2002 11:59:42 -0000 1.10
+++ ZipFileSystemProvider.java 28 Oct 2002 02:05:06 -0000 1.11
@@ -64,8 +64,7 @@
import org.apache.commons.vfs.provider.ParsedLayeredUri;
/**
- * A file system provider for Zip/Jar files. Provides read-only file
- * systems, for local Zip files only.
+ * A file system provider for Zip files. Provides read-only file systems.
*
* @author <a href="mailto:adammurdoch@apache.org">Adam Murdoch</a>
* @version $Revision$ $Date$
1.1 jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/provider/temp/package.html
Index: package.html
===================================================================
<body>
<p>The Temporary Filespace Provider.</p>
</body>
1.5 +2 -3 jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/provider/jar/JarFileSystemProvider.java
Index: JarFileSystemProvider.java
===================================================================
RCS file: /home/cvs/jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/provider/jar/JarFileSystemProvider.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- JarFileSystemProvider.java 23 Oct 2002 11:59:41 -0000 1.4
+++ JarFileSystemProvider.java 28 Oct 2002 02:05:06 -0000 1.5
@@ -63,8 +63,7 @@
/**
* A file system provider for Jar files. Provides read-only file
- * systems, for local Jar files only.
- * This provides access to Jar specific features like Signing and
+ * systems. This provides access to Jar specific features like Signing and
* Manifest Attributes.
*
* @author <a href="mailto:brian@mmmanager.org">Brian Olsen</a>
1.3 +10 -2 jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/impl/StandardFileSystemManager.java
Index: StandardFileSystemManager.java
===================================================================
RCS file: /home/cvs/jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/impl/StandardFileSystemManager.java,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- StandardFileSystemManager.java 25 Oct 2002 11:07:39 -0000 1.2
+++ StandardFileSystemManager.java 28 Oct 2002 02:05:06 -0000 1.3
@@ -62,7 +62,15 @@
/**
* A {@link org.apache.commons.vfs.FileSystemManager} that configures itself
- * to use the standard providers and other components.
+ * to use the standard providers and other components. To use this
+ * manager:
+ *
+ * <ul>
+ * <li>Create an instance of this class.
+ * <li>Set the logger using {@link #setLogger}.
+ * <li>Configure the manager using {@link #init}.
+ * <li>Add additional providers, or replace the default services.
+ * </ul>
*
* @author <a href="mailto:adammurdoch@apache.org">Adam Murdoch</a>
* @version $Revision$ $Date$
1.14 +1 -0 jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/impl/DefaultFileSystemManager.java
Index: DefaultFileSystemManager.java
===================================================================
RCS file: /home/cvs/jakarta-commons-sandbox/vfs/src/java/org/apache/commons/vfs/impl/DefaultFileSystemManager.java,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- DefaultFileSystemManager.java 25 Oct 2002 11:05:08 -0000 1.13
+++ DefaultFileSystemManager.java 28 Oct 2002 02:05:06 -0000 1.14
@@ -84,6 +84,7 @@
* <li>Add one or more file providers using {@link #addProvider}.
* <li>Set the default provider using {@link #setDefaultProvider} (optional).
* <li>Set the file replicator using {@link #setReplicator} (optional).
+ * <li>Set the temporary file store using {@link #setTemporaryFileStore} (optional).
* <li>Set the base file using {@link #setBaseFile} (optional).
* </ul>
*
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>