| /* |
| * Licensed to the Apache Software Foundation (ASF) under one or more |
| * contributor license agreements. See the NOTICE file distributed with |
| * this work for additional information regarding copyright ownership. |
| * The ASF licenses this file to You under the Apache License, Version 2.0 |
| * (the "License"); you may not use this file except in compliance with |
| * the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| package org.apache.commons.net.ftp; |
| import java.io.Serializable; |
| import java.util.Calendar; |
| import java.util.Date; |
| import java.util.Formatter; |
| import java.util.TimeZone; |
| |
| /*** |
| * The FTPFile class is used to represent information about files stored |
| * on an FTP server. |
| * |
| * @see FTPFileEntryParser |
| * @see FTPClient#listFiles |
| ***/ |
| |
| public class FTPFile implements Serializable |
| { |
| private static final long serialVersionUID = 9010790363003271996L; |
| |
| /** A constant indicating an FTPFile is a file. ***/ |
| public static final int FILE_TYPE = 0; |
| /** A constant indicating an FTPFile is a directory. ***/ |
| public static final int DIRECTORY_TYPE = 1; |
| /** A constant indicating an FTPFile is a symbolic link. ***/ |
| public static final int SYMBOLIC_LINK_TYPE = 2; |
| /** A constant indicating an FTPFile is of unknown type. ***/ |
| public static final int UNKNOWN_TYPE = 3; |
| |
| /** A constant indicating user access permissions. ***/ |
| public static final int USER_ACCESS = 0; |
| /** A constant indicating group access permissions. ***/ |
| public static final int GROUP_ACCESS = 1; |
| /** A constant indicating world access permissions. ***/ |
| public static final int WORLD_ACCESS = 2; |
| |
| /** A constant indicating file/directory read permission. ***/ |
| public static final int READ_PERMISSION = 0; |
| /** A constant indicating file/directory write permission. ***/ |
| public static final int WRITE_PERMISSION = 1; |
| /** |
| * A constant indicating file execute permission or directory listing |
| * permission. |
| ***/ |
| public static final int EXECUTE_PERMISSION = 2; |
| |
| private int type, hardLinkCount; |
| private long size; |
| private String rawListing, user, group, name, link; |
| private Calendar date; |
| // If this is null, then list entry parsing failed |
| private final boolean[] permissions[]; // e.g. _permissions[USER_ACCESS][READ_PERMISSION] |
| |
| /*** Creates an empty FTPFile. ***/ |
| public FTPFile() |
| { |
| permissions = new boolean[3][3]; |
| type = UNKNOWN_TYPE; |
| // init these to values that do not occur in listings |
| // so can distinguish which fields are unset |
| hardLinkCount = 0; // 0 is invalid as a link count |
| size = -1; // 0 is valid, so use -1 |
| user = ""; |
| group = ""; |
| date = null; |
| name = null; |
| } |
| |
| /** |
| * Constructor for use by {@link FTPListParseEngine} only. |
| * Used to create FTPFile entries for failed parses |
| * @param rawListing line that could not be parsed. |
| * @since 3.4 |
| */ |
| FTPFile(final String rawListing) |
| { |
| this.permissions = null; // flag that entry is invalid |
| this.rawListing = rawListing; |
| this.type = UNKNOWN_TYPE; |
| // init these to values that do not occur in listings |
| // so can distinguish which fields are unset |
| this.hardLinkCount = 0; // 0 is invalid as a link count |
| this.size = -1; // 0 is valid, so use -1 |
| this.user = ""; |
| this.group = ""; |
| this.date = null; |
| this.name = null; |
| } |
| |
| |
| /*** |
| * Set the original FTP server raw listing from which the FTPFile was |
| * created. |
| * |
| * @param rawListing The raw FTP server listing. |
| ***/ |
| public void setRawListing(final String rawListing) |
| { |
| this.rawListing = rawListing; |
| } |
| |
| /*** |
| * Get the original FTP server raw listing used to initialize the FTPFile. |
| * |
| * @return The original FTP server raw listing used to initialize the |
| * FTPFile. |
| ***/ |
| public String getRawListing() |
| { |
| return rawListing; |
| } |
| |
| |
| /*** |
| * Determine if the file is a directory. |
| * |
| * @return True if the file is of type <code>DIRECTORY_TYPE</code>, false if |
| * not. |
| ***/ |
| public boolean isDirectory() |
| { |
| return type == DIRECTORY_TYPE; |
| } |
| |
| /*** |
| * Determine if the file is a regular file. |
| * |
| * @return True if the file is of type <code>FILE_TYPE</code>, false if |
| * not. |
| ***/ |
| public boolean isFile() |
| { |
| return type == FILE_TYPE; |
| } |
| |
| /*** |
| * Determine if the file is a symbolic link. |
| * |
| * @return True if the file is of type <code>UNKNOWN_TYPE</code>, false if |
| * not. |
| ***/ |
| public boolean isSymbolicLink() |
| { |
| return type == SYMBOLIC_LINK_TYPE; |
| } |
| |
| /*** |
| * Determine if the type of the file is unknown. |
| * |
| * @return True if the file is of type <code>UNKNOWN_TYPE</code>, false if |
| * not. |
| ***/ |
| public boolean isUnknown() |
| { |
| return type == UNKNOWN_TYPE; |
| } |
| |
| /** |
| * Used to indicate whether an entry is valid or not. |
| * If the entry is invalid, only the {@link #getRawListing()} method will be useful. |
| * Other methods may fail. |
| * |
| * Used in conjunction with list parsing that preseverves entries that failed to parse. |
| * @see FTPClientConfig#setUnparseableEntries(boolean) |
| * @return true if the entry is valid |
| * @since 3.4 |
| */ |
| public boolean isValid() { |
| return permissions != null; |
| } |
| |
| /*** |
| * Set the type of the file (<code>DIRECTORY_TYPE</code>, |
| * <code>FILE_TYPE</code>, etc.). |
| * |
| * @param type The integer code representing the type of the file. |
| ***/ |
| public void setType(final int type) |
| { |
| this.type = type; |
| } |
| |
| |
| /*** |
| * Return the type of the file (one of the <code>_TYPE</code> constants), |
| * e.g., if it is a directory, a regular file, or a symbolic link. |
| * |
| * @return The type of the file. |
| ***/ |
| public int getType() |
| { |
| return type; |
| } |
| |
| |
| /*** |
| * Set the name of the file. |
| * |
| * @param name The name of the file. |
| ***/ |
| public void setName(final String name) |
| { |
| this.name = name; |
| } |
| |
| /*** |
| * Return the name of the file. |
| * |
| * @return The name of the file. |
| ***/ |
| public String getName() |
| { |
| return name; |
| } |
| |
| |
| /** |
| * Set the file size in bytes. |
| * @param size The file size in bytes. |
| */ |
| public void setSize(final long size) |
| { |
| this.size = size; |
| } |
| |
| |
| /*** |
| * Return the file size in bytes. |
| * |
| * @return The file size in bytes. |
| ***/ |
| public long getSize() |
| { |
| return size; |
| } |
| |
| |
| /*** |
| * Set the number of hard links to this file. This is not to be |
| * confused with symbolic links. |
| * |
| * @param links The number of hard links to this file. |
| ***/ |
| public void setHardLinkCount(final int links) |
| { |
| this.hardLinkCount = links; |
| } |
| |
| |
| /*** |
| * Return the number of hard links to this file. This is not to be |
| * confused with symbolic links. |
| * |
| * @return The number of hard links to this file. |
| ***/ |
| public int getHardLinkCount() |
| { |
| return hardLinkCount; |
| } |
| |
| |
| /*** |
| * Set the name of the group owning the file. This may be |
| * a string representation of the group number. |
| * |
| * @param group The name of the group owning the file. |
| ***/ |
| public void setGroup(final String group) |
| { |
| this.group = group; |
| } |
| |
| |
| /*** |
| * Returns the name of the group owning the file. Sometimes this will be |
| * a string representation of the group number. |
| * |
| * @return The name of the group owning the file. |
| ***/ |
| public String getGroup() |
| { |
| return group; |
| } |
| |
| |
| /*** |
| * Set the name of the user owning the file. This may be |
| * a string representation of the user number; |
| * |
| * @param user The name of the user owning the file. |
| ***/ |
| public void setUser(final String user) |
| { |
| this.user = user; |
| } |
| |
| /*** |
| * Returns the name of the user owning the file. Sometimes this will be |
| * a string representation of the user number. |
| * |
| * @return The name of the user owning the file. |
| ***/ |
| public String getUser() |
| { |
| return user; |
| } |
| |
| |
| /*** |
| * If the FTPFile is a symbolic link, use this method to set the name of the |
| * file being pointed to by the symbolic link. |
| * |
| * @param link The file pointed to by the symbolic link. |
| ***/ |
| public void setLink(final String link) |
| { |
| this.link = link; |
| } |
| |
| |
| /*** |
| * If the FTPFile is a symbolic link, this method returns the name of the |
| * file being pointed to by the symbolic link. Otherwise it returns null. |
| * |
| * @return The file pointed to by the symbolic link (null if the FTPFile |
| * is not a symbolic link). |
| ***/ |
| public String getLink() |
| { |
| return link; |
| } |
| |
| |
| /*** |
| * Set the file timestamp. This usually the last modification time. |
| * The parameter is not cloned, so do not alter its value after calling |
| * this method. |
| * |
| * @param date A Calendar instance representing the file timestamp. |
| ***/ |
| public void setTimestamp(final Calendar date) |
| { |
| this.date = date; |
| } |
| |
| |
| /*** |
| * Returns the file timestamp. This usually the last modification time. |
| * |
| * @return A Calendar instance representing the file timestamp. |
| ***/ |
| public Calendar getTimestamp() |
| { |
| return date; |
| } |
| |
| |
| /*** |
| * Set if the given access group (one of the <code> _ACCESS </code> |
| * constants) has the given access permission (one of the |
| * <code> _PERMISSION </code> constants) to the file. |
| * |
| * @param access The access group (one of the <code> _ACCESS </code> |
| * constants) |
| * @param permission The access permission (one of the |
| * <code> _PERMISSION </code> constants) |
| * @param value True if permission is allowed, false if not. |
| * @throws ArrayIndexOutOfBoundsException if either of the parameters is out of range |
| ***/ |
| public void setPermission(final int access, final int permission, final boolean value) |
| { |
| permissions[access][permission] = value; |
| } |
| |
| |
| /*** |
| * Determines if the given access group (one of the <code> _ACCESS </code> |
| * constants) has the given access permission (one of the |
| * <code> _PERMISSION </code> constants) to the file. |
| * |
| * @param access The access group (one of the <code> _ACCESS </code> |
| * constants) |
| * @param permission The access permission (one of the |
| * <code> _PERMISSION </code> constants) |
| * @throws ArrayIndexOutOfBoundsException if either of the parameters is out of range |
| * @return true if {@link #isValid()} is {@code true &&} the associated permission is set; |
| * {@code false} otherwise. |
| ***/ |
| public boolean hasPermission(final int access, final int permission) |
| { |
| if (permissions == null) { |
| return false; |
| } |
| return permissions[access][permission]; |
| } |
| |
| /*** |
| * Returns a string representation of the FTPFile information. |
| * |
| * @return A string representation of the FTPFile information. |
| */ |
| @Override |
| public String toString() |
| { |
| return getRawListing(); |
| } |
| |
| /*** |
| * Returns a string representation of the FTPFile information. |
| * This currently mimics the Unix listing format. |
| * This method uses the timezone of the Calendar entry, which is |
| * the server time zone (if one was provided) otherwise it is |
| * the local time zone. |
| * <p> |
| * Note: if the instance is not valid {@link #isValid()}, no useful |
| * information can be returned. In this case, use {@link #getRawListing()} |
| * instead. |
| * |
| * @return A string representation of the FTPFile information. |
| * @since 3.0 |
| */ |
| public String toFormattedString() |
| { |
| return toFormattedString(null); |
| } |
| |
| /** |
| * Returns a string representation of the FTPFile information. |
| * This currently mimics the Unix listing format. |
| * This method allows the Calendar time zone to be overridden. |
| * <p> |
| * Note: if the instance is not valid {@link #isValid()}, no useful |
| * information can be returned. In this case, use {@link #getRawListing()} |
| * instead. |
| * @param timezone the timezone to use for displaying the time stamp |
| * If {@code null}, then use the Calendar entry timezone |
| * @return A string representation of the FTPFile information. |
| * @since 3.4 |
| */ |
| public String toFormattedString(final String timezone) |
| { |
| |
| if (!isValid()) { |
| return "[Invalid: could not parse file entry]"; |
| } |
| final StringBuilder sb = new StringBuilder(); |
| try (final Formatter fmt = new Formatter(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())); |
| Calendar timestamp = getTimestamp(); |
| if (timestamp != null) { |
| if (timezone != null) { |
| final TimeZone newZone = TimeZone.getTimeZone(timezone); |
| if (!newZone.equals(timestamp.getTimeZone())) { |
| final Date original = timestamp.getTime(); |
| final Calendar newStamp = Calendar.getInstance(newZone); |
| newStamp.setTime(original); |
| timestamp = newStamp; |
| } |
| } |
| fmt.format(" %1$tY-%1$tm-%1$td", timestamp); |
| // Only display time units if they are present |
| if (timestamp.isSet(Calendar.HOUR_OF_DAY)) { |
| fmt.format(" %1$tH", timestamp); |
| if (timestamp.isSet(Calendar.MINUTE)) { |
| fmt.format(":%1$tM", timestamp); |
| if (timestamp.isSet(Calendar.SECOND)) { |
| fmt.format(":%1$tS", timestamp); |
| if (timestamp.isSet(Calendar.MILLISECOND)) { |
| fmt.format(".%1$tL", timestamp); |
| } |
| } |
| } |
| fmt.format(" %1$tZ", timestamp); |
| } |
| } |
| sb.append(' '); |
| sb.append(getName()); |
| } |
| return sb.toString(); |
| } |
| |
| private char formatType(){ |
| switch(type) { |
| case FILE_TYPE: |
| return '-'; |
| case DIRECTORY_TYPE: |
| return 'd'; |
| case SYMBOLIC_LINK_TYPE: |
| return 'l'; |
| default: |
| return '?'; |
| } |
| } |
| |
| private String permissionToString(final int access ){ |
| final StringBuilder sb = new StringBuilder(); |
| if (hasPermission(access, READ_PERMISSION)) { |
| sb.append('r'); |
| } else { |
| sb.append('-'); |
| } |
| if (hasPermission(access, WRITE_PERMISSION)) { |
| sb.append('w'); |
| } else { |
| sb.append('-'); |
| } |
| if (hasPermission(access, EXECUTE_PERMISSION)) { |
| sb.append('x'); |
| } else { |
| sb.append('-'); |
| } |
| return sb.toString(); |
| } |
| } |