src/net/pterodactylus/jsite/project/Project.java

   1 /*
   2  * jSite2 - Project.java -
   3  * Copyright © 2008 David Roden
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation; either version 2 of the License, or
   8  * (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 General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License
  16  * along with this program; if not, write to the Free Software
  17  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  18  */
  19
  20 package net.pterodactylus.jsite.project;
  21
  22 import java.beans.PropertyChangeListener;
  23 import java.io.File;
  24 import java.util.ArrayList;
  25 import java.util.Collections;
  26 import java.util.HashMap;
  27 import java.util.List;
  28 import java.util.Map;
  29
  30 import net.pterodactylus.util.beans.AbstractBean;
  31
  32 /**
  33  * Container for project information. A Project is capable of notifying
  34  * {@link PropertyChangeListener}s if any of the contained properties change.
  35  *
  36  * @author David ‘Bombe’ Roden &lt;bombe@freenetproject.org&gt;
  37  */
  38 public class Project extends AbstractBean {
  39
  40         /** Name of the “name” property. */
  41         public static final String PROPERTY_NAME = "name";
  42
  43         /** Name of the “description” property. */
  44         public static final String PROPERTY_DESCRIPTION = "description";
  45
  46         /** Name of the “public key” property. */
  47         public static final String PROPERTY_PUBLIC_KEY = "publicKey";
  48
  49         /** Name of the “private key” property. */
  50         public static final String PROPERTY_PRIVATE_KEY = "privateKey";
  51
  52         /** Name of the “base path” property. */
  53         public static final String PROPERTY_BASE_PATH = "basePath";
  54
  55         /** Name of the “default file” property. */
  56         public static final String PROPERTY_DEFAULT_FILE = "defaultFile";
  57
  58         /** Internal ID. */
  59         private String id;
  60
  61         /** The name of the project. */
  62         private String name;
  63
  64         /** The description of the project. */
  65         private String description;
  66
  67         /** The public key. */
  68         private String publicKey;
  69
  70         /** The private key. */
  71         private String privateKey;
  72
  73         /** The base path of the project. */
  74         private String basePath;
  75
  76         /** The default file. */
  77         private String defaultFile;
  78
  79         /** The overrides. */
  80         private final Map<String, FileOverride> fileOverrides = new HashMap<String, FileOverride>();
  81
  82         /** The current root project file. */
  83         private ProjectFileImpl rootProjectFile;
  84
  85         /**
  86          * Creates a new project.
  87          */
  88         public Project() {
  89                 /* do nothing. */
  90         }
  91
  92         /**
  93          * Clones the given project.
  94          *
  95          * @param project
  96          */
  97         Project(Project project) {
  98                 this.name = project.name;
  99                 this.description = project.description;
 100                 this.publicKey = project.publicKey;
 101                 this.privateKey = project.privateKey;
 102                 this.basePath = project.basePath;
 103         }
 104
 105         /**
 106          * Returns the internal ID.
 107          *
 108          * @return The internal ID
 109          */
 110         String getId() {
 111                 return id;
 112         }
 113
 114         /**
 115          * Sets the internal ID.
 116          *
 117          * @param id
 118          *            The internal ID
 119          */
 120         void setId(String id) {
 121                 this.id = id;
 122         }
 123
 124         /**
 125          * Returns the name of the project.
 126          *
 127          * @return The name of the project
 128          */
 129         public String getName() {
 130                 return name;
 131         }
 132
 133         /**
 134          * Sets the name of the project.
 135          *
 136          * @param name
 137          *            The name of the project
 138          */
 139         public void setName(String name) {
 140                 String oldName = this.name;
 141                 this.name = name;
 142                 fireIfPropertyChanged(PROPERTY_NAME, oldName, name);
 143         }
 144
 145         /**
 146          * Returns the description of the project.
 147          *
 148          * @return The description of the project
 149          */
 150         public String getDescription() {
 151                 return description;
 152         }
 153
 154         /**
 155          * Sets the description of the project
 156          *
 157          * @param description
 158          *            The description of the project
 159          */
 160         public void setDescription(String description) {
 161                 String oldDescription = this.description;
 162                 this.description = description;
 163                 fireIfPropertyChanged(PROPERTY_DESCRIPTION, oldDescription, description);
 164         }
 165
 166         /**
 167          * Returns the public key of the project.
 168          *
 169          * @return The public key of the project
 170          */
 171         public String getPublicKey() {
 172                 return publicKey;
 173         }
 174
 175         /**
 176          * Sets the public key of the project.
 177          *
 178          * @param publicKey
 179          *            The public key of the project
 180          */
 181         void setPublicKey(String publicKey) {
 182                 String oldPublicKey = this.publicKey;
 183                 this.publicKey = publicKey;
 184                 fireIfPropertyChanged(PROPERTY_PUBLIC_KEY, oldPublicKey, publicKey);
 185         }
 186
 187         /**
 188          * Returns the private key of the project.
 189          *
 190          * @return The private key of the project
 191          */
 192         public String getPrivateKey() {
 193                 return privateKey;
 194         }
 195
 196         /**
 197          * Sets the private key of the project.
 198          *
 199          * @param privateKey
 200          *            The private key of the project
 201          */
 202         void setPrivateKey(String privateKey) {
 203                 String oldPrivateKey = this.privateKey;
 204                 this.privateKey = privateKey;
 205                 fireIfPropertyChanged(PROPERTY_PRIVATE_KEY, oldPrivateKey, privateKey);
 206         }
 207
 208         /**
 209          * Returns the base path of the project.
 210          *
 211          * @return The base path of the project
 212          */
 213         public String getBasePath() {
 214                 return basePath;
 215         }
 216
 217         /**
 218          * Sets the base path of the project.
 219          *
 220          * @param basePath
 221          *            The base path of the project
 222          */
 223         public void setBasePath(String basePath) {
 224                 String oldBasePath = this.basePath;
 225                 this.basePath = basePath;
 226                 fireIfPropertyChanged(PROPERTY_BASE_PATH, oldBasePath, basePath);
 227         }
 228
 229         /**
 230          * Returns the default file.
 231          *
 232          * @return The default file
 233          */
 234         public String getDefaultFile() {
 235                 return defaultFile;
 236         }
 237
 238         /**
 239          * Sets the default file.
 240          *
 241          * @param defaultFile
 242          *            The default file
 243          */
 244         public void setDefaultFile(String defaultFile) {
 245                 String oldDefaultFile = this.defaultFile;
 246                 this.defaultFile = defaultFile;
 247                 fireIfPropertyChanged(PROPERTY_DEFAULT_FILE, oldDefaultFile, defaultFile);
 248         }
 249
 250         /**
 251          * Adds a file override for the given file.
 252          *
 253          * @param filePath
 254          *            The file path
 255          * @param override
 256          *            The override for the file
 257          */
 258         public void addFileOverride(String filePath, FileOverride override) {
 259                 fileOverrides.put(filePath, override);
 260         }
 261
 262         /**
 263          * Removes the file override for the given file.
 264          *
 265          * @param filePath
 266          *            The file path for which to remove the override
 267          */
 268         public void removeFileOverride(String filePath) {
 269                 fileOverrides.remove(filePath);
 270         }
 271
 272         /**
 273          * Returns the list of {@link FileOverride}s.
 274          *
 275          * @return All file overrides
 276          */
 277         public Map<String, FileOverride> getFileOverrides() {
 278                 return fileOverrides;
 279         }
 280
 281         /**
 282          * Scans the base path for files and returns the {@link ProjectFile} for the
 283          * base path. From this file it is possible to reach all files in the base
 284          * path. This method is disk-intensive and may take some time on larger
 285          * directories!
 286          *
 287          * @return The file for the base path, or <code>null</code> if the base
 288          *         path does not denote an existing directory
 289          */
 290         public ProjectFile getBaseFile() {
 291                 File basePathFile = new File(basePath);
 292                 if (!basePathFile.exists() || !basePathFile.isDirectory()) {
 293                         return null;
 294                 }
 295                 rootProjectFile = new ProjectFileImpl(null, "", 0, true, false);
 296                 scanDirectory(basePathFile, rootProjectFile);
 297                 return rootProjectFile;
 298         }
 299
 300         /**
 301          * Returns the file that is specified by its complete path.
 302          *
 303          * @param completePath
 304          *            The complete path of the file
 305          * @return The project file at the given path, or <code>null</code> if
 306          *         there is no such file
 307          */
 308         public ProjectFile getFile(String completePath) {
 309                 if (rootProjectFile == null) {
 310                         getBaseFile();
 311                 }
 312                 if ((rootProjectFile == null) || (completePath.length() == 0)) {
 313                         return rootProjectFile;
 314                 }
 315                 String[] pathParts = completePath.split("\\" + File.separator);
 316                 ProjectFileImpl currentProjectFile = rootProjectFile;
 317                 for (String pathPart: pathParts) {
 318                         currentProjectFile = currentProjectFile.getFile(pathPart);
 319                         if (currentProjectFile == null) {
 320                                 return null;
 321                         }
 322                 }
 323                 return currentProjectFile;
 324         }
 325
 326         //
 327         // PRIVATE METHODS
 328         //
 329
 330         /**
 331          * Scans the given directory and recreates the file and directory structure
 332          * in the given project file.
 333          *
 334          * @param directory
 335          *            The directory to scan
 336          * @param projectFile
 337          *            The project file in which to recreate the directory and file
 338          *            structure
 339          */
 340         private void scanDirectory(File directory, ProjectFileImpl projectFile) {
 341                 if (!directory.isDirectory()) {
 342                         return;
 343                 }
 344                 for (File file: directory.listFiles()) {
 345                         ProjectFileImpl projectFileChild = projectFile.addFile(file.getName(), file.length(), file.isDirectory(), file.isHidden());
 346                         if (file.isDirectory()) {
 347                                 scanDirectory(file, projectFileChild);
 348                         }
 349                 }
 350                 projectFile.sort();
 351         }
 352
 353         /**
 354          * Implementation of a {@link ProjectFile}.
 355          *
 356          * @author David ‘Bombe’ Roden &lt;bombe@freenetproject.org&gt;
 357          */
 358         private static class ProjectFileImpl implements ProjectFile, Comparable<ProjectFileImpl> {
 359
 360                 /** The parent of this project file. */
 361                 private final ProjectFileImpl parentProjectFile;
 362
 363                 /** The name of this project file. */
 364                 private final String name;
 365
 366                 /** The size of the file. */
 367                 private final long size;
 368
 369                 /** Whether this project file is a directory. */
 370                 private final boolean directory;
 371
 372                 /** Whether this file is hidden. */
 373                 private final boolean hidden;
 374
 375                 /** This project file’s children. */
 376                 private List<ProjectFileImpl> childProjectFiles = new ArrayList<ProjectFileImpl>();
 377
 378                 /**
 379                  * Creates a new project fie.
 380                  *
 381                  * @param parentProjectFile
 382                  *            The parent of the project file, or <code>null</code> if
 383                  *            the new project file does not have a parent
 384                  * @param name
 385                  *            The name of the project file
 386                  * @param size
 387                  *            The size of the file
 388                  * @param isDirectory
 389                  *            <code>true</code> if this project file is a directory,
 390                  *            <code>false</code> otherwise
 391                  * @param isHidden
 392                  *            <code>true</code> if this project file is hidden,
 393                  *            <code>false</code> otherwise
 394                  */
 395                 ProjectFileImpl(ProjectFileImpl parentProjectFile, String name, long size, boolean isDirectory, boolean isHidden) {
 396                         this.parentProjectFile = parentProjectFile;
 397                         this.name = name;
 398                         this.size = size;
 399                         this.directory = isDirectory;
 400                         this.hidden = isHidden;
 401                 }
 402
 403                 //
 404                 // INTERFACE ProjectFile
 405                 //
 406
 407                 /**
 408                  * @see net.pterodactylus.jsite.project.ProjectFile#getName()
 409                  */
 410                 public String getName() {
 411                         return name;
 412                 }
 413
 414                 /**
 415                  * @see net.pterodactylus.jsite.project.ProjectFile#getParent()
 416                  */
 417                 public ProjectFile getParent() {
 418                         return parentProjectFile;
 419                 }
 420
 421                 /**
 422                  * {@inheritDoc}
 423                  */
 424                 public long getSize() {
 425                         return size;
 426                 }
 427
 428                 /**
 429                  * @see net.pterodactylus.jsite.project.ProjectFile#getParents()
 430                  */
 431                 public List<ProjectFile> getParents() {
 432                         List<ProjectFile> parentProjectFiles = new ArrayList<ProjectFile>();
 433                         ProjectFileImpl currentProjectFile = this;
 434                         do {
 435                                 parentProjectFiles.add(0, currentProjectFile);
 436                         } while ((currentProjectFile = currentProjectFile.parentProjectFile) != null);
 437                         return parentProjectFiles;
 438                 }
 439
 440                 /**
 441                  * {@inheritDoc}
 442                  */
 443                 /* TODO - caching? */
 444                 public String getCompletePath() {
 445                         StringBuilder completePath = new StringBuilder();
 446                         ProjectFileImpl currentProjectFile = this;
 447                         while ((currentProjectFile != null) && (currentProjectFile.parentProjectFile != null)) {
 448                                 completePath.insert(0, currentProjectFile.getName()).insert(0, File.separatorChar);
 449                                 currentProjectFile = currentProjectFile.parentProjectFile;
 450                         }
 451                         return (completePath.length() > 0) ? completePath.substring(1) : "";
 452                 }
 453
 454                 /**
 455                  * @see net.pterodactylus.jsite.project.ProjectFile#isFile()
 456                  */
 457                 public boolean isFile() {
 458                         return !directory;
 459                 }
 460
 461                 /**
 462                  * @see net.pterodactylus.jsite.project.ProjectFile#isDirectory()
 463                  */
 464                 public boolean isDirectory() {
 465                         return directory;
 466                 }
 467
 468                 /**
 469                  * @see net.pterodactylus.jsite.project.ProjectFile#isHidden()
 470                  */
 471                 public boolean isHidden() {
 472                         return hidden;
 473                 }
 474
 475                 /**
 476                  * Returns the project file with the given name. The project file has to
 477                  * be a direct child of this project file.
 478                  *
 479                  * @param name
 480                  *            The name of the file to get
 481                  * @return The project file, or <code>null</code> if there is no
 482                  *         project file by that name
 483                  */
 484                 public ProjectFileImpl getFile(String name) {
 485                         if (!isDirectory()) {
 486                                 return null;
 487                         }
 488                         for (ProjectFileImpl projectFile: childProjectFiles) {
 489                                 if (projectFile.getName().equals(name)) {
 490                                         return projectFile;
 491                                 }
 492                         }
 493                         return null;
 494                 }
 495
 496                 /**
 497                  * @see net.pterodactylus.jsite.project.ProjectFile#getFiles()
 498                  */
 499                 public List<ProjectFile> getFiles() {
 500                         List<ProjectFile> projectFiles = new ArrayList<ProjectFile>(childProjectFiles);
 501                         return projectFiles;
 502                 }
 503
 504                 //
 505                 // ACTIONS
 506                 //
 507
 508                 /**
 509                  * Adds a new project file as child to this project file.
 510                  *
 511                  * @param name
 512                  *            The name of the file
 513                  * @param size
 514                  *            The size of the file
 515                  * @param isDirectory
 516                  *            <code>true</code> if the new file is a directory,
 517                  *            <code>false</code> otherwise
 518                  * @param isHidden
 519                  *            <code>true</code> if the new file is hidden,
 520                  *            <code>false</code> otherwise
 521                  * @return The created project file
 522                  */
 523                 public ProjectFileImpl addFile(String name, long size, boolean isDirectory, boolean isHidden) {
 524                         ProjectFileImpl newProjectFile = new ProjectFileImpl(this, name, size, isDirectory, isHidden);
 525                         childProjectFiles.add(newProjectFile);
 526                         return newProjectFile;
 527                 }
 528
 529                 /**
 530                  * Sorts the children of this file.
 531                  */
 532                 public void sort() {
 533                         Collections.sort(childProjectFiles);
 534                 }
 535
 536                 //
 537                 // INTERFACE Comparable
 538                 //
 539
 540                 /**
 541                  * {@inheritDoc}
 542                  */
 543                 public int compareTo(ProjectFileImpl otherProjectFileImpl) {
 544                         return name.compareTo(otherProjectFileImpl.name);
 545                 }
 546
 547         }
 548
 549 }