com.hynnet.util

类 FileOperation

java.lang.Object

com.hynnet.util.FileOperation

public class FileOperation
extends java.lang.Object

封装文件操作的类。 Title: file operation
Description:
Copyright: Copyright (c) 2000
Company: chan

版本:

Version 1.0

作者:

sim
, hyn

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	ATTACHE_FILE_EXT 附件文件后缀。"
static java.lang.String	EXE_FILE_EXT 可执行文件后缀。"
static java.lang.String	FORBID_FILE_EXT 禁止的文件后缀。"
static java.lang.String	IMAGE_FILE_EXT 图片文件后缀。"

构造器概要

构造器

构造器和说明
FileOperation()

方法概要

方法

限定符和类型	方法和说明
static boolean	checkExtFile(java.lang.String strExtList, java.lang.String strFileName) 检查文件后缀名是否符合要求。
static int	cleanEmpty(java.io.File objFile) 删除指定路径下的空文件和空目录，如果指定的目录或文件为空，删除指定的目录或文件。
static int	cleanEmpty(java.lang.String strPath) 删除指定路径下的空文件和空目录，如果指定的目录或文件为空，删除指定的目录或文件。
boolean	copyFile(java.lang.String strSource, java.lang.String strDest) 复制文件。
boolean	copyFile(java.lang.String strSource, java.lang.String strDest, boolean bSubOnly, boolean bDelSrc) 复制文件或目录。
boolean	copyFile(java.lang.String strSource, java.lang.String strDest, boolean bSubOnly, boolean bDelSrc, boolean bAutoRename) 复制文件或目录。
boolean	createDir(java.lang.String strDirectory) 创建路径。
boolean	createDir(java.lang.String strDirectory, long lLastModified) 创建路径。
boolean	delete(java.lang.String strFileName) 删除指定文件或目录。
java.lang.String[]	getDIR() 获取搜索结果中的目录名。
java.lang.String	getDIR(int nIndex) 获取搜索结果中的指定目录。
java.lang.String	getErrorMessage() 取错误信息。
static java.lang.String	getFileExtFromStr(java.lang.String strPath) 获取字符串中的文件扩展名。
java.lang.String[]	getFileName() 获取搜索结果中的文件名。
java.lang.String	getFileName(int nIndex) 获取搜索结果中的指定文件名。
static java.lang.String	getFileNameFromStr(java.lang.String strPath) 取得字符串中的文件名。
static java.lang.String	getFileNameWithNoExtFromStr(java.lang.String strPath) 取得字符串中的文件名。
java.lang.String[]	getFullName() 获取搜索结果的全路径名称。
java.lang.String	getFullName(int nIndex) 获取搜索结果的指定全路径名称。
static java.io.FileFilter	getIncludeExcludeFileFilter(java.lang.String[] arrayInclude, java.lang.String[] arrayExclude) 获取通过正规表达式匹配文件全路径包含文件和排除文件的文件过滤器。
static java.io.FileFilter	getIncludeExcludeFileFilter(StringList lstInclude, StringList lstExclude) 获取通过正规表达式匹配文件全路径包含文件和排除文件的文件过滤器。
static java.io.FileFilter	getIncludeExcludeFileFilter(java.lang.String strInclude, java.lang.String strExclude) 获取通过正规表达式匹配文件全路径包含文件和排除文件的文件过滤器。
java.lang.String	getParent(java.lang.String strName) 获得指定文件的父目录路径。
java.lang.String	getPath(java.lang.String strName) 获取路径的目录部分。
static java.lang.String	getValidFileName(java.lang.String strFileName) 修正指定的文件名为合法的文件名。
static boolean	isAttacheFile(java.lang.String strFileName) 是否为合法的附件文件。
boolean	isDirecotry(java.lang.String strName) 判断路径是否为目录。
static boolean	isExeFile(java.lang.String strFileName) 是否为可执行文件。
boolean	isFile(java.lang.String name)
static boolean	isForbidFile(java.lang.String strFileName) 是否为禁止的文件。
static boolean	isImageFile(java.lang.String strFileName) 是否为图片文件。
java.lang.String[]	listAllFile(java.lang.String strDir) 获取指定目录下的所有子目录和文件。
java.lang.String[]	listAllFile(java.lang.String strDir, boolean bWithSubDir) 获取指定目录下的所有子目录和文件。
java.lang.String[]	listAllFile(java.lang.String strDir, boolean bWithSubDir, boolean bWithFile) 获取指定目录下的所有子目录和文件。
java.lang.String[]	listAllFile(java.lang.String strDir, boolean bWithSubDir, boolean bWithFile, java.io.FileFilter filter) 获取指定目录下的所有子目录和文件。
java.lang.String[]	listAllFile(java.lang.String strDir, boolean bWithSubDir, java.io.FileFilter filter) 获取指定目录下的所有子目录和文件。
java.lang.String[]	listAllFile(java.lang.String strDir, java.io.FileFilter filter) 获取指定目录下的所有子目录和文件。
java.lang.String[]	listFile(java.lang.String strDirName) 列出指定目录的文件和目录。
static void	main(java.lang.String[] arrayArg) 测试及常用工具的函数。
boolean	moveFile(java.lang.String strSource, java.lang.String strDest) 移动文件或目录。
boolean	moveFile(java.lang.String strSource, java.lang.String strDest, boolean bSubOnly) 移动文件或目录。
static byte[]	readFileBinaryData(java.lang.String strFilePath) 读取指定文件的二进制数据。
static java.lang.StringBuffer	readFileData(java.lang.String strFilePath) 获取指定文件数据。
static java.lang.StringBuffer	readFileData(java.lang.String filePath, java.lang.String encoding) 获取指定文件的数据。
boolean	rename(java.lang.String strDestFileName, java.lang.String strSourceName) 重命名。
static int	setTime(java.io.File objFile, long lLastModified) 设置指定文件或目录及子目录的修改时间。
static int	setTime(java.lang.String strPath, long lLastModified) 设置指定文件或目录及子目录的修改时间。
static long	totalSize(java.io.File objFile) 获取指定目录或文件的总大小。
static boolean	unrarFile(java.lang.String strRARFileName, java.lang.String strOutputDir, java.lang.String strPassword) 解压rar文件到指定目录。
static boolean	unzipFile(java.lang.String strZipFileName, java.lang.String strOutputDir) 解压zip文件到指定目录（同时支持解压RAR文件）。
static boolean	writeFile(java.lang.String strFileName, byte[] arrayData) 直接把数据写入文件。
static boolean	writeFile(java.lang.String fileName, java.io.InputStream inputStream) 把输入流的数据写入指定文件。
static boolean	writeFile(java.lang.String fileName, java.lang.String data) 把指定字符串写入文件。
static boolean	zipFiles(java.lang.String strZipFileName, java.lang.String[] arrayFileName) 压缩指定的文件。

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

IMAGE_FILE_EXT

public static final java.lang.String IMAGE_FILE_EXT

图片文件后缀。"jpg;jpeg;png;gif;bmp;ico"

另请参阅:

常量字段值

ATTACHE_FILE_EXT

public static final java.lang.String ATTACHE_FILE_EXT

附件文件后缀。"doc;zip;rar;pdf"

另请参阅:

常量字段值

FORBID_FILE_EXT

public static final java.lang.String FORBID_FILE_EXT

禁止的文件后缀。"jsp;com;bat;cmd"

另请参阅:

常量字段值

EXE_FILE_EXT

public static final java.lang.String EXE_FILE_EXT

可执行文件后缀。"exe;com;bat;cmd"

另请参阅:

常量字段值

构造器详细资料

FileOperation

public FileOperation()

方法详细资料

getErrorMessage

public java.lang.String getErrorMessage()

取错误信息。

返回:

createDir

public boolean createDir(java.lang.String strDirectory)

创建路径。

参数:

strDirectory -

返回:

createDir

public boolean createDir(java.lang.String strDirectory,
                long lLastModified)

创建路径。

参数:

strDirectory -

lLastModified - 目录的最后修改时间。默认为System.currentTimeMillis()的值。

返回:

delete

public boolean delete(java.lang.String strFileName)

删除指定文件或目录。
递归删除所有子目录。

参数:

strFileName - 需要删除的文件或目录全路径名称

返回:

rename

public boolean rename(java.lang.String strDestFileName,
             java.lang.String strSourceName)

重命名。

参数:

strDestFileName - 新的文件名，文件名全路径。

strSourceName - 原始文件名，文件名全路径。

返回:

isDirecotry

public final boolean isDirecotry(java.lang.String strName)

判断路径是否为目录。

参数:

strName -

返回:

getDIR

public final java.lang.String[] getDIR()

获取搜索结果中的目录名。

返回:

getDIR

public final java.lang.String getDIR(int nIndex)

获取搜索结果中的指定目录。

参数:

nIndex -

返回:

getFileName

public final java.lang.String[] getFileName()

获取搜索结果中的文件名。

返回:

getFileName

public final java.lang.String getFileName(int nIndex)

获取搜索结果中的指定文件名。

返回:

getFullName

public final java.lang.String[] getFullName()

获取搜索结果的全路径名称。

返回:

getFullName

public final java.lang.String getFullName(int nIndex)

获取搜索结果的指定全路径名称。

返回:

getPath

public java.lang.String getPath(java.lang.String strName)

获取路径的目录部分。路径分隔符替换为/，并以斜杠结尾。

参数:

strName -

返回:

getParent

public java.lang.String getParent(java.lang.String strName)

获得指定文件的父目录路径。

参数:

strName -

返回:

isFile

public boolean isFile(java.lang.String name)

listFile

public java.lang.String[] listFile(java.lang.String strDirName)

列出指定目录的文件和目录。
输出的数组目录名排在前面，并在名称前加上 [目录]
目录列表可以通过读取 m_lstDir 获取
文件列表可以通过读取 m_lstFile 获取

参数:

strDirName - 需要列文件的目录名称。

返回:

listAllFile

public java.lang.String[] listAllFile(java.lang.String strDir)

获取指定目录下的所有子目录和文件。
递归所有子目录。

参数:

strDir - 需要查找文件的目录。

返回:

结果为目录或文件的绝对路径。

listAllFile

public java.lang.String[] listAllFile(java.lang.String strDir,
                             boolean bWithSubDir)

获取指定目录下的所有子目录和文件。
递归所有子目录，默认包含文件。

参数:

strDir - 需要查找文件的目录。

bWithSubDir - 只有指定 true 时结果才列出子目录。

返回:

结果为目录或文件的绝对路径。

listAllFile

public java.lang.String[] listAllFile(java.lang.String strDir,
                             boolean bWithSubDir,
                             boolean bWithFile)

获取指定目录下的所有子目录和文件。
递归所有子目录。

参数:

strDir - 需要查找文件的目录。

bWithSubDir - 只有指定 true 时结果才列出子目录。

bWithFile - 只有指定 true 时结果才列出文件。

返回:

结果为目录或文件的绝对路径。

listAllFile

public java.lang.String[] listAllFile(java.lang.String strDir,
                             java.io.FileFilter filter)

获取指定目录下的所有子目录和文件。
递归所有子目录，默认包含子目录和文件。

参数:

strDir - 需要查找文件的目录。

filter - 文件名过滤器。

返回:

结果为目录或文件的绝对路径。

listAllFile

public java.lang.String[] listAllFile(java.lang.String strDir,
                             boolean bWithSubDir,
                             java.io.FileFilter filter)

获取指定目录下的所有子目录和文件。
递归所有子目录，默认包括文件。

参数:

strDir - 需要查找文件的目录。

bWithSubDir - 只有指定 true 时结果才列出子目录。

filter - 文件名过滤器。

返回:

结果为目录或文件的绝对路径。

listAllFile

public java.lang.String[] listAllFile(java.lang.String strDir,
                             boolean bWithSubDir,
                             boolean bWithFile,
                             java.io.FileFilter filter)

获取指定目录下的所有子目录和文件。
递归所有子目录。

参数:

strDir - 需要查找文件的目录。

bWithSubDir - 只有指定 true 时结果才列出子目录。

bWithFile - 只有指定 true 时结果才列出文件。

filter - 文件名过滤器。

返回:

结果为目录或文件的绝对路径。

moveFile

public final boolean moveFile(java.lang.String strSource,
               java.lang.String strDest)

移动文件或目录。
把源文件或目录 strSource 移动到 strDest 目录下。

参数:

strSource - 源文件或目录。

strDest - 目的文件。

返回:

moveFile

public final boolean moveFile(java.lang.String strSource,
               java.lang.String strDest,
               boolean bSubOnly)

移动文件或目录。

参数:

strSource - 源文件或目录。

strDest - 目的文件。
若指定的路径为目录，则源文件移动到目的目录下。
若指定的路径不存在或为文件，则如果源是文件则移动源文件为此文件，
否则自动创建目标目录，并移动源目录到目的目录下。

bSubOnly - 只移动源目录下的子目录和文件。
strSource 为 C:\S\ strDest 为 C:\D\ ，
C:\S 有文件 C:\S\A 和 C:\S\B
若 bSubOnly 为 true ，
调用方法后，结果为：C:\D\A ，C:\D\B 。
若 bSubOnly 为 false ，
调用方法后，结果为：C:\D\S\A ，C:\D\S\B 。

返回:

copyFile

public final boolean copyFile(java.lang.String strSource,
               java.lang.String strDest)

复制文件。

参数:

strSource - 源文件。

strDest - 目标文件，如果以 / 或 \ 结束为拷贝到指定目录中。

返回:

成果返回 true。

copyFile

public final boolean copyFile(java.lang.String strSource,
               java.lang.String strDest,
               boolean bSubOnly,
               boolean bDelSrc)

复制文件或目录。
不自动重命名目标文件名。

参数:

strSource - 源文件或目录。

strDest - 目的文件。
若指定的路径为目录，则源文件移动到目的目录下。
若指定的路径不存在或为文件，则如果源是文件则移动源文件为此文件，
否则自动创建目标目录，并移动源目录到目的目录下。

bSubOnly - 只移动源目录下的子目录和文件。
strSource 为 C:\S\ strDest 为 C:\D\ ，
C:\S 有文件 C:\S\A 和 C:\S\B
若 bSubOnly 为 true ，
调用方法后，结果为：C:\D\A ，C:\D\B 。
若 bSubOnly 为 false ，
调用方法后，结果为：C:\D\S\A ，C:\D\S\B 。

bDelSrc - 操作成功后是否删除源文件。

返回:

copyFile

public boolean copyFile(java.lang.String strSource,
               java.lang.String strDest,
               boolean bSubOnly,
               boolean bDelSrc,
               boolean bAutoRename)

复制文件或目录。

参数:

strSource - 源文件或目录。

strDest - 目的文件。
若指定的路径为目录，则源文件移动到目的目录下。
若指定的路径不存在或为文件，则如果源是文件则移动源文件为此文件，
否则自动创建目标目录，并移动源目录到目的目录下。

bSubOnly - 只移动源目录下的子目录和文件。
strSource 为 C:\S\ strDest 为 C:\D\ ，
C:\S 有文件 C:\S\A 和 C:\S\B
若 bSubOnly 为 true ，
调用方法后，结果为：C:\D\A ，C:\D\B 。
若 bSubOnly 为 false ，
调用方法后，结果为：C:\D\S\A ，C:\D\S\B 。

bDelSrc - 操作成功后是否删除源文件。

bAutoRename - 是否自动重命名不合法的目标文件名。

返回:

readFileBinaryData

public static final byte[] readFileBinaryData(java.lang.String strFilePath)

读取指定文件的二进制数据。

参数:

strFilePath - 文件路径。

返回:

文件不存在或非目录或读取错误时返回null。

readFileData

public static final java.lang.StringBuffer readFileData(java.lang.String strFilePath)

获取指定文件数据。
默认语言编码为UTF-8。

参数:

strFilePath - 文件路径。

返回:

数据内容保存到 StringBuffer 返回。

readFileData

public static java.lang.StringBuffer readFileData(java.lang.String filePath,
                                  java.lang.String encoding)

获取指定文件的数据。

参数:

filePath - 文件路径。

encoding - 文件内容语言编码。

返回:

数据内容保存到 StringBuffer 返回。

getFileNameFromStr

public static java.lang.String getFileNameFromStr(java.lang.String strPath)

取得字符串中的文件名。

参数:

strPath - String 文件路径

返回:

String

getFileExtFromStr

public static java.lang.String getFileExtFromStr(java.lang.String strPath)

获取字符串中的文件扩展名。不包括点.

参数:

strPath -

返回:

getFileNameWithNoExtFromStr

public static java.lang.String getFileNameWithNoExtFromStr(java.lang.String strPath)

取得字符串中的文件名。

参数:

strPath - String 文件路径

返回:

String

getIncludeExcludeFileFilter

public static java.io.FileFilter getIncludeExcludeFileFilter(java.lang.String strInclude,
                                             java.lang.String strExclude)

获取通过正规表达式匹配文件全路径包含文件和排除文件的文件过滤器。

参数:

strInclude - 文件全路径只有满足此正规表达式才通过校验。

strExclude - 文件全路径满足此正规表达式将被过滤，不允许通过校验。

返回:

getIncludeExcludeFileFilter

public static java.io.FileFilter getIncludeExcludeFileFilter(java.lang.String[] arrayInclude,
                                             java.lang.String[] arrayExclude)

获取通过正规表达式匹配文件全路径包含文件和排除文件的文件过滤器。

参数:

arrayInclude - 文件全路径只有满足此正规表达式才通过校验。

arrayExclude - 文件全路径满足此正规表达式将被过滤，不允许通过校验。

getIncludeExcludeFileFilter

public static java.io.FileFilter getIncludeExcludeFileFilter(StringList lstInclude,
                                             StringList lstExclude)

获取通过正规表达式匹配文件全路径包含文件和排除文件的文件过滤器。

参数:

lstInclude - 文件全路径只有满足此正规表达式才通过校验。

lstExclude - 文件全路径满足此正规表达式将被过滤，不允许通过校验。

getValidFileName

public static java.lang.String getValidFileName(java.lang.String strFileName)

修正指定的文件名为合法的文件名。 不合法的字符自动被替换为下横线 _

参数:

strFileName - 文件名。可以包括全路径。

返回:

setTime

public static int setTime(java.io.File objFile,
          long lLastModified)

设置指定文件或目录及子目录的修改时间。

参数:

objFile - 文件或目录的文件对象。

lLastModified - 新的修改时间时间值。

返回:

被修改的文件或目录数量。

setTime

public static int setTime(java.lang.String strPath,
          long lLastModified)

设置指定文件或目录及子目录的修改时间。

参数:

strPath - 文件或目录全路径。

lLastModified - 新的修改时间时间值。

返回:

被修改的文件或目录数量。

isAttacheFile

public static boolean isAttacheFile(java.lang.String strFileName)

是否为合法的附件文件。

isForbidFile

public static boolean isForbidFile(java.lang.String strFileName)

是否为禁止的文件。

isImageFile

public static boolean isImageFile(java.lang.String strFileName)

是否为图片文件。

isExeFile

public static boolean isExeFile(java.lang.String strFileName)

是否为可执行文件。

checkExtFile

public static boolean checkExtFile(java.lang.String strExtList,
                   java.lang.String strFileName)

检查文件后缀名是否符合要求。

参数:

strExtList - 英文分号分隔的小写英文后缀名列表。

strFileName - 要检查的文件名。

返回:

匹配返回true否则返回false。

cleanEmpty

public static int cleanEmpty(java.lang.String strPath)

删除指定路径下的空文件和空目录，如果指定的目录或文件为空，删除指定的目录或文件。 函数操作后不改变目录的最后修改时间。

参数:

strPath - 指定的目录或文件全路径。

返回:

返回成功删除的文件和目录数量。

cleanEmpty

public static int cleanEmpty(java.io.File objFile)

删除指定路径下的空文件和空目录，如果指定的目录或文件为空，删除指定的目录或文件。 函数操作后不改变目录的最后修改时间。

参数:

objFile - 指定的目录或文件的文件对象。

返回:

返回成功删除的文件和目录数量。

writeFile

public static boolean writeFile(java.lang.String fileName,
                java.lang.String data)

把指定字符串写入文件。文件将被覆盖。

参数:

fileName - 文件名。

data - 写入的字符串内容。

返回:

writeFile

public static boolean writeFile(java.lang.String strFileName,
                byte[] arrayData)

直接把数据写入文件。

参数:

strFileName - 文件名。

arrayData - 二进制数据。

返回:

writeFile

public static boolean writeFile(java.lang.String fileName,
                java.io.InputStream inputStream)

把输入流的数据写入指定文件。文件将被改写。

参数:

fileName - 文件名。

inputStream - 数据输入流。

返回:

zipFiles

public static boolean zipFiles(java.lang.String strZipFileName,
               java.lang.String[] arrayFileName)

压缩指定的文件。

参数:

strZipFileName - zip文件名全路径。

arrayFileName - 要压缩的文件列表。

返回:

totalSize

public static long totalSize(java.io.File objFile)

获取指定目录或文件的总大小。

参数:

objFile - 文件或目录对象。

返回:

unrarFile

public static boolean unrarFile(java.lang.String strRARFileName,
                java.lang.String strOutputDir,
                java.lang.String strPassword)

解压rar文件到指定目录。unzipFile() 会自动判断后缀调用此方法。

参数:

strRARFileName - RAR压缩文件文件名。

strOutputDir - 解压文件输出目录。

strPassword - 解压密码。

返回:

unzipFile

public static boolean unzipFile(java.lang.String strZipFileName,
                java.lang.String strOutputDir)

解压zip文件到指定目录（同时支持解压RAR文件）。

参数:

strZipFileName - zip文件名。

strOutputDir - 解压到的目录。

返回:

main

public static void main(java.lang.String[] arrayArg)
                 throws java.lang.Exception

测试及常用工具的函数。

 当第一个参数为小写的 copy 时，进行复制操作：
          第二个参数为源文件；
          第三个参数为目标文件；
          第四个参数为是否只移动源目录下的子目录和文件；
          第五个参数为是否操作成功后是否删除源文件；
          第六个参数为是否自动重命名不合法的目标文件名。
 当第一个参数为小写的 move 时，进行移动操作：
          第二个参数为源文件；
          第三个参数为目标文件；
          第四个参数为是否只移动源目录下的子目录和文件。
 当第一个参数为小写的 clean 时，进行清理操作：
          第二个参数为清理的路径；
 当第一个参数为小写的 time 时，进行设置时间操作：
          第二个参数为源文件；
          第三个参数为时间长整型值。
 当第一个参数为小写的 size 时，列出指定目录下的子目录及文件大小：
          第二个参数为要列出大小的路径；
 

参数:

arrayArg - 调用参数。

抛出:

java.lang.Exception