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 file override for the given file.
 274          *
 275          * @param projectFile
 276          *            The file for which to get the override
 277          * @return The file override, or <code>null</code> if the given file does
 278          *         not have an override
 279          */
 280         public FileOverride getFileOverride(ProjectFile projectFile) {
 281                 return fileOverrides.get(projectFile.getCompletePath());
 282         }
 283
 284         /**
 285          * Returns the file override for the given file.
 286          *
 287          * @param filePath
 288          *            The file path for which to get the override
 289          * @return The file override, or <code>null</code> if the given file does
 290          *         not have an override
 291          */
 292         public FileOverride getFileOverride(String filePath) {
 293                 return fileOverrides.get(filePath);
 294         }
 295
 296         /**
 297          * Returns the list of {@link FileOverride}s.
 298          *
 299          * @return All file overrides
 300          */
 301         public Map<String, FileOverride> getFileOverrides() {
 302                 return fileOverrides;
 303         }
 304
 305         /**
 306          * Scans the base path for files and returns the {@link ProjectFile} for the
 307          * base path. From this file it is possible to reach all files in the base
 308          * path. This method is disk-intensive and may take some time on larger
 309          * directories!
 310          *
 311          * @return The file for the base path, or <code>null</code> if the base
 312          *         path does not denote an existing directory
 313          */
 314         public ProjectFile getBaseFile() {
 315                 File basePathFile = new File(basePath);
 316                 if (!basePathFile.exists() || !basePathFile.isDirectory()) {
 317                         return null;
 318                 }
 319                 rootProjectFile = new ProjectFileImpl(null, "", 0, true, false);
 320                 scanDirectory(basePathFile, rootProjectFile);
 321                 return rootProjectFile;
 322         }
 323
 324         /**
 325          * Returns the file that is specified by its complete path.
 326          *
 327          * @param completePath
 328          *            The complete path of the file
 329          * @return The project file at the given path, or <code>null</code> if
 330          *         there is no such file
 331          */
 332         public ProjectFile getFile(String completePath) {
 333                 if (rootProjectFile == null) {
 334                         getBaseFile();
 335                 }
 336                 if ((rootProjectFile == null) || (completePath.length() == 0)) {
 337                         return rootProjectFile;
 338                 }
 339                 String[] pathParts = completePath.split("\\" + File.separator);
 340                 ProjectFileImpl currentProjectFile = rootProjectFile;
 341                 for (String pathPart: pathParts) {
 342                         currentProjectFile = currentProjectFile.getFile(pathPart);
 343                         if (currentProjectFile == null) {
 344                                 return null;
 345                         }
 346                 }
 347                 return currentProjectFile;
 348         }
 349
 350         //
 351         // PRIVATE METHODS
 352         //
 353
 354         /**
 355          * Scans the given directory and recreates the file and directory structure
 356          * in the given project file.
 357          *
 358          * @param directory
 359          *            The directory to scan
 360          * @param projectFile
 361          *            The project file in which to recreate the directory and file
 362          *            structure
 363          */
 364         private void scanDirectory(File directory, ProjectFileImpl projectFile) {
 365                 if (!directory.isDirectory()) {
 366                         return;
 367                 }
 368                 for (File file: directory.listFiles()) {
 369                         ProjectFileImpl projectFileChild = projectFile.addFile(file.getName(), file.length(), file.isDirectory(), file.isHidden());
 370                         if (file.isDirectory()) {
 371                                 scanDirectory(file, projectFileChild);
 372                         }
 373                 }
 374                 projectFile.sort();
 375         }
 376
 377         /**
 378          * Implementation of a {@link ProjectFile}.
 379          *
 380          * @author David ‘Bombe’ Roden &lt;bombe@freenetproject.org&gt;
 381          */
 382         private static class ProjectFileImpl implements ProjectFile, Comparable<ProjectFileImpl> {
 383
 384                 /** The parent of this project file. */
 385                 private final ProjectFileImpl parentProjectFile;
 386
 387                 /** The name of this project file. */
 388                 private final String name;
 389
 390                 /** The size of the file. */
 391                 private final long size;
 392
 393                 /** Whether this project file is a directory. */
 394                 private final boolean directory;
 395
 396                 /** Whether this file is hidden. */
 397                 private final boolean hidden;
 398
 399                 /** This project file’s children. */
 400                 private List<ProjectFileImpl> childProjectFiles = new ArrayList<ProjectFileImpl>();
 401
 402                 /**
 403                  * Creates a new project fie.
 404                  *
 405                  * @param parentProjectFile
 406                  *            The parent of the project file, or <code>null</code> if
 407                  *            the new project file does not have a parent
 408                  * @param name
 409                  *            The name of the project file
 410                  * @param size
 411                  *            The size of the file
 412                  * @param isDirectory
 413                  *            <code>true</code> if this project file is a directory,
 414                  *            <code>false</code> otherwise
 415                  * @param isHidden
 416                  *            <code>true</code> if this project file is hidden,
 417                  *            <code>false</code> otherwise
 418                  */
 419                 ProjectFileImpl(ProjectFileImpl parentProjectFile, String name, long size, boolean isDirectory, boolean isHidden) {
 420                         this.parentProjectFile = parentProjectFile;
 421                         this.name = name;
 422                         this.size = size;
 423                         this.directory = isDirectory;
 424                         this.hidden = isHidden;
 425                 }
 426
 427                 //
 428                 // INTERFACE ProjectFile
 429                 //
 430
 431                 /**
 432                  * @see net.pterodactylus.jsite.project.ProjectFile#getName()
 433                  */
 434                 public String getName() {
 435                         return name;
 436                 }
 437
 438                 /**
 439                  * @see net.pterodactylus.jsite.project.ProjectFile#getParent()
 440                  */
 441                 public ProjectFile getParent() {
 442                         return parentProjectFile;
 443                 }
 444
 445                 /**
 446                  * {@inheritDoc}
 447                  */
 448                 public long getSize() {
 449                         return size;
 450                 }
 451
 452                 /**
 453                  * @see net.pterodactylus.jsite.project.ProjectFile#getParents()
 454                  */
 455                 public List<ProjectFile> getParents() {
 456                         List<ProjectFile> parentProjectFiles = new ArrayList<ProjectFile>();
 457                         ProjectFileImpl currentProjectFile = this;
 458                         do {
 459                                 parentProjectFiles.add(0, currentProjectFile);
 460                         } while ((currentProjectFile = currentProjectFile.parentProjectFile) != null);
 461                         return parentProjectFiles;
 462                 }
 463
 464                 /**
 465                  * {@inheritDoc}
 466                  */
 467                 /* TODO - caching? */
 468                 public String getCompletePath() {
 469                         StringBuilder completePath = new StringBuilder();
 470                         ProjectFileImpl currentProjectFile = this;
 471                         while ((currentProjectFile != null) && (currentProjectFile.parentProjectFile != null)) {
 472                                 completePath.insert(0, currentProjectFile.getName()).insert(0, File.separatorChar);
 473                                 currentProjectFile = currentProjectFile.parentProjectFile;
 474                         }
 475                         return (completePath.length() > 0) ? completePath.substring(1) : "";
 476                 }
 477
 478                 /**
 479                  * @see net.pterodactylus.jsite.project.ProjectFile#isFile()
 480                  */
 481                 public boolean isFile() {
 482                         return !directory;
 483                 }
 484
 485                 /**
 486                  * @see net.pterodactylus.jsite.project.ProjectFile#isDirectory()
 487                  */
 488                 public boolean isDirectory() {
 489                         return directory;
 490                 }
 491
 492                 /**
 493                  * @see net.pterodactylus.jsite.project.ProjectFile#isHidden()
 494                  */
 495                 public boolean isHidden() {
 496                         return hidden;
 497                 }
 498
 499                 /**
 500                  * Returns the project file with the given name. The project file has to
 501                  * be a direct child of this project file.
 502                  *
 503                  * @param name
 504                  *            The name of the file to get
 505                  * @return The project file, or <code>null</code> if there is no
 506                  *         project file by that name
 507                  */
 508                 public ProjectFileImpl getFile(String name) {
 509                         if (!isDirectory()) {
 510                                 return null;
 511                         }
 512                         for (ProjectFileImpl projectFile: childProjectFiles) {
 513                                 if (projectFile.getName().equals(name)) {
 514                                         return projectFile;
 515                                 }
 516                         }
 517                         return null;
 518                 }
 519
 520                 /**
 521                  * @see net.pterodactylus.jsite.project.ProjectFile#getFiles()
 522                  */
 523                 public List<ProjectFile> getFiles() {
 524                         List<ProjectFile> projectFiles = new ArrayList<ProjectFile>(childProjectFiles);
 525                         return projectFiles;
 526                 }
 527
 528                 //
 529                 // ACTIONS
 530                 //
 531
 532                 /**
 533                  * Adds a new project file as child to this project file.
 534                  *
 535                  * @param name
 536                  *            The name of the file
 537                  * @param size
 538                  *            The size of the file
 539                  * @param isDirectory
 540                  *            <code>true</code> if the new file is a directory,
 541                  *            <code>false</code> otherwise
 542                  * @param isHidden
 543                  *            <code>true</code> if the new file is hidden,
 544                  *            <code>false</code> otherwise
 545                  * @return The created project file
 546                  */
 547                 public ProjectFileImpl addFile(String name, long size, boolean isDirectory, boolean isHidden) {
 548                         ProjectFileImpl newProjectFile = new ProjectFileImpl(this, name, size, isDirectory, isHidden);
 549                         childProjectFiles.add(newProjectFile);
 550                         return newProjectFile;
 551                 }
 552
 553                 /**
 554                  * Sorts the children of this file.
 555                  */
 556                 public void sort() {
 557                         Collections.sort(childProjectFiles);
 558                 }
 559
 560                 //
 561                 // INTERFACE Comparable
 562                 //
 563
 564                 /**
 565                  * {@inheritDoc}
 566                  */
 567                 public int compareTo(ProjectFileImpl otherProjectFileImpl) {
 568                         return name.compareTo(otherProjectFileImpl.name);
 569                 }
 570
 571         }
 572
 573 }