| commit | author | age | ||
| 5bfd34 | 1 | /* |
| U | 2 | Dateiverwaltung - File management in your browser |
| 3 | Copyright (C) 2017 Ulrich Hilger, http://uhilger.de | |
| 4 | ||
| 5 | This program is free software: you can redistribute it and/or modify | |
| 6 | it under the terms of the GNU Affero General Public License as | |
| 7 | published by the Free Software Foundation, either version 3 of the | |
| 8 | License, or (at your option) any later version. | |
| 9 | ||
| 10 | This program is distributed in the hope that it will be useful, | |
| 11 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
| 12 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
| 13 | GNU Affero General Public License for more details. | |
| 14 | ||
| 15 | You should have received a copy of the GNU Affero General Public License | |
| 16 | along with this program. If not, see <http://www.gnu.org/licenses/>. | |
| 17 | */ | |
| 18 | ||
| 19 | package de.uhilger.filecms.data; | |
| 20 | ||
| 21 | import java.io.Serializable; | |
| 22 | ||
| 23 | /** | |
| 24 | * A reference to a file consisting of the file's absolute path and additional | |
| 25 | * information about whether or not the referenced file is a directory, is hidden, etc. | |
| 26 | * Note that FileRef only references a file, the file itself and its contents are not | |
| 27 | * modelled by this class. | |
| 28 | * | |
| 29 | * @author Ulrich Hilger, http://uhilger.de | |
| 30 | * @author Bereitgestellt unter den Bedingungen der | |
| 31 | * <a href="http://www.gnu.org/licenses/agpl-3.0" target="_blank">GNU Affero | |
| 32 | * General Public License</a> | |
| 33 | * | |
| 34 | * @version 2, 12.01.2008 | |
| 35 | */ | |
| 36 | public class FileRef implements Serializable { | |
| 37 | ||
| 38 | public static final long serialVersionUID = 42L; | |
| 39 | private String absolutePath; | |
| 40 | private Boolean isDirectory; | |
| 41 | private Boolean isHidden; | |
| 42 | private Long lastModified; | |
| 43 | private Long length; | |
| 44 | ||
| 45 | /** | |
| 46 | * create a new instance of <code>FileRef</code>. Note that the created FileRef is | |
| 47 | * only a reference to a file, the file itself will not be created. | |
| 48 | * | |
| 49 | * @param absolutePath the absolute path that denotes this instance of <code>FileRef</code> | |
| 50 | * @param isDirectory whether or not this file is a directory | |
| 51 | * @param isHidden whether or not this file is a hidden file | |
| 52 | * @param lastModified the date/time this file was last modified measured in milliseconds | |
| 53 | * since the epoch (00:00:00 GMT, January 1, 1970) | |
| 54 | * @param length the length of this file in bytes | |
| 55 | */ | |
| 56 | public FileRef(String absolutePath, boolean isDirectory, boolean isHidden, | |
| 57 | long lastModified, long length) | |
| 58 | { | |
| 59 | super(); | |
| 60 | this.absolutePath = absolutePath; | |
| 61 | this.isDirectory = isDirectory; | |
| 62 | this.isHidden = isHidden; | |
| 63 | this.lastModified = lastModified; | |
| 64 | this.length = length; | |
| 65 | } | |
| 66 | ||
| 67 | /** | |
| 68 | * Create a new instance of class <code>FileRef</code> with a given absolute path. | |
| 69 | * Other characteristics of the file are created with default settings | |
| 70 | * (i.e. not a directory, not hidden, unknown modification date | |
| 71 | * and length). Note that the created FileRef is only a reference to a file, the file | |
| 72 | * itself will not be created. | |
| 73 | * | |
| 74 | * @param absolutePath the absolute path that denotes this instance | |
| 75 | * of <code>FileRef</code> | |
| 76 | */ | |
| 77 | public FileRef(String absolutePath) { | |
| 78 | this(absolutePath, false, false, 0, 0); | |
| 79 | } | |
| 80 | ||
| 81 | /** | |
| 82 | * Create a new instance of class <code>FileRef</code> with a given absolute path | |
| 83 | * and an indicator whether or not the new FileRef denotes a directory. | |
| 84 | * Other characteristics of the file are created with default settings | |
| 85 | * (i.e. not hidden, unknown modification date and length). Note that the created | |
| 86 | * FileRef is only a reference to a file, the file itself will not be created. | |
| 87 | * | |
| 88 | * @param absolutePath the absolute path that denotes this instance | |
| 89 | * of <code>FileRef</code> | |
| 90 | * @param isDirectory true, if the file to create should denote a directory | |
| 91 | */ | |
| 92 | public FileRef(String absolutePath, boolean isDirectory) { | |
| 93 | this(absolutePath, isDirectory, false, 0, 0); | |
| 94 | } | |
| 95 | ||
| 96 | /** | |
| 97 | * get the absolute path that denotes this file | |
| 98 | * @return the path | |
| 99 | */ | |
| 100 | public String getAbsolutePath() { | |
| 101 | return absolutePath; | |
| 102 | } | |
| 103 | ||
| 104 | /** | |
| 105 | * Tests whether the file denoted by this abstract pathname is a | |
| 106 | * directory. | |
| 107 | * | |
| 108 | * @return <code>true</code> if this file is a directory, | |
| 109 | * <code>false</code> otherwise | |
| 110 | */ | |
| 111 | public boolean isDirectory() { | |
| 112 | return isDirectory; | |
| 113 | } | |
| 114 | ||
| 115 | /** | |
| 116 | * Tests whether the file denoted by this abstract pathname is a | |
| 117 | * file. | |
| 118 | * | |
| 119 | * @return <code>true</code> if this file is a file, | |
| 120 | * <code>false</code> otherwise | |
| 121 | */ | |
| 122 | public boolean isFile() { | |
| 123 | return !isDirectory; | |
| 124 | } | |
| 125 | ||
| 126 | /** | |
| 127 | * Tests whether the file denoted by this abstract pathname is a | |
| 128 | * hidden file. | |
| 129 | * | |
| 130 | * @return <code>true</code> if this file is a hidden file, | |
| 131 | * <code>false</code> otherwise | |
| 132 | */ | |
| 133 | public boolean isHidden() { | |
| 134 | return isHidden; | |
| 135 | } | |
| 136 | ||
| 137 | /** | |
| 138 | * Returns the time that this file was | |
| 139 | * last modified. | |
| 140 | * | |
| 141 | * @return A <code>long</code> value representing the time the file was | |
| 142 | * last modified, measured in milliseconds since the epoch | |
| 143 | * (00:00:00 GMT, January 1, 1970) | |
| 144 | */ | |
| 145 | public long getLastModified() { | |
| 146 | return lastModified; | |
| 147 | } | |
| 148 | ||
| 149 | /** | |
| 150 | * Returns the length of this file. | |
| 151 | * The return value is unspecified if this file denotes a directory. | |
| 152 | * | |
| 153 | * @return The length, in bytes, of this file | |
| 154 | */ | |
| 155 | public long getLength() { | |
| 156 | return length; | |
| 157 | } | |
| 158 | ||
| 159 | /** | |
| 160 | * get the name of this file without path | |
| 161 | * @param separatorChar the string that is used to separate directories and file names in | |
| 162 | * path expressions | |
| 163 | * @return the name of this file without path | |
| 164 | */ | |
| 165 | public String getName(String separatorChar) { | |
| 166 | String path = getAbsolutePath(); | |
| 167 | String name = path.substring(path.lastIndexOf(separatorChar) + 1); | |
| 168 | if(name == null || name.length() < 1) { | |
| 169 | name = path; | |
| 170 | } | |
| 171 | return name; | |
| 172 | } | |
| 173 | ||
| 174 | /** | |
| 175 | * get a string representation of this instance of FileRef | |
| 176 | * @return the string representation of this FileRef object | |
| 177 | */ | |
| 178 | public String toString() { | |
| 179 | return getAbsolutePath(); | |
| 180 | } | |
| 181 | ||
| 182 | /** | |
| 183 | * Indicates whether some object is equal to this instance of class FileRef. Two | |
| 184 | * GenericFiles are regarded as equal when their absolute paths are equal case independently. | |
| 185 | * | |
| 186 | * @param obj the object to compare with this instance of FileRef | |
| 187 | * @return true, if obj is equal to this instance of FileRef, false if not | |
| 188 | */ | |
| 189 | public boolean equals(Object obj) { | |
| 190 | boolean isEqual = false; | |
| 191 | if(obj != null && obj instanceof FileRef) { | |
| 192 | isEqual = ((FileRef) obj).getAbsolutePath().toLowerCase().equals( | |
| 193 | this.getAbsolutePath().toLowerCase()); | |
| 194 | } | |
| 195 | return isEqual; | |
| 196 | } | |
| 197 | } | |
