commons vfs(文件系统工具)

commons-vfs(文件系统工具)
文件读取封装
***

按习惯，一起看一下几个实例：
读取文件
`

byte[] res = VFSUtils.readFileToByteArray("d:/test/test1.txt");
byte[] res = VFSUtils.readFileToByteArray("tar:gz:http://anyhost/dir/mytar.tar.gz!/mytar.tar!/path/in/tar/README.txt");
byte[] res = VFSUtils.readFileToByteArray("jar:../lib/classes.jar!/META-INF/manifest.mf");
byte[] res = VFSUtils.readFileToByteArray("zip:http://somehost/downloads/somefile.zip");
String res = VFSUtils.readFileToString("gz:/my/gz/file.gz");
String res = VFSUtils.readFileToString("http://somehost:8080/downloads/somefile.jar");
String res = VFSUtils.readFileToString("https://myusername@somehost/index.html");
String res = VFSUtils.readFileToString("https://myusername@somehost/index.html","UTF-8");
String res = VFSUtils.readFileToString("ftp://myusername:mypassword@somehost/pub/downloads/somefile.tgz");
List<String> res = VFSUtils.readLines("ftps://myusername:mypassword@somehost/pub/downloads/somefile.tgz");
List<String> res = VFSUtils.readLines("mime:file:///your/path/mail/anymail.mime!/filename.pdf");
List<String> res = VFSUtils.readLines("tar:gz:http://anyhost/dir/mytar.tar.gz!/mytar.tar!/path/in/tar/README.txt","UTF-8");
write,
copy.
del

makedir
略
...
`

`
惯例：官网：http://commons.apache.org/vfs/
api:http://www.oschina.net/uploads/doc/commons-vfs-1.0/index.html
`

# 适用场景
***
个人推荐，如果仅仅处理本地文件用 FileUtils
如果涉及ftp,zip等文件读取，可考虑选用该类实现

这个不用多说 VFS(Visual File System)虚拟文件系统。
其官网封装目的，即，将各种文件形式，以统一的方式进行操作。

该jar包已经有很多年历史，尚未发现有多大的问题，vfs中，原来存在ftp有时候不能正常关闭的情况，commons-vfs2 出了以后，该问题已经得到解决

# 具体实现可参看：

import java.io.Closeable;
import java.io.File;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.util.List;

import org.apache.commons.io.IOUtils;
import org.apache.commons.lang.StringUtils;
import org.apache.commons.vfs2.FileObject;
import org.apache.commons.vfs2.FileSystemException;
import org.apache.commons.vfs2.FileSystemManager;
import org.apache.commons.vfs2.FileType;
import org.apache.commons.vfs2.VFS;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

/**
 * <虚拟文件处理类,基于vfs进行二次封装，针对常用的，文件写入，文件读取，文件拷贝进行封装>
 * 
 * see http://commons.apache.org/vfs/filesystems.html
 * 
 * Local Files
   URI Format
   [file://] absolute-path
   Where absolute-path is a valid absolute file name for the local platform. UNC names are supported under Windows.
   Examples
   file:///home/someuser/somedir
   file:///C:/Documents and Settings
   file:/somehost/someshare/afile.txt
   /home/someuser/somedir
   c:\program files\some dir
   c:/program files/some dir
 * 
 * Zip, Jar and Tar
   Provides read-only access to the contents of Zip, Jar and Tar files.
   URI Format
   zip:// arch-file-uri[! absolute-path]
   jar:// arch-file-uri[! absolute-path]
   tar:// arch-file-uri[! absolute-path]
   tgz:// arch-file-uri[! absolute-path]
   tbz2:// arch-file-uri[! absolute-path]
   Where arch-file-uri 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 %21.
   tgz and tbz2 are convenience for tar:gz and tar:bz2.
   Examples
   jar:../lib/classes.jar!/META-INF/manifest.mf
   zip:http://somehost/downloads/somefile.zip
   jar:zip:outer.zip!/nested.jar!/somedir
   jar:zip:outer.zip!/nested.jar!/some%21dir
   tar:gz:http://anyhost/dir/mytar.tar.gz!/mytar.tar!/path/in/tar/README.txt
   tgz:file://anyhost/dir/mytar.tgz!/somepath/somefile
 * 
 * gzip and bzip2
   Provides read-only access to the contents of gzip and bzip2 files.
   URI Format
   gz:// compressed-file-uri
   bz2:// compressed-file-uri
   Where compressed-file-uri 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.
   Examples
   gz:/my/gz/file.gz
 * 
 * HTTP and HTTPS
   Provides access to files on an HTTP server.
   URI Format
   http://[ username[: password]@] hostname[: port][ absolute-path]
   https://[ username[: password]@] hostname[: port][ absolute-path]
   File System Options
   proxyHost The proxy host to connect through.
   proxyPort The proxy port to use.
   cookies An array of Cookies to add to the request.
   maxConnectionsPerHost The maximum number of connections allowed to a specific host and port. The default is 5.
   maxTotalConnections The maximum number of connections allowed to all hosts. The default is 50.
   Examples
   http://somehost:8080/downloads/somefile.jar
   http://myusername@somehost/index.html
 * 
 * WebDAV
   Provides access to the files on an FTP server.
   URI Format
   ftp://[ username[: password]@] hostname[: port][ absolute-path]
   Examples
   ftp://myusername:mypassword@somehost/pub/downloads/somefile.tgz
 * 
 * FTPS
   Provides access to the files on an FTP server over SSL.
   URI Format
   ftps://[ username[: password]@] hostname[: port][ absolute-path]
   Examples
   ftps://myusername:mypassword@somehost/pub/downloads/somefile.tgz
 * 
 * SFTP
   Provides access to the files on an SFTP server (that is, an SSH or SCP server).
   URI Format
   sftp://[ username[: password]@] hostname[: port][ absolute-path]
   Examples
   sftp://myusername:mypassword@somehost/pub/downloads/somefile.tgz
 * 
 * CIFS
   Provides access to the files on a CIFS server, such as a Samba server, or a Windows share.
   URI Format
   smb://[ username[: password]@] hostname[: port][ absolute-path]
   Examples
   smb://somehost/home
 * 
 * Temporary Files
   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.
   URI Format
   tmp://[ absolute-path]
   Examples
   tmp://dir/somefile.txt
 * 
 * res
   This is not really a filesystem, it just tries to lookup a resource using javas ClassLoader.getResource() and creates a VFS url for further processing.
   URI Format
   res://[ path]
   Examples
   res:path/in/classpath/image.png
   might result in jar:file://my/path/to/images.jar!/path/in/classpath/image.png
 * 
 * ram
   A filesystem which stores all the data in memory. You can configure the max size and a predicate (FileSelector). The predicate will be used to check if it is allowed to add a given file.
   URI Format
   ram://[ path]
   Examples
   ram:///any/path/to/file.txt
 * 
 * mime
   This filesystem can read mails and its attachements like archives.
   If a part in the parsed mail has no name, a dummy name will be generated. The dummy name is: _body_part_X where X will be replaced by the part number.
   URI Format
   mime:// mime-file-uri[! absolute-path]
   Examples
   mime:file:///your/path/mail/anymail.mime!/
   mime:file:///your/path/mail/anymail.mime!/filename.pdf
   mime:file:///your/path/mail/anymail.mime!/_body_part_0
 * 
 * @author  PengQingyang
 * @version  [版本号, 2012-10-4]
 * @see  [相关类/方法]
 * @since  [产品/模块版本]
 */
`

`
public class VFSUtils
{
    private static Logger logger = LoggerFactory.getLogger(VFSUtils.class);

    private static FileSystemManager fsManager = null;

    static
    {
        try
        {
            fsManager = VFS.getManager();
        }
        catch (FileSystemException e)
        {
            logger.error("init vfs fileSystemManager fail.", e);
        }
    }

    /**
      *<读取文件，将其中内容以byte进行输出>
      *<功能详细描述>
      *
      * @param filePath
      * @return
      * @throws IOException [参数说明]
      * 
      * @return byte[] [返回类型说明]
      * @exception throws [异常类型] [异常说明]
      * @see [类、类#方法、类#成员]
     */
    public static byte[] readFileToByteArray(String filePath)
            throws IOException
    {
        if (StringUtils.isEmpty(filePath))
        {
            throw new IOException("File '" + filePath + "' is empty.");
        }
        FileObject fileObj = null;
        InputStream in = null;
        try
        {
            fileObj = fsManager.resolveFile(filePath);
            if (fileObj.exists())
            {
                System.out.println(fileObj.getType().getName());
                if (FileType.FOLDER.equals(fileObj.getType()))
                {
                    throw new IOException("File '" + filePath
                            + "' exists but is a directory");
                }
                else
                {
                    in = fileObj.getContent().getInputStream();
                    return IOUtils.toByteArray(in);
                }
            }
            else
            {
                throw new FileNotFoundException("File '" + filePath
                        + "' does not exist");
            }
        }
        catch (FileSystemException e)
        {
            throw new IOException("File '" + filePath + "' resolveFile fail.");
        }
        finally
        {
            IOUtils.closeQuietly(in);
            if (fileObj != null)
            {
                fileObj.close();
            }
        }
    }

    /**
      *<读取文件内容>
      *<功能详细描述>
      *
      * @param filePath
      * @param encoding
      * @return
      * @throws IOException [参数说明]
      * 
      * @return String [返回类型说明]
      * @exception throws [异常类型] [异常说明]
      * @see [类、类#方法、类#成员]
     */
    public static String readFileToString(String filePath, String encoding)
            throws IOException
    {
        if (StringUtils.isEmpty(filePath))
        {
            throw new IOException("File '" + filePath + "' is empty.");
        }
        FileObject fileObj = null;
        InputStream in = null;
        try
        {
            fileObj = fsManager.resolveFile(filePath);
            if (fileObj.exists())
            {
                if (FileType.FOLDER.equals(fileObj.getType()))
                {
                    throw new IOException("File '" + filePath
                            + "' exists but is a directory");
                }
                else
                {
                    in = fileObj.getContent().getInputStream();
                    return IOUtils.toString(in, encoding);
                }
            }
            else
            {
                throw new FileNotFoundException("File '" + filePath
                        + "' does not exist");
            }
        }
        catch (FileSystemException e)
        {
            throw new IOException("File '" + filePath + "' resolveFile fail.");
        }
        finally
        {
            IOUtils.closeQuietly(in);
            if (fileObj != null)
            {
                fileObj.close();
            }
        }
    }

    /**
      * <读取文件内容>
      * <功能详细描述>
      * @param filePath
      * @return
      * @throws IOException [参数说明]
      * 
      * @return String [返回类型说明]
      * @exception throws [异常类型] [异常说明]
      * @see [类、类#方法、类#成员]
     */
    public static String readFileToString(String filePath) throws IOException
    {
        return readFileToString(filePath, null);
    }

    /**
      *<读取文件内容>
      *<功能详细描述>
      * @param filePath
      * @param encoding
      * @return
      * @throws IOException [参数说明]
      * 
      * @return List<String> [返回类型说明]
      * @exception throws [异常类型] [异常说明]
      * @see [类、类#方法、类#成员]
     */
    public static List<String> readLines(String filePath, String encoding)
            throws IOException
    {
        if (StringUtils.isEmpty(filePath))
        {
            throw new IOException("File '" + filePath + "' is empty.");
        }
        FileObject fileObj = null;
        InputStream in = null;
        try
        {
            fileObj = fsManager.resolveFile(filePath);
            if (fileObj.exists())
            {
                if (FileType.FOLDER.equals(fileObj.getType()))
                {
                    throw new IOException("File '" + filePath
                            + "' exists but is a directory");
                }
                else
                {
                    in = fileObj.getContent().getInputStream();
                    return IOUtils.readLines(in, encoding);
                }
            }
            else
            {
                throw new FileNotFoundException("File '" + filePath
                        + "' does not exist");
            }
        }
        catch (FileSystemException e)
        {
            throw new IOException("File '" + filePath + "' resolveFile fail.");
        }
        finally
        {
            IOUtils.closeQuietly(in);
            if (fileObj != null)
            {
                fileObj.close();
            }
        }
    }

    /**
      *<读取文件内容>
      *<功能详细描述>
      * @param filePath
      * @return
      * @throws IOException [参数说明]
      * 
      * @return List<String> [返回类型说明]
      * @exception throws [异常类型] [异常说明]
      * @see [类、类#方法、类#成员]
     */
    public static List<String> readLines(String filePath) throws IOException
    {
        return readLines(filePath, null);
    }

    /**
      *<将内容写入文件中>
      *<功能详细描述>
      * @param filePath
      * @param data
      * @param encoding
      * @throws IOException [参数说明]
      * 
      * @return void [返回类型说明]
      * @exception throws [异常类型] [异常说明]
      * @see [类、类#方法、类#成员]
     */
    public static void writeStringToFile(String filePath, String data,
            String encoding) throws IOException
    {
        if (StringUtils.isEmpty(filePath))
        {
            throw new IOException("File '" + filePath + "' is empty.");
        }
        FileObject fileObj = null;
        OutputStream out = null;

        try
        {
            fileObj = fsManager.resolveFile(filePath);

            if (!fileObj.exists())
            {
                fileObj.createFile();
            }
            else
            {
                if (FileType.FOLDER.equals(fileObj.getType()))
                {
                    throw new IOException("Write fail. File '" + filePath
                            + "' exists but is a directory");
                }
            }

            if (!fileObj.isWriteable())
            {
                throw new IOException("Write fail. File '" + filePath
                        + "' exists but isWriteable is false.");
            }

            out = fileObj.getContent().getOutputStream();
            IOUtils.write(data, out, encoding);
        }
        catch (FileSystemException e)
        {
            throw new IOException("File '" + filePath + "' resolveFile fail.");
        }
        finally
        {
            IOUtils.closeQuietly(out);
            if (fileObj != null)
            {
                fileObj.close();
            }
        }

    }

    /**
     *<将内容写入文件中>
     *<功能详细描述>
     * @param filePath
     * @param data
     * @param encoding
     * @throws IOException [参数说明]
     * 
     * @return void [返回类型说明]
     * @exception throws [异常类型] [异常说明]
     * @see [类、类#方法、类#成员]
    */
   public static void writeStringToFile(String filePath, String data) throws IOException{
       writeStringToFile(filePath, data, null);
   }

    public static void write(String filePath, CharSequence data, String encoding)
            throws IOException
    {

    }

    public static void main(String[] args) throws Exception
    {
        //write
        //FileUtils.writeStringToFile(file, data, encoding);
        //FileUtils.writeStringToFile(file, data);

        //FileUtils.write(file, data);
        //FileUtils.write(file, data, encoding);
        //FileUtils.writeByteArrayToFile(file, data);
        //FileUtils.writeLines(file, lines);
        //FileUtils.writeLines(file, lines, lineEnding);
        //FileUtils.writeLines(file, encoding, lines);
        //FileUtils.writeLines(file, encoding, lines, lineEnding);
        //


        //read
        //FileUtils.readFileToByteArray(file);
        //FileUtils.readFileToString(file);
        //FileUtils.readFileToString(file, encoding);
        //FileUtils.readLines(file);
        //FileUtils.readLines(file, encoding);

        //        System.out.println(fsManager.resolveFile("D:/ide").isReadable());
        //        System.out.println(fsManager.resolveFile("D:/ide").isWriteable());
        //        //检查是否有人读/写这个文件
        //        System.out.println(fsManager.resolveFile("D:/ide").isContentOpen());
        //        System.out.println(fsManager.resolveFile("D:/ide")
        //                .getContent()
        //                .isOpen());

        /// fsManager.resolveFile("D:/test/createfilefolder1/file1.txt").createFile();

        //System.out.println(fsManager.resolveFile("D:/ide").getType());

        //FileUtils.writeStringToFile(file, data, encoding)

        //        try
        //        {
        //            VFSUtils.readFileToByteArray("D:/ide");
        //        }
        //        catch (Exception e)
        //        {
        //            e.printStackTrace();
        //        }

        //        System.out.println(VFSUtils.readFileToString("D:/ide/CreatePluginsConfig.java",
        //                "utf-8"));
        //        
        //        System.out.println(VFSUtils.readFileToString("D:/ide/springsource/spring-roo-1.2.1.RELEASE/readme.txt",
        //                null));

        FileObject tt = fsManager.resolveFile("D:/test/createfilefolder1/file1.txt");
        tt.createFile();
        System.out.println(tt instanceof Closeable);

    }
}
`

其中wirte,copy,del..等忙过了再重新封装，以前封装过一次，现在只能重做一次了。

主要了解几个对象即可：
`
FileObject
FileType
FileContent
FileSelector
`