FileUtil (ass2 2.0.2 API)

java.lang.Object
- cn.liboss.ass.core.FileUtil

```
public class FileUtil
extends Object
```
文件操作工具类。
【gui项目】
【2022-12-30】
1. 类初始化
【2023-07-29】
1. [重写]createFolder和testCreateFolders方法
2. [重写]delFile和delAllFile 方法
3. [优化]getClassLoaderPtah 方法。
4. [优化]zipCompress 方法
【2023-08-09】
1.[优化]getClassLoaderPtah方法：采用全局变量，避免多次从文件中获取信息、避免日志重出现获取信息。
【2023-09-22】
1、新增：moveAndZipFileToDir() 两个方法。
【2023-10-06】
1、新增：propFileSave 方法。用OrderedProperties类实现保存时key的顺序写入

构造器概要

构造器
构造器和说明

FileUtil()

构造器
构造器和说明
`FileUtil()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static void`	`copyFile(String oldPath, String newPath)` 【v1.0】复制单个文件
`static void`	`copyFolder(String oldDirPath, String newDirPath)` 复制整个文件夹内容
`static void`	`createFile(String filePath, byte[] byteArray)` 【v1.0】创建新文件。
`static void`	`createFile(String filePath, InputStream inputStream)` 【v1.0】创建新文件。
`static void`	`createFolder(String folderPath)` 【v1.0】创建单个文件夹。
`static void`	`createFolders(String folderPath)` 【v1.0】创建多级文件夹。
`static void`	`createTextFile(String filePath, String content)` 【v1.0】创建新文件。
`static void`	`createTextFile(String filePath, String content, String Charset)` 【v1.0】创建新文件。
`static void`	`delAllFile(String folderPath)` 删除文件夹里面的所有文件
`static void`	`delFile(String filePath)` 【v1.0】删除文件
`static void`	`delFolder(String folderPath)` 删除文件夹
`static String`	`getClassLoaderPath()`
`static String`	`getFileName(String fullFileName)` 【v1.0】返回不含扩展名的文件名【v1.0】
`static String`	`getSystemProperties(String propertyKey)` 读取system.properties中的一个配置项
`static String`	`getSystemProperties(String propertyKey, boolean isFromCache)` 读取bin/classes或WEB-INF/classes目录下的system.properties文件
`static Properties`	`getSystemPropertiesFile()`
`static void`	`moveAndZipFileToDir(File srcFile, String bakupDir)` 以压缩方式移动到指定目录。
`static void`	`moveAndZipFileToDir(File srcFile, String bakupDir, Boolean isExtentionLowerCase)` 以压缩方式移动到指定目录。
`static void`	`moveFile(String oldFilePath, String newFilePath)` 【v1.0】移动文件变为新目录的文件
`static void`	`moveFolder(String oldPath, String newPath)` 移动文件夹到新文件夹
`static void`	`propFileSave(Properties properties)`
`static byte[]`	`readFileBytes(String filePath)` 【v1.0】读取文件字节
`static String`	`readTextFile(String filePath, String Charset)` 【v1.0】读取文本文件
`static String`	`readTextFileByUTF8(String fileName)`
`static byte[]`	`readZipFirstFileBytes(String zipFilePath)` 【v1.0】读取zip文件包中的第一个文件中的字节。
`static byte[]`	`readZipStreamFirstFileBytes(InputStream zipFile)` 【v1.0】读取zip文件流中的第一个文件中的字节。
`static void`	`unZipToFolder(String zipFilePath, String outputFolderPath)` 【v1.0】Zip文件解压。
`static void`	`zip(File destFile, File srcFile)` 【v1.0】单个或多个压缩。
`static void`	`zip(String destFilePath, String srcFilesPath)` 【v1.0】单个或多个压缩。
`static void`	`zipOfMultiple(File destFile, List<File> srcFilesList)` 【v1.0】多个文件压缩到一个zip文件。

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - FileUtil
```
public FileUtil()
```
- 方法详细资料
  - createTextFile
```
public static void createTextFile(String filePath,
                                  String content)
                           throws IOException
```
    【v1.0】创建新文件。如果存在同名文件，会覆盖。
    
    参数:
    
    filePath - 文件名称(全路径)
    
    content - 文件内容。此方法采用utf-8。
    
    抛出:
    
    IOException
  - createTextFile
```
public static void createTextFile(String filePath,
                                  String content,
                                  String Charset)
                           throws IOException
```
    【v1.0】创建新文件。如果存在同名文件，会覆盖。
    
    参数:
    
    filePath - 文件名称(全路径)
    
    content - 文件内容
    
    Charset - 文件编码。如：utf-8/gbk等。
    
    抛出:
    
    IOException
  - createFile
```
public static void createFile(String filePath,
                              InputStream inputStream)
                       throws IOException
```
    【v1.0】创建新文件。如果存在同名文件，会覆盖。
    
    抛出:
    
    IOException
  - createFile
```
public static void createFile(String filePath,
                              byte[] byteArray)
                       throws IOException
```
    【v1.0】创建新文件。如果存在同名文件，会覆盖。
    
    抛出:
    
    IOException
  - readTextFileByUTF8
```
public static String readTextFileByUTF8(String fileName)
                                 throws Exception
```
    抛出:
    
    Exception
  - readTextFile
```
public static String readTextFile(String filePath,
                                  String Charset)
                           throws Exception
```
    【v1.0】读取文本文件
    
    参数:
    
    filePath -
    
    Charset -
    
    抛出:
    
    Exception
  - readFileBytes
```
public static byte[] readFileBytes(String filePath)
                            throws IOException
```
    【v1.0】读取文件字节
    
    参数:
    
    filePath -
    
    抛出:
    
    IOException
  - readZipFirstFileBytes
```
public static byte[] readZipFirstFileBytes(String zipFilePath)
                                    throws IOException
```
    【v1.0】读取zip文件包中的第一个文件中的字节。
    
    参数:
    
    zipFilePath -
    
    抛出:
    
    IOException
  - readZipStreamFirstFileBytes
```
public static byte[] readZipStreamFirstFileBytes(InputStream zipFile)
                                          throws IOException
```
    【v1.0】读取zip文件流中的第一个文件中的字节。
    
    参数:
    
    zipFile -
    
    抛出:
    
    IOException
  - createFolder
```
public static void createFolder(String folderPath)
                         throws Exception
```
    【v1.0】创建单个文件夹。如果父文件夹不存在，则会抛出异常
    
    参数:
    
    folderPath -
    
    抛出:
    
    Exception
  - createFolders
```
public static void createFolders(String folderPath)
                          throws Exception
```
    【v1.0】创建多级文件夹。如果父文件夹不存在，则会自动创建父文件夹
    
    参数:
    
    folderPath - 文件夹路径
    
    抛出:
    
    Exception
  - delFile
```
public static void delFile(String filePath)
                    throws IOException
```
    【v1.0】删除文件
    
    参数:
    
    filePath - 文件路径及名称,如c:/download/abc.txt
    
    抛出:
    
    IOException
  - delAllFile
```
public static void delAllFile(String folderPath)
                       throws IOException
```
    删除文件夹里面的所有文件
    
    参数:
    
    folderPath - 文件夹路径如 c:/download
    
    抛出:
    
    IOException
  - delFolder
```
public static void delFolder(String folderPath)
                      throws IOException
```
    删除文件夹
    
    参数:
    
    folderPath - 文件夹路径及名称如c:/download
    
    抛出:
    
    IOException
  - copyFile
```
public static void copyFile(String oldPath,
                            String newPath)
                     throws IOException
```
    【v1.0】复制单个文件
    
    参数:
    
    oldPath - 原文件路径，如：c:/abc.DAT
    
    newPath - 复制后路径，如：f:/abc.DAT
    
    抛出:
    
    IOException
  - copyFolder
```
public static void copyFolder(String oldDirPath,
                              String newDirPath)
                       throws IOException
```
    复制整个文件夹内容
    
    参数:
    
    oldDirPath - 原文件路径，如：c:/abc
    
    newDirPath - 复制后路径，如：f:/aaa/bbb
    
    抛出:
    
    IOException
  - moveFile
```
public static void moveFile(String oldFilePath,
                            String newFilePath)
                     throws IOException
```
    【v1.0】移动文件变为新目录的文件
    
    参数:
    
    oldFilePath - 如：c:/abc.DAT
    
    newFilePath - 如：d:/abc.DAT
    
    抛出:
    
    IOException
  - moveFolder
```
public static void moveFolder(String oldPath,
                              String newPath)
                       throws IOException
```
    移动文件夹到新文件夹
    
    参数:
    
    oldPath - 如：c:/abc
    
    newPath - 如：d:/abc
    
    抛出:
    
    IOException
  - moveAndZipFileToDir
```
public static void moveAndZipFileToDir(File srcFile,
                                       String bakupDir)
                                throws Exception
```
    以压缩方式移动到指定目录。主要是归档备份用。
    
    参数:
    
    srcFile - 一个源文件
    
    bakupDir - 备份目录
    
    抛出:
    
    Exception
  - moveAndZipFileToDir
```
public static void moveAndZipFileToDir(File srcFile,
                                       String bakupDir,
                                       Boolean isExtentionLowerCase)
                                throws Exception
```
    以压缩方式移动到指定目录。主要是归档备份用。
    
    参数:
    
    srcFile - 源文件
    
    bakupDir - 备份目录
    
    isExtentionLowerCase - 扩展名的zip是否小写。true时，是zip; fales时，是ZIP。主要是针对在线监测的谱图文件扩展名大写才好处理，所以留的此参数。
    
    抛出:
    
    Exception
  - getSystemProperties
```
public static String getSystemProperties(String propertyKey)
                                  throws IOException
```
    读取system.properties中的一个配置项
    
    参数:
    
    propertyKey -
    
    抛出:
    
    IOException
  - getSystemProperties
```
public static String getSystemProperties(String propertyKey,
                                         boolean isFromCache)
                                  throws IOException
```
    读取bin/classes或WEB-INF/classes目录下的system.properties文件
    
    参数:
    
    propertyKey - key名称
    
    isFromCache - true-程序启动后，第一次读取后存入内存，以后每次从内存取值。false-每次取key时，都重新读取文件，从文件取值。性能要求高时考虑为true。
    
    返回:
    
    对应键的值
    
    抛出:
    
    IOException
  - getClassLoaderPath
```
public static String getClassLoaderPath()
```
  - getSystemPropertiesFile
```
public static Properties getSystemPropertiesFile()
                                          throws IOException
```
    抛出:
    
    IOException
  - propFileSave
```
public static void propFileSave(Properties properties)
                         throws IOException
```
    抛出:
    
    IOException
  - getFileName
```
public static String getFileName(String fullFileName)
```
    【v1.0】返回不含扩展名的文件名【v1.0】
    
    参数:
    
    fullFileName - 完整路径(含文件名)
    
    返回:
    
    返回文件名(不带扩展名)
  - zipOfMultiple
```
public static void zipOfMultiple(File destFile,
                                 List<File> srcFilesList)
                          throws Exception
```
    【v1.0】多个文件压缩到一个zip文件。
    
    参数:
    
    destFile - 目标zip文件
    
    srcFilesList - 待压缩的原文件的集合
    
    抛出:
    
    Exception
  - zip
```
public static void zip(String destFilePath,
                       String srcFilesPath)
                throws Exception
```
    【v1.0】单个或多个压缩。支持单个或者多个目录或文件，支持多层目录文件，保留空目录。如果srcFiles是一个目录，把整个目录压缩到一个zip文件。如果srcFiles是一个文件，则仅压缩这个文件到一个zip文件。
    
    参数:
    
    destFilePath - 目标zip文件
    
    srcFilesPath - 待压缩的原文件。如果srcFiles是一个目录，把整个目录压缩到一个zip文件。如果srcFiles是一个文件，则仅压缩这个文件到一个zip文件。
    
    抛出:
    
    Exception
  - zip
```
public static void zip(File destFile,
                       File srcFile)
                throws Exception
```
    【v1.0】单个或多个压缩。支持单个或者多个目录或文件，支持多层目录文件，保留空目录。如果srcFiles是一个目录，把整个目录压缩到一个zip文件。如果srcFiles是一个文件，则仅压缩这个文件到一个zip文件。
    
    参数:
    
    destFile - 目标zip文件
    
    srcFile - 待压缩的原文件。如果srcFiles是一个目录，把整个目录压缩到一个zip文件。如果srcFiles是一个文件，则仅压缩这个文件到一个zip文件。
    
    抛出:
    
    Exception
  - unZipToFolder
```
public static void unZipToFolder(String zipFilePath,
                                 String outputFolderPath)
                          throws IOException
```
    【v1.0】Zip文件解压。
    
    参数:
    
    zipFilePath - zip文件全路径
    
    outputFolderPath - 解压到的文件夹
    
    抛出:
    
    IOException

类 FileUtil

构造器概要

方法概要

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

构造器详细资料

FileUtil

方法详细资料

createTextFile

createTextFile

createFile

createFile

readTextFileByUTF8

readTextFile

readFileBytes

readZipFirstFileBytes

readZipStreamFirstFileBytes

createFolder

createFolders

delFile

delAllFile

delFolder

copyFile

copyFolder

moveFile

moveFolder

moveAndZipFileToDir

moveAndZipFileToDir

getSystemProperties

getSystemProperties

getClassLoaderPath

getSystemPropertiesFile

propFileSave

getFileName

zipOfMultiple

zip

zip

unZipToFolder