FilePath (Falcon: A common library for Java 0.4.1 API)

java.lang.Object
- com.iofairy.falcon.fs.FilePath

```
public class FilePath
extends Object
```
File Path

从以下版本开始:

0.0.1

字段概要

字段
限定符和类型	字段	说明
`static String`	`BACKSLASH`
`static String`	`BACKSLASHDOT`
`static String`	`DOT`
`static String`	`DOTBACKSLASH`
`static String`	`DOTSLASH`
`static String`	`EMPTY`
`static Pattern`	`ONLY_DOT_PATTERN`
`static String`	`PARENT_DIR`
`static String`	`ROOT`
`static String`	`SLASH`
`static Pattern`	`SLASH_PATTERN`
`static String`	`SLASHDOT`
`static String`	`TWOBACKSLASH`

构造器概要

构造器
构造器说明

FilePath()

构造器
构造器	说明
`FilePath()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法	说明
`static String`	`addHeadDotSlash(String originPath)`	Merge multi `"/"` and `"./"` to one first, and then add `"./"` to head.
`static String`	`addHeadDotSlash(String originPath, boolean isNeedMerge)`	Add `"./"` to head.
`static String`	`addHeadSlash(String originPath)`	Merge multi `"/"` and `"./"` to one first, and then add `"/"` to head.
`static String`	`addHeadSlash(String originPath, boolean isNeedMerge)`	Add `"/"` to head.
`static String`	`addTailSlash(String originPath)`	Merge multi `"/"` and `"./"` to one first, and then add tail `"/"`.
`static String`	`addTailSlash(String originPath, boolean isNeedMerge)`	Add tail `"/"`.
`static String`	`backslashToSlash(String originPath)`	For Windows systems, transform `'\'` to `'/'`, and merge multi `'/'` to one in file path.
`private static String`	`concatPath(boolean isWin, String firstPath, String... subPaths)`	Concat paths.
`static String`	`ext(String fileName)`	Get file extension from filename.
`static String`	`extNoDot(String fileName)`	Get file extension without dot from filename.
`static String[]`	`exts(String fileName)`	获取文件名的后缀名数组，用于拼接后缀名
`private static PathInfo`	`getPathInfo(String filePath, SeparatorType separatorType)`	获取PathInfo 注： Win和Unix-like系统 `.` 与 `..` 都代表文件夹，无法创建重名的文件； Win下无法创建只包含 `.` 的文件或文件夹； Win下无法创建包含 `/` 或 `\` 的文件或文件夹； Unix-like下无法创建包含 `/` 的文件或文件夹，可以创建只包含 `\` 的文件或文件夹（`mkdir \\` 或 `touch \\`）
`static PathInfo`	`info(String filePath)`	PathInfo for Unix-like systems.
`static PathInfo`	`infoAuto(String filePath)`	The system-dependent for getting PathInfo.
`static PathInfo`	`infoAutoWin(String filePath)`	The system-dependent for getting PathInfo.
`static PathInfo`	`infoSlash(String filePath)`	PathInfo for Windows systems.
`static PathInfo`	`infoWin(String filePath)`	PathInfo for Windows systems.
`static String`	`mergeDotBackslash(String originPath)`	Merge multi `'.\'` to one.
`static String`	`mergeDotSlash(String originPath)`	Merge multi `'./'` to one.
`static String`	`mergeRepeated(String originPath)`	Merge multi `'/'` to one first, and then merge multi `"./"` to one.
`static String`	`mergeSlash(String originPath, boolean whetherMergeSlash)`	Merge multi `'/'` or `'\'` to one.
`static String`	`path(String firstPath, String... subPaths)`	Path for Unix-like systems. it will use `'/'` as files separator.
`static String`	`pathAuto(String firstPath, String... subPaths)`	The system-dependent for concat paths.
`static String`	`pathAutoWin(String firstPath, String... subPaths)`	The system-dependent for concat paths.
`static String`	`pathSlash(String firstPath, String... subPaths)`	Path for Windows systems. it will use `'/'` as files separator, and will transform all `'\'` to `'/'`.
`static String`	`pathWin(String firstPath, String... subPaths)`	Path for Windows systems. it will use `'\'` as files separator, and will transform all `'/'` to `'\'`.
`static String`	`rmHeadDotSlash(String originPath)`	Merge multi `"/"` and `"./"` to one first, and then remove `"./"` at the head.
`static String`	`rmHeadDotSlash(String originPath, boolean isNeedMerge)`	Remove `"./"` at the head.
`static String`	`rmHeadSlash(String originPath)`	Merge multi `"/"` and `"./"` to one first, and then remove `"/"` at the head.
`static String`	`rmHeadSlash(String originPath, boolean isNeedMerge)`	Remove `"/"` at the head.
`static String`	`rmTailSlash(String originPath)`	Merge multi `"/"` and `"./"` to one first, and then remove tail `"/"`.
`static String`	`rmTailSlash(String originPath, boolean isNeedMerge)`	Remove tail `"/"`.
`static String`	`rmTailSlashDot(String originPath)`	Merge multi `"/"` and `"./"` to one first, and then remove tail `"/."`.
`static String`	`rmTailSlashDot(String originPath, boolean isNeedMerge)`	Remove tail `"/."`.
`static String`	`slashToBackslash(String originPath)`	For Windows systems, transform `'/'` to `'\'`, and merge multi `'\'` to one in file path.
`private static void`	`verifyParams(String firstPath, String... subPaths)`	Verify params.

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

- 字段详细资料
  - ROOT
```
public static final String ROOT
```
    另请参阅:
    
    常量字段值
  - SLASH
```
public static final String SLASH
```
    另请参阅:
    
    常量字段值
  - BACKSLASH
```
public static final String BACKSLASH
```
    另请参阅:
    
    常量字段值
  - EMPTY
```
public static final String EMPTY
```
    另请参阅:
    
    常量字段值
  - DOT
```
public static final String DOT
```
    另请参阅:
    
    常量字段值
  - PARENT_DIR
```
public static final String PARENT_DIR
```
    另请参阅:
    
    常量字段值
  - DOTSLASH
```
public static final String DOTSLASH
```
    另请参阅:
    
    常量字段值
  - DOTBACKSLASH
```
public static final String DOTBACKSLASH
```
    另请参阅:
    
    常量字段值
  - TWOBACKSLASH
```
public static final String TWOBACKSLASH
```
    另请参阅:
    
    常量字段值
  - SLASHDOT
```
public static final String SLASHDOT
```
    另请参阅:
    
    常量字段值
  - BACKSLASHDOT
```
public static final String BACKSLASHDOT
```
    另请参阅:
    
    常量字段值
  - SLASH_PATTERN
```
public static final Pattern SLASH_PATTERN
```
  - ONLY_DOT_PATTERN
```
public static final Pattern ONLY_DOT_PATTERN
```
- 构造器详细资料
  - FilePath
```
public FilePath()
```
- 方法详细资料
  - path
```
public static String path(String firstPath,
                          String... subPaths)
```
    Path for Unix-like systems. it will use '/' as files separator.
    用于Unix-like下拼接路径。会使用 '/' 作为文件之间的分隔符。且 '\' 在Unix-like系统路径中作为转义字符使用，所以不能转成 '/'。
    Examples:
```
 FilePath.path("./a", "b", "./c/", "/d")  returns "./a/b/c/d"
 FilePath.path("./", "./", "//", "/.")    returns "."
 
```
    参数:
    
    firstPath - firstPath
    
    subPaths - subPaths
    
    返回:
    
    a full path
  - pathWin
```
public static String pathWin(String firstPath,
                             String... subPaths)
```
    Path for Windows systems. it will use '\' as files separator, and will transform all '/' to '\'.
    用于Windows下拼接路径。且会使用 '\' 作为文件之间的分隔符，会将所有 '/' 转换成 '\'。
    Examples:
```
 FilePath.pathWin("./a", "\\\b", "\\\./c", "/d")    returns ".\a\b\c\d"
 FilePath.pathWin("./.", "./")                        returns "."
 
```
    参数:
    
    firstPath - firstPath
    
    subPaths - subPaths
    
    返回:
    
    a full path
  - pathSlash
```
public static String pathSlash(String firstPath,
                               String... subPaths)
```
    Path for Windows systems. it will use '/' as files separator, and will transform all '\' to '/'.
    用于Windows下拼接路径。且会使用 '/' 作为文件之间的分隔符，会将所有 '\' 转换成 '/'。
    Examples:
```
 FilePath.pathSlash("./a", "\\\b", "\\\./c", "/d")  returns "./a/b/c/d"
 FilePath.pathSlash("/", "./")                        returns "/"
 
```
    参数:
    
    firstPath - firstPath
    
    subPaths - subPaths
    
    返回:
    
    a full path
  - concatPath
```
private static String concatPath(boolean isWin,
                                 String firstPath,
                                 String... subPaths)
```
    Concat paths.
    拼接路径。
    
    参数:
    
    isWin - is Windows path or not
    
    firstPath - firstPath
    
    subPaths - subPaths
    
    返回:
    
    path. Note: it will return null when firstPath is null or there is null value in subPaths.
  - pathAuto
```
public static String pathAuto(String firstPath,
                              String... subPaths)
```
    The system-dependent for concat paths.
    On Unix-like systems, it will call path(String, String...);
    On Windows systems, it will call pathSlash(String, String...).
    
    根据系统自动选择拼接paths的方法。
    在Unix-like系统，会调用 path(String, String...)；
    在Windows系统，则会调用 pathSlash(String, String...)。
    
    参数:
    
    firstPath - firstPath
    
    subPaths - subPaths
    
    返回:
    
    a full path
  - pathAutoWin
```
public static String pathAutoWin(String firstPath,
                                 String... subPaths)
```
    The system-dependent for concat paths.
    On Unix-like systems, it will call path(String, String...);
    On Windows systems, it will call pathWin(String, String...).
    
    根据系统自动选择拼接paths的方法。
    在Unix-like系统，会调用 path(String, String...)；
    在Windows系统，则会调用 pathWin(String, String...)。
    
    参数:
    
    firstPath - firstPath
    
    subPaths - subPaths
    
    返回:
    
    a full path
  - info
```
public static PathInfo info(String filePath)
```
    PathInfo for Unix-like systems. Using SeparatorType.SLASH.
    
    参数:
    
    filePath - 文件路径
    
    返回:
    
    PathInfo
    
    从以下版本开始:
    
    0.0.6
  - infoWin
```
public static PathInfo infoWin(String filePath)
```
    PathInfo for Windows systems. Using SeparatorType.BACKSLASH.
    
    参数:
    
    filePath - 文件路径
    
    返回:
    
    PathInfo
    
    从以下版本开始:
    
    0.0.6
  - infoSlash
```
public static PathInfo infoSlash(String filePath)
```
    PathInfo for Windows systems. Using SeparatorType.WIN_SLASH.
    
    参数:
    
    filePath - 文件路径
    
    返回:
    
    PathInfo
    
    从以下版本开始:
    
    0.0.6
  - infoAuto
```
public static PathInfo infoAuto(String filePath)
```
    The system-dependent for getting PathInfo.
    
    参数:
    
    filePath - 文件路径
    
    返回:
    
    PathInfo
    
    从以下版本开始:
    
    0.0.6
  - infoAutoWin
```
public static PathInfo infoAutoWin(String filePath)
```
    The system-dependent for getting PathInfo.
    
    参数:
    
    filePath - 文件路径
    
    返回:
    
    PathInfo
    
    从以下版本开始:
    
    0.0.6
  - getPathInfo
```
private static PathInfo getPathInfo(String filePath,
                                    SeparatorType separatorType)
```
    获取PathInfo
    注：
    Win和Unix-like系统 . 与 .. 都代表文件夹，无法创建重名的文件；
    Win下无法创建只包含 . 的文件或文件夹；
    Win下无法创建包含 / 或 \ 的文件或文件夹；
    Unix-like下无法创建包含 / 的文件或文件夹，可以创建只包含 \ 的文件或文件夹（mkdir \\ 或 touch \\）
    
    参数:
    
    filePath - filePath
    
    separatorType - separatorType
    
    返回:
    
    PathInfo
    
    从以下版本开始:
    
    0.0.6
  - addHeadDotSlash
```
public static String addHeadDotSlash(String originPath)
```
    Merge multi "/" and "./" to one first, and then add "./" to head.
    先去除重复的"/"和"./"，再添加头部的 "./"
    
    参数:
    
    originPath - originPath
    
    返回:
    
    path
  - addHeadDotSlash
```
public static String addHeadDotSlash(String originPath,
                                     boolean isNeedMerge)
```
    Add "./" to head.
    添加头部的 "./"
    
    参数:
    
    originPath - originPath
    
    isNeedMerge - is need merge "/" and "./" first
    
    返回:
    
    path
  - rmHeadDotSlash
```
public static String rmHeadDotSlash(String originPath)
```
    Merge multi "/" and "./" to one first, and then remove "./" at the head.
    先去除重复的"/"和"./"，再删除头部的 "./"
    
    参数:
    
    originPath - originPath
    
    返回:
    
    path
  - rmHeadDotSlash
```
public static String rmHeadDotSlash(String originPath,
                                    boolean isNeedMerge)
```
    Remove "./" at the head.
    删除头部的 "./"
    
    参数:
    
    originPath - originPath
    
    isNeedMerge - is need merge "/" and "./" first
    
    返回:
    
    path
  - rmTailSlashDot
```
public static String rmTailSlashDot(String originPath)
```
    Merge multi "/" and "./" to one first, and then remove tail "/.".
    先去除重复的"/"和"./"，再删除尾部的 "/."
    
    参数:
    
    originPath - originPath
    
    返回:
    
    path
  - rmTailSlashDot
```
public static String rmTailSlashDot(String originPath,
                                    boolean isNeedMerge)
```
    Remove tail "/.".
    删除尾部的 "/."
    
    参数:
    
    originPath - originPath
    
    isNeedMerge - is need merge "/" and "./" first
    
    返回:
    
    path
  - rmTailSlash
```
public static String rmTailSlash(String originPath)
```
    Merge multi "/" and "./" to one first, and then remove tail "/".
    先去除重复的"/"和"./"，再去除路径尾部 '/'
    
    参数:
    
    originPath - originPath
    
    返回:
    
    path
  - rmTailSlash
```
public static String rmTailSlash(String originPath,
                                 boolean isNeedMerge)
```
    Remove tail "/".
    去除路径尾部 '/'
    
    参数:
    
    originPath - originPath
    
    isNeedMerge - is need merge "/" and "./" first
    
    返回:
    
    path
  - rmHeadSlash
```
public static String rmHeadSlash(String originPath)
```
    Merge multi "/" and "./" to one first, and then remove "/" at the head.
    先去除重复的"/"和"./"，再去除路径头部 '/'
    
    参数:
    
    originPath - originPath
    
    返回:
    
    path
  - rmHeadSlash
```
public static String rmHeadSlash(String originPath,
                                 boolean isNeedMerge)
```
    Remove "/" at the head.
    去除路径头部 '/'
    
    参数:
    
    originPath - originPath
    
    isNeedMerge - is need merge "/" and "./" first
    
    返回:
    
    path
  - addHeadSlash
```
public static String addHeadSlash(String originPath)
```
    Merge multi "/" and "./" to one first, and then add "/" to head.
    先去除重复的"/"和"./"，再添加头部 '/'
    
    参数:
    
    originPath - originPath
    
    返回:
    
    path
  - addHeadSlash
```
public static String addHeadSlash(String originPath,
                                  boolean isNeedMerge)
```
    Add "/" to head.
    添加头部 '/'
    
    参数:
    
    originPath - originPath
    
    isNeedMerge - is need merge "/" and "./" first
    
    返回:
    
    path
  - addTailSlash
```
public static String addTailSlash(String originPath)
```
    Merge multi "/" and "./" to one first, and then add tail "/".
    先去除重复的"/"和"./"，再添加尾部 '/'
    
    参数:
    
    originPath - originPath
    
    返回:
    
    path
  - addTailSlash
```
public static String addTailSlash(String originPath,
                                  boolean isNeedMerge)
```
    Add tail "/".
    添加尾部 '/'
    
    参数:
    
    originPath - originPath
    
    isNeedMerge - is need merge "/" and "./" first
    
    返回:
    
    path
  - backslashToSlash
```
public static String backslashToSlash(String originPath)
```
    For Windows systems, transform '\' to '/', and merge multi '/' to one in file path.
    针对Windows系统，将路径中的 '\' 转成 '/'，并合并多个重复的'/'。
    
    参数:
    
    originPath - originPath
    
    返回:
    
    parsed path
  - slashToBackslash
```
public static String slashToBackslash(String originPath)
```
    For Windows systems, transform '/' to '\', and merge multi '\' to one in file path.
    针对Windows系统，将路径中的 '/' 转成 '\'，并合并多个重复的'\'。
    
    参数:
    
    originPath - originPath
    
    返回:
    
    parsed path
  - mergeRepeated
```
public static String mergeRepeated(String originPath)
```
    Merge multi '/' to one first, and then merge multi "./" to one.
    先去除重复的 '/'，再去除重复的 "./"。
    
    参数:
    
    originPath - originPath
    
    返回:
    
    merged path
  - mergeSlash
```
public static String mergeSlash(String originPath,
                                boolean whetherMergeSlash)
```
    Merge multi '/' or '\' to one.
    合并多个 '/' 或 '\' 成一个。
    
    参数:
    
    originPath - originPath
    
    whetherMergeSlash - if true, merge '/'; otherwise, merge '\'
    
    返回:
    
    merged path
  - mergeDotSlash
```
public static String mergeDotSlash(String originPath)
```
    Merge multi './' to one.
    合并多个 './' 成一个。
    
    参数:
    
    originPath - originPath
    
    返回:
    
    merged path
  - mergeDotBackslash
```
public static String mergeDotBackslash(String originPath)
```
    Merge multi '.\' to one.
    合并多个 '.\' 成一个。
    
    参数:
    
    originPath - originPath
    
    返回:
    
    merged path
  - exts
```
public static String[] exts(String fileName)
```
    获取文件名的后缀名数组，用于拼接后缀名
    
    参数:
    
    fileName - 文件名
    
    返回:
    
    后缀名数组
    
    从以下版本开始:
    
    0.3.5
  - ext
```
public static String ext(String fileName)
```
    Get file extension from filename.
    从文件名中获取文件扩展名。
    注：Windows不能创建以 . 为后缀的文件或文件夹（会自动去除），Linux则可以。
    
    参数:
    
    fileName - 文件名
    
    返回:
    
    file extension, eg: .txt, .csv
  - extNoDot
```
public static String extNoDot(String fileName)
```
    Get file extension without dot from filename.
    从文件名中获取文件扩展名，不带点。
    注：Windows不能创建以 . 为后缀的文件或文件夹（会自动去除），Linux则可以。
    
    参数:
    
    fileName - 文件名
    
    返回:
    
    file extension without dot, eg: txt, csv
  - verifyParams
```
private static void verifyParams(String firstPath,
                                 String... subPaths)
```
    Verify params.
    校验参数的有效性
    
    参数:
    
    firstPath - firstPath
    
    subPaths - subPaths

类 FilePath

字段概要

构造器概要

方法概要

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

字段详细资料

ROOT

SLASH

BACKSLASH

EMPTY

DOT

PARENT_DIR

DOTSLASH

DOTBACKSLASH

TWOBACKSLASH

SLASHDOT

BACKSLASHDOT

SLASH_PATTERN

ONLY_DOT_PATTERN

构造器详细资料

FilePath

方法详细资料

path

pathWin

pathSlash

concatPath

pathAuto

pathAutoWin

info

infoWin

infoSlash

infoAuto

infoAutoWin

getPathInfo

addHeadDotSlash

addHeadDotSlash

rmHeadDotSlash

rmHeadDotSlash

rmTailSlashDot

rmTailSlashDot

rmTailSlash

rmTailSlash

rmHeadSlash

rmHeadSlash

addHeadSlash

addHeadSlash

addTailSlash

addTailSlash

backslashToSlash

slashToBackslash

mergeRepeated

mergeSlash

mergeDotSlash

mergeDotBackslash

exts

ext

extNoDot

verifyParams