/*
*根据一项或多项授权给Apache Software Foundation（ASF）
*出资人许可协议。请参阅与一起分发的NOTICE文件
*这篇文章是关于版权所有权的其他信息。
*ASF根据Apache许可证2.0版将此文件授权给您
*（“许可证”）；除非符合
*许可证。您可以在以下地址获得许可证副本：
*
*      http://www.apache.org/licenses/LICENSE-2.0
*
*除非适用法律要求或书面同意，否则软件
*根据许可证分发是在“按原样”的基础上分发的，
*无任何明示或暗示的保证或条件。
*有关管理权限的特定语言和
*许可证下的限制。
*/

软件包org.apache.commons.net.ftp；

导入java.io.Serializable；
导入java.time。即时；
导入java.util。日历；
导入java.util。日期；
导入java.util。格式化程序；
导入java.util。时区；

/**
*FTPFile类用于表示有关存储在FTP服务器上的文件的信息。
*
*@参见FTPFileEntryParser
*@请参阅FTPClient#listFiles
*/
公共类FTPFile实现Serializable{

private static final long serialVersionUID=9010790363003271996L；

/**表示FTPFile是文件的常量*/
公共静态最终int FILE_TYPE=0；

/**表示FTPFile是目录的常量*/
公共静态最终int DIRECTORY_TYPE=1；

/**表示FTPFile的常量是符号链接*/
公共静态最终int SYMBOLIC_LINK_TYPE=2；

/**指示FTPFile的常量的类型未知*/
公共静态最终int UNKNOWN_TYPE=3；

/**指示用户访问权限的常数*/
公共静态最终int USER_ACCESS=0；

/**指示组访问权限的常量*/
public static final int GROUP_ACCESS=1；

/**一个表示世界访问权限的常量*/
公共静态最终int WORLD_ACCESS=2；

/**指示文件/目录读取权限的常量*/
公共静态最终int READ_PERMISSION=0；

/**表示文件/目录写入权限的常量*/
公共静态最终int WRITE_PERMISSION=1；

/**指示文件执行权限或目录列表权限的常量*/
public static final int EXECUTE_PERMISSION=2；

private int type=UNKNOWN_type；

/**0作为链接计数无效*/
私有int hardLinkCount；

/**0有效，因此使用-1*/
私有长尺寸=-1；
私有字符串rawListing；
private String user=“”；
private字符串组=“”；
私有字符串名称；
私有字符串链接；

//TODO考虑将内部表示更改为java.time。
私人日历；

/**如果为空，则列表条目解析失败*/
private final boolean[][]权限；//例如_permissions[USER_ACCESS][READ_PERMISSION]

/**创建空的FTPFile*/
公共FTPFile（）{
权限=新布尔值[3]；
}

/**
*仅供{@link FTPListParseEngine}使用的构造函数。用于为失败的分析创建FTPFile条目
*
*无法解析的@param rawListing行。
*@自3.4起
*/
FTPFile（最终字符串原始列表）{
this.permissions=空；//标记条目无效
this.rawListing=rawListing；
}

私有字符格式Type（）{
开关（类型）{
案例文件类型：
返回“-”；
案例DIRECTORY_TYPE：
返回'd'；
案例SYMBOLIC_LINK_TYPE：
返回'l'；
违约：
返回“？”；
}
}

/**
*获取拥有该文件的组的名称。有时这将是组号的字符串表示。
*
*@return拥有文件的组的名称。
*/
公共字符串getGroup（）{
回归组；
}

/**
*获取指向此文件的硬链接数。这不能与符号链接混淆。
*
*@return指向该文件的硬链接数。
*/
public int getHardLinkCount（）{
return hardLinkCount；
}

/**
*如果FTPFile是符号链接，则此方法返回符号链接所指向的文件的名称。
*否则，它将返回{@code null}。
*
*@return符号链接指向的文件（如果FTPFile不是符号链接，则为{@code null}）。
*/
公共字符串getLink（）{
回流环节；
}

/**
*获取文件的名称。
*
*@return文件的名称。
*/
公共字符串getName（）{
返回名称；
}

/**
*获取用于初始化FTPFile的原始FTP服务器原始列表。
*
*@return用于初始化FTPFile的原始FTP服务器原始列表。
*/
公共字符串getRawListing（）{
return rawListing；
}

/**
*获取文件大小（以字节为单位）。
*
*@return文件大小（以字节为单位）。
*/
public long getSize（）{
回报规模；
}

/**
*获取文件时间戳。这通常是最后一次修改时间。
*
*@return表示文件时间戳的Calendar实例。
*/
公共日历getTimestamp（）{
返回日历；
}

/**
*获取文件时间戳。这通常是最后一次修改时间。
*
*@return表示文件时间戳的Calendar实例。
*@自3.9.0起
*/
公共即时getTimestampInstant（）{
return calendar==空？null：日历.toInstant（）；
}

/**
*获取文件的类型（{@code_type}常量之一），例如，如果它是目录、常规文件或符号链接。
*
*@return文件的类型。
*/
public int getType（）{
返回类型；
}

/**
*获取拥有该文件的用户的名称。有时这将是用户编号的字符串表示。
*
*@return拥有文件的用户的名称。
*/
公共字符串getUser（）{
返回用户；
}

/**
*测试给定的访问组（{@code_access}常量之一）是否具有给定的访问权限（{@code _permission}之一
*常量）。
*
*@param access访问组（{@code _access}常量之一）
*@param permission访问权限（{@code_permission}常量之一）
*如果任一参数超出范围，则返回@throws ArrayIndexOutOfBoundsException
*如果{@link#isValid（）}为{@code true}并且设置了相关权限，则返回{@code true}；{@code false}否则。
*/
public boolean hasPermission（final int access，final int permission）{
if（权限==空）{
返回false；
}
返回权限[access][permission]；
}

/**
*测试文件是否为目录。
*
*如果文件类型为{@code DIRECTORY_type}，则返回{@code true}；否则返回{@code false}。
*/
公共布尔值isDirectory（）{
返回类型==DIRECTORY_type；
}

/**
*测试文件是否为常规文件。
*
*如果文件类型为{@code file_type}，则返回{@code true}；否则返回{@code false}。
*/
公共布尔值isFile（）{
返回类型==FILE_type；
}

/**
*测试文件是否为符号链接。
*
*如果文件类型为{@code SYMBOLIC_LINK_type}，则返回{@code true}，否则返回{@code false}。
*/
公共布尔值isSymbolicLink（）{
返回类型==SYMBOLIC_LINK_type；
}

/**
*测试文件的类型是否未知。
*
*如果文件的类型为{@code UNKNOWN_type}，则返回{@code true}；否则返回{@code false}。
*/
公共布尔值isUnknown（）{
返回类型==UNKNOWN_type；
}

/**
*测试条目是否有效。如果条目无效，则只有{@link#getRawListing（）}方法才有用。其他方法可能会失败。
*
*与列表分析结合使用，以保留分析失败的条目。
*
*@请参阅FTPClientConfig#setUnparseableEntries（布尔值）
*@return{@code true}，如果条目有效；{@code false}否则
*@自3.4起
*/
公共布尔值isValid（）{
返回权限！=无效的；
}

private String permissionToString（最终int访问）{
final StringBuilder sb=新StringBuilder（）；
if（hasPermission（访问，READ_PERMISSION））{
某人附加（‘r’）；
}其他{
某人追加（“-”）；
}
if（hasPermission（access，WRITE_PERMISSION））{
某人追加（“w”）；
}其他{
某人追加（“-”）；
}
if（hasPermission（access，EXECUTE_PERMISSION））{
某人追加（'x'）；
}其他{
某人附加（'-）；
}
将某人返回字符串（）；
}

private void readObject（中的最终java.io.ObjectInputStream）{
抛出新的UnsupportedOperationException（“不支持序列化”）；
}

/**
*设置拥有文件的组的名称。这可能是组号的字符串表示。
*
*@param group拥有文件的组的名称。
*/
public void setGroup（最终的String组）{
this.group=组；
}

/**
*设置指向此文件的硬链接数。这不能与符号链接混淆。
*
*@param links指向此文件的硬链接数。
*/
public void setHardLinkCount（最终int链接）{
this.hardLinkCount=链接；
}

/**
*如果FTPFile是符号链接，请使用此方法设置符号链接指向的文件的名称。
*
*@param link符号链接指向的文件。
*/
public void setLink（最终字符串链接）{
this.link=链接；
}

/**
*设置文件的名称。
*
*@param name文件的名称。
*/
public void setName（最终字符串名称）{
this.name=名称；
}

/**
*设置给定的访问组（{@code_access}常量之一）是否具有给定的访问权限（{@code _permission}之一
*常量）。
*
*@param access访问组（{@code _access}常量之一）
*@param permission访问权限（{@code_permission}常量之一）
*@param value{@code true}如果允许权限，{@code false}如果不允许。
*如果任一参数超出范围，则返回@throws ArrayIndexOutOfBoundsException
*/
public void setPermission（final int access，final int permission，final boolean value）{
//TODO:仅在文件有效时允许权限设置
permissions[access][permission]=值；
}

/**
*设置创建FTPFile的原始FTP服务器原始列表。
*
*@param rawListing原始FTP服务器列表。
*/
public void setRawListing（最终字符串rawListing）{
this.rawListing=rawListing；
}

/**
*以字节为单位设置文件大小。
*
*@param size文件大小（以字节为单位）。
*/
public void setSize（最终长尺寸）{
this.size=大小；
}

/**
*设置文件时间戳。这通常是最后一次修改时间。参数未被克隆，因此在调用此方法后不要更改其值。
*
*@param date表示文件时间戳的Calendar实例。
*/
public void setTimestamp（最终日历日期）{
this.calendar=日期；
}

/**
*设置文件的类型（{@code DIRECTORY_type}、{@code file_type{等）。
*
*@param type表示文件类型的整数代码。
*/
public void setType（final int类型）{
this.type=类型；
}

/**
*设置拥有文件的用户的名称。这可能是用户编号的字符串表示；
*
*@param user拥有文件的用户的名称。
*/
public void setUser（最终的String用户）{
this.user=用户；
}

/**
*获取FTPFile信息的字符串表示形式。这目前模仿Unix列表格式。此方法使用日历的时区
*条目，它是服务器时区（如果提供了），否则是本地时区。
*<p>
*注意：如果实例无效｛@link#isValid（）｝，则无法返回任何有用的信息。在这种情况下，请改用{@link#getRawListing（）}。
*</p>
*
*@return FTPFile信息的字符串表示。
*@自3.0起
*/
公共字符串toFormattedString（）{
返回FormattedString（空）；
}

/**
*获取FTPFile信息的字符串表示形式。这目前模仿Unix列表格式。此方法允许日历时区
*被覆盖。
*<p>
*注意：如果实例无效{@link#isValid（）}，则无法返回任何有用信息。在这种情况下，请改用{@link#getRawListing（）}。
*</p>
*
*@param timezone用于显示时间戳的时区如果{@code null}，则使用日历（{@link#getTimestamp（）}）条目
*@return FTPFile信息的字符串表示。
*@自3.4起
*/
public String to FormattedString（最终的String时区）{

if（！isValid（））{
return“[无效：无法解析文件条目]”；
}
final StringBuilder sb=新StringBuilders（）；
try（最终格式化程序fmt=新格式化程序（sb））{
sb.append（formatType（））；
sb.append（permissionToString（USER_ACCESS））；
sb.append（permissionToString（GROUP_ACCESS））；
sb.append（permissionToString（WORLD_ACCESS））；
fmt.format（“%4d”，Integer.valueOf（getHardLinkCount（）））；
fmt.format（“%-8s%-8s”，getUser（），getGroup（））；
fmt.format（“%8d”，Long.valueOf（getSize（）））；
日历时间戳=getTimestamp（）；
if（时间戳！=空）{
if（时区！=空）{
final TimeZone newZone=TimeZone.getTimeZone（时区）；
if（！newZone.equals（timestamp.getTimeZone（）））{
最终原始日期=timestamp.getTime（）；
final Calendar newStamp=Calendar.getInstance（newZone）；
newStamp.setTime（原始）；
timestamp=newStamp；
}
}
fmt.format（“%1$tY-%1$tm-%1$td”，时间戳）；
//仅显示时间单位（如果存在）
if（timestamp.isSet（Calendar.HOUR_OF_DAY））{
fmt.format（“%1$tH”，时间戳）；
if（timestamp.isSet（Calendar.MINUTE））{
fmt.format（“：%1$tM”，时间戳）；
if（timestamp.isSet（Calendar.SECOND））{
fmt.format（“：%1$tS”，时间戳）；
if（timestamp.isSet（Calendar.MILLISECOND））{
fmt.format（“.%1$tL”，时间戳）；
}
}
}
fmt.format（“%1$tZ”，时间戳）；
}
}
某人追加（“”）；
sb.append（getName（））；
}
将某人返回字符串（）；
}

/*
*此类不需要序列化。拒绝尝试这样做，直到可以删除Serializable属性。
*/

/**
*获取FTPFile信息的字符串表示形式。
*委托到{@link#getRawListing（）}
*
*@参见#getRawListing（）
*@return FTPFile信息的字符串表示。
*/
@覆盖
公共字符串toString（）{
return getRawListing（）；
}

private void writeObject（最终java.io.ObjectOutputStream输出）{
抛出新的UnsupportedOperationException（“不支持序列化”）；
}

}