move method to correct place
[jSite2.git] / src / net / pterodactylus / jsite / gui / FileManager.java
1 /*
2  * jSite2 - FileManager.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.gui;
21
22 import java.awt.BorderLayout;
23 import java.awt.Color;
24 import java.awt.Component;
25 import java.awt.Dimension;
26 import java.awt.FlowLayout;
27 import java.awt.Font;
28 import java.awt.GridBagConstraints;
29 import java.awt.GridBagLayout;
30 import java.awt.Insets;
31 import java.awt.event.ActionEvent;
32 import java.awt.event.MouseEvent;
33 import java.awt.event.MouseListener;
34 import java.beans.PropertyChangeEvent;
35 import java.beans.PropertyChangeListener;
36 import java.io.File;
37 import java.util.ArrayList;
38 import java.util.Collections;
39 import java.util.HashMap;
40 import java.util.List;
41 import java.util.Map;
42 import java.util.logging.Level;
43 import java.util.logging.Logger;
44
45 import javax.swing.AbstractAction;
46 import javax.swing.AbstractButton;
47 import javax.swing.Action;
48 import javax.swing.BorderFactory;
49 import javax.swing.JButton;
50 import javax.swing.JCheckBox;
51 import javax.swing.JComboBox;
52 import javax.swing.JDialog;
53 import javax.swing.JLabel;
54 import javax.swing.JOptionPane;
55 import javax.swing.JPanel;
56 import javax.swing.JPopupMenu;
57 import javax.swing.JScrollPane;
58 import javax.swing.JTextField;
59 import javax.swing.JTree;
60 import javax.swing.event.TreeModelEvent;
61 import javax.swing.event.TreeModelListener;
62 import javax.swing.event.TreeSelectionEvent;
63 import javax.swing.event.TreeSelectionListener;
64 import javax.swing.tree.DefaultTreeCellRenderer;
65 import javax.swing.tree.TreeModel;
66 import javax.swing.tree.TreePath;
67
68 import net.pterodactylus.jsite.i18n.I18n;
69 import net.pterodactylus.jsite.i18n.I18nable;
70 import net.pterodactylus.jsite.i18n.gui.I18nAction;
71 import net.pterodactylus.jsite.i18n.gui.I18nLabel;
72 import net.pterodactylus.jsite.i18n.gui.I18nMenu;
73 import net.pterodactylus.jsite.project.FileOverride;
74 import net.pterodactylus.jsite.project.Project;
75 import net.pterodactylus.jsite.project.ProjectFile;
76 import net.pterodactylus.util.io.MimeTypes;
77 import net.pterodactylus.util.logging.Logging;
78 import net.pterodactylus.util.swing.SwingUtils;
79
80 /**
81  * Manages physical and virtual files in a project.
82  * 
83  * @author David ‘Bombe’ Roden <bombe@freenetproject.org>
84  */
85 public class FileManager extends JDialog implements I18nable, TreeSelectionListener, MouseListener {
86
87         /** Logger. */
88         private static final Logger logger = Logging.getLogger(FileManager.class.getName());
89
90         /** The Swing interface. */
91         private final SwingInterface swingInterface;
92
93         /** The project whose files to manage. */
94         private final Project project;
95
96         /** The tree model for the project files. */
97         private final ProjectFileTreeModel fileTreeModel;
98
99         /** The tree cell renderer. */
100         private final FileCellRenderer fileCellRenderer;
101
102         /** The “rescan” action. */
103         private I18nAction rescanAction;
104
105         /** The “close” action. */
106         private I18nAction closeAction;
107
108         /** The “set default file” action. */
109         private I18nAction setDefaultFileAction;
110
111         /** The “project files” label. */
112         private I18nLabel projectFilesLabel;
113
114         /** The tree that shows the files. */
115         private JTree fileTree;
116
117         /** The scroll pane that holds the file tree. */
118         private JScrollPane fileScrollPane;
119
120         /** The “file properties” label. */
121         private I18nLabel filePropertiesLabel;
122
123         /** The “file path” label. */
124         private I18nLabel filePathLabel;
125
126         /** The “file path” textfield. */
127         private JTextField filePathTextField;
128
129         /** The “file name” label. */
130         private I18nLabel fileNameLabel;
131
132         /** The “file name” textfield. */
133         private JTextField fileNameTextField;
134
135         /** The “file size” label. */
136         private I18nLabel fileSizeLabel;
137
138         /** The “file size” text field. */
139         private JTextField fileSizeTextField;
140
141         /** The “override” label. */
142         private I18nLabel fileSettingsLabel;
143
144         /** The “insert default” label. */
145         private I18nLabel insertDefaultLabel;
146
147         /** The “insert default” checkbox. */
148         private JCheckBox insertDefaultCheckBox;
149
150         /** The “override insert default” action. */
151         private I18nAction overrideInsertDefaultAction;
152
153         /** The “override insert default” checkbox. */
154         private JCheckBox overrideInsertDefaultCheckBox;
155
156         /** The “override insert” action. */
157         private Action insertOverrideAction;
158
159         /** The “override insert” checkbox. */
160         private JCheckBox insertOverrideCheckBox;
161
162         /** The context menu for the tree. */
163         private JPopupMenu treeContextMenu;
164
165         /** The “apply override” menu. */
166         private I18nMenu overrideMenu;
167
168         /** The “apply insert override” action. */
169         private I18nAction applyInsertOverrideAction;
170
171         /** The “apply mime type override” action. */
172         private I18nAction applyMimeTypeOverrideAction;
173
174         /** The “remove override” action. */
175         private I18nAction removeOverrideAction;
176
177         /**
178          * Creates a new file manager.
179          * 
180          * @param swingInterface
181          *            The Swing interface
182          * @param project
183          *            The project whose files to manage
184          */
185         public FileManager(SwingInterface swingInterface, Project project) {
186                 super(swingInterface.getMainWindow(), I18n.get("fileManager.title", project.getName()), true);
187                 logger.log(Level.FINEST, "project: " + project);
188                 this.swingInterface = swingInterface;
189                 this.project = project;
190                 fileTreeModel = new ProjectFileTreeModel();
191                 project.addPropertyChangeListener(fileTreeModel);
192                 fileCellRenderer = new FileCellRenderer();
193                 initActions();
194                 initComponents();
195                 pack();
196                 SwingUtils.center(this);
197         }
198
199         //
200         // ACTIONS
201         //
202
203         /**
204          * @see java.awt.Component#setVisible(boolean)
205          */
206         @Override
207         public void setVisible(boolean visible) {
208                 if (visible) {
209                         initiateFileScan();
210                 }
211                 super.setVisible(visible);
212         }
213
214         //
215         // PRIVATE METHODS
216         //
217
218         /**
219          * Initializes all actions.
220          */
221         private void initActions() {
222                 closeAction = new I18nAction("fileManager.button.close") {
223
224                         /**
225                          * {@inheritDoc}
226                          */
227                         @SuppressWarnings("synthetic-access")
228                         public void actionPerformed(ActionEvent e) {
229                                 String defaultFile = project.getDefaultFile();
230                                 if ((defaultFile == null) || (defaultFile.length() == 0)) {
231                                         /* TODO - i18n */
232                                         JOptionPane.showMessageDialog(FileManager.this, I18n.get(""), I18n.get(""), JOptionPane.ERROR_MESSAGE);
233                                         return;
234                                 }
235                                 ProjectFile projectFile = project.getFile(defaultFile);
236                                 if (projectFile == null) {
237                                         JOptionPane.showMessageDialog(FileManager.this, I18n.get(""), I18n.get(""), JOptionPane.ERROR_MESSAGE);
238                                         return;
239                                 }
240                                 setVisible(false);
241                         }
242                 };
243                 rescanAction = new I18nAction("fileManager.button.rescan") {
244
245                         /**
246                          * {@inheritDoc}
247                          */
248                         @SuppressWarnings("synthetic-access")
249                         public void actionPerformed(ActionEvent actionEvent) {
250                                 initiateFileScan();
251                         }
252                 };
253                 setDefaultFileAction = new I18nAction("fileManager.menu.item.setDefaultFile") {
254
255                         /**
256                          * {@inheritDoc}
257                          */
258                         @SuppressWarnings("synthetic-access")
259                         public void actionPerformed(ActionEvent actionEvent) {
260                                 TreePath selectedPath = fileTree.getSelectionPath();
261                                 if (selectedPath == null) {
262                                         logger.log(Level.WARNING, "nothing selected!");
263                                         return;
264                                 }
265                                 ProjectFileWrapper projectFileWrapper = (ProjectFileWrapper) selectedPath.getLastPathComponent();
266                                 if (isHidden(projectFileWrapper)) {
267                                         /* TODO - i18n */
268                                         JOptionPane.showMessageDialog(FileManager.this, I18n.get(""), I18n.get(""), JOptionPane.ERROR_MESSAGE);
269                                         return;
270                                 }
271                                 if (projectFileWrapper.getProjectFile().isDirectory()) {
272                                         /* TODO - i18n */
273                                         JOptionPane.showMessageDialog(FileManager.this, I18n.get(""), I18n.get(""), JOptionPane.ERROR_MESSAGE);
274                                         return;
275                                 }
276                                 String completePath = projectFileWrapper.getProjectFile().getCompletePath();
277                                 project.setDefaultFile(completePath);
278                         }
279                 };
280                 applyInsertOverrideAction = new I18nAction("fileManager.menu.item.applyInsertOverride") {
281
282                         /**
283                          * {@inheritDoc}
284                          */
285                         @SuppressWarnings("synthetic-access")
286                         public void actionPerformed(ActionEvent actionEvent) {
287                                 applyInsertOverride();
288                         }
289                 };
290                 applyMimeTypeOverrideAction = new I18nAction("fileManager.menu.item.applyMimeTypeOverride") {
291
292                         /**
293                          * {@inheritDoc}
294                          */
295                         @SuppressWarnings("synthetic-access")
296                         public void actionPerformed(ActionEvent actionEvent) {
297                                 applyMimeTypeOverride();
298                         }
299                 };
300                 removeOverrideAction = new I18nAction("fileManager.menu.item.removeOverride") {
301
302                         /**
303                          * {@inheritDoc}
304                          */
305                         @SuppressWarnings("synthetic-access")
306                         public void actionPerformed(ActionEvent actionEvent) {
307                                 removeOverride();
308                         }
309                 };
310                 overrideInsertDefaultAction = new I18nAction("fileManager.checkbox.overrideInsertDefault") {
311
312                         /**
313                          * {@inheritDoc}
314                          */
315                         @SuppressWarnings("synthetic-access")
316                         public void actionPerformed(ActionEvent actionEvent) {
317                                 boolean overrideInsert = overrideInsertDefaultCheckBox.isSelected();
318                                 insertOverrideAction.setEnabled(overrideInsert);
319                                 List<ProjectFileWrapper> selectedProjectFileWrappers = getSelectedProjectFileWrappers(true);
320                                 ProjectFileWrapper projectFileWrapper = selectedProjectFileWrappers.get(0);
321                                 ProjectFile projectFile = projectFileWrapper.getProjectFile();
322                                 FileOverride fileOverride = project.getFileOverride(projectFile);
323                                 if (overrideInsert) {
324                                         if (fileOverride == null) {
325                                                 fileOverride = new FileOverride();
326                                                 project.addFileOverride(projectFile, fileOverride);
327                                                 fileOverride.setInsert(!projectFile.isHidden());
328                                         }
329                                 } else {
330                                         fileOverride.setInsert(null);
331                                         if (fileOverride.isEmpty()) {
332                                                 project.removeFileOverride(projectFile);
333                                         }
334                                 }
335                         }
336                 };
337                 overrideInsertDefaultAction.setEnabled(false);
338                 insertOverrideAction = new AbstractAction() {
339
340                         /**
341                          * {@inheritDoc}
342                          */
343                         public void actionPerformed(ActionEvent actionEvent) {
344                                 boolean insertOverride = insertOverrideCheckBox.isSelected();
345                                 List<ProjectFileWrapper> selectedProjectFileWrappers = getSelectedProjectFileWrappers(true);
346                                 ProjectFileWrapper projectFileWrapper = selectedProjectFileWrappers.get(0);
347                                 ProjectFile projectFile = projectFileWrapper.getProjectFile();
348                                 FileOverride fileOverride = project.getFileOverride(projectFile);
349                                 fileOverride.setInsert(insertOverride);
350                                 fileTree.setShowsRootHandles(false);
351                                 fileTree.repaint();
352                         }
353                 };
354                 insertOverrideAction.setEnabled(false);
355         }
356
357         /**
358          * Initializes all components.
359          */
360         private void initComponents() {
361                 treeContextMenu = new JPopupMenu();
362                 treeContextMenu.add(setDefaultFileAction);
363
364                 overrideMenu = new I18nMenu("fileManager.menu.override");
365                 treeContextMenu.add(overrideMenu);
366
367                 overrideMenu.add(applyInsertOverrideAction);
368                 overrideMenu.add(applyMimeTypeOverrideAction);
369                 overrideMenu.addSeparator();
370                 overrideMenu.add(removeOverrideAction);
371
372                 JPanel contentPanel = new JPanel(new BorderLayout(12, 12));
373                 contentPanel.setBorder(BorderFactory.createEmptyBorder(12, 12, 12, 12));
374
375                 contentPanel.add(createFileManagerPanel(), BorderLayout.CENTER);
376                 contentPanel.add(createButtonPanel(), BorderLayout.PAGE_END);
377
378                 setContentPane(contentPanel);
379         }
380
381         /**
382          * Creates the main panel with the file tree and the file properties.
383          * 
384          * @return The mail panel
385          */
386         private Component createFileManagerPanel() {
387                 JPanel fileManagerPanel = new JPanel(new BorderLayout(12, 12));
388
389                 /* file tree panel */
390                 JPanel fileTreePanel = new JPanel(new BorderLayout(12, 12));
391                 fileManagerPanel.add(fileTreePanel, BorderLayout.LINE_START);
392
393                 fileTree = new JTree(fileTreeModel);
394                 fileTree.setShowsRootHandles(false);
395                 fileTree.addTreeSelectionListener(this);
396                 fileTree.addMouseListener(this);
397                 fileTree.setCellRenderer(fileCellRenderer);
398                 fileTreePanel.add(fileScrollPane = new JScrollPane(fileTree), BorderLayout.CENTER);
399                 fileScrollPane.setPreferredSize(new Dimension(200, 350));
400
401                 projectFilesLabel = new I18nLabel("fileManager.label.projectFiles", fileTree);
402                 JPanel projectFilesLabelPanel = new JPanel(new FlowLayout(FlowLayout.CENTER, 0, 0));
403                 fileTreePanel.add(projectFilesLabelPanel, BorderLayout.NORTH);
404                 projectFilesLabelPanel.add(projectFilesLabel);
405
406                 /* the right panel */
407                 JPanel rightPanel = new JPanel(new BorderLayout(12, 12));
408                 fileManagerPanel.add(rightPanel, BorderLayout.CENTER);
409
410                 /* properties panel */
411                 JPanel propertiesPanel = new JPanel(new GridBagLayout());
412                 rightPanel.add(propertiesPanel, BorderLayout.CENTER);
413                 propertiesPanel.setBorder(BorderFactory.createCompoundBorder(BorderFactory.createEtchedBorder(), BorderFactory.createEmptyBorder(12, 12, 12, 12)));
414                 propertiesPanel.setPreferredSize(new Dimension(400, 350));
415
416                 filePropertiesLabel = new I18nLabel("fileManager.label.fileProperties");
417                 filePropertiesLabel.setFont(filePropertiesLabel.getFont().deriveFont(Font.BOLD));
418                 propertiesPanel.add(filePropertiesLabel, new GridBagConstraints(0, 0, 4, 1, 0.0, 0.0, GridBagConstraints.LINE_START, GridBagConstraints.BOTH, new Insets(0, 0, 0, 0), 0, 0));
419
420                 filePathLabel = new I18nLabel("fileManager.label.filePath");
421                 filePathTextField = new JTextField();
422                 filePathTextField.setEditable(false);
423                 propertiesPanel.add(filePathLabel, new GridBagConstraints(0, 1, 1, 1, 0.0, 0.0, GridBagConstraints.LINE_START, GridBagConstraints.BOTH, new Insets(12, 24, 0, 0), 0, 0));
424                 propertiesPanel.add(filePathTextField, new GridBagConstraints(1, 1, 3, 1, 1.0, 0.0, GridBagConstraints.LINE_START, GridBagConstraints.BOTH, new Insets(12, 12, 0, 0), 0, 0));
425
426                 fileNameLabel = new I18nLabel("fileManager.label.fileName");
427                 fileNameTextField = new JTextField();
428                 fileNameTextField.setEditable(false);
429                 propertiesPanel.add(fileNameLabel, new GridBagConstraints(0, 2, 1, 1, 0.0, 0.0, GridBagConstraints.LINE_START, GridBagConstraints.BOTH, new Insets(12, 24, 0, 0), 0, 0));
430                 propertiesPanel.add(fileNameTextField, new GridBagConstraints(1, 2, 3, 1, 1.0, 0.0, GridBagConstraints.LINE_START, GridBagConstraints.BOTH, new Insets(12, 12, 0, 0), 0, 0));
431
432                 fileSizeLabel = new I18nLabel("fileManager.label.fileSize");
433                 fileSizeTextField = new JTextField();
434                 fileSizeTextField.setEditable(false);
435                 propertiesPanel.add(fileSizeLabel, new GridBagConstraints(0, 3, 1, 1, 0.0, 0.0, GridBagConstraints.LINE_START, GridBagConstraints.BOTH, new Insets(12, 24, 0, 0), 0, 0));
436                 propertiesPanel.add(fileSizeTextField, new GridBagConstraints(1, 3, 3, 1, 1.0, 0.0, GridBagConstraints.LINE_START, GridBagConstraints.BOTH, new Insets(12, 12, 0, 0), 0, 0));
437
438                 /* file settings. */
439                 fileSettingsLabel = new I18nLabel("fileManager.label.fileSettings");
440                 fileSettingsLabel.setFont(fileSettingsLabel.getFont().deriveFont(Font.BOLD));
441                 propertiesPanel.add(fileSettingsLabel, new GridBagConstraints(0, 4, 4, 1, 1.0, 0.0, GridBagConstraints.LINE_START, GridBagConstraints.BOTH, new Insets(24, 0, 0, 0), 0, 0));
442
443                 insertDefaultLabel = new I18nLabel("fileManager.label.insertDefault");
444                 propertiesPanel.add(insertDefaultLabel, new GridBagConstraints(0, 5, 1, 1, 0.0, 0.0, GridBagConstraints.LINE_START, GridBagConstraints.BOTH, new Insets(12, 24, 0, 0), 0, 0));
445                 insertDefaultCheckBox = new JCheckBox();
446                 insertDefaultCheckBox.setEnabled(false);
447                 propertiesPanel.add(insertDefaultCheckBox, new GridBagConstraints(1, 5, 1, 1, 1.0, 0.0, GridBagConstraints.LINE_START, GridBagConstraints.BOTH, new Insets(12, 12, 0, 0), 0, 0));
448                 overrideInsertDefaultCheckBox = new JCheckBox(overrideInsertDefaultAction);
449                 propertiesPanel.add(overrideInsertDefaultCheckBox, new GridBagConstraints(2, 5, 1, 1, 0.0, 0.0, GridBagConstraints.LINE_START, GridBagConstraints.BOTH, new Insets(12, 12, 0, 0), 0, 0));
450                 insertOverrideCheckBox = new JCheckBox(insertOverrideAction);
451                 propertiesPanel.add(insertOverrideCheckBox, new GridBagConstraints(3, 5, 1, 1, 1.0, 0.0, GridBagConstraints.LINE_START, GridBagConstraints.BOTH, new Insets(12, 12, 0, 0), 0, 0));
452
453                 /* glue panel. */
454                 propertiesPanel.add(new JPanel(), new GridBagConstraints(0, 6, 4, 1, 1.0, 1.0, GridBagConstraints.LINE_START, GridBagConstraints.BOTH, new Insets(0, 0, 0, 0), 0, 0));
455
456                 /* action button panel */
457                 JPanel actionButtonPanel = new JPanel(new FlowLayout(FlowLayout.LEADING, 12, 12));
458                 rightPanel.add(actionButtonPanel, BorderLayout.PAGE_END);
459                 actionButtonPanel.setBorder(BorderFactory.createEtchedBorder());
460
461                 JButton rescanButton = new JButton(rescanAction);
462                 actionButtonPanel.add(rescanButton);
463
464                 return fileManagerPanel;
465         }
466
467         /**
468          * Creates the button panel.
469          * 
470          * @return The button panel
471          */
472         private Component createButtonPanel() {
473                 JPanel buttonPanel = new JPanel(new FlowLayout(FlowLayout.TRAILING, 12, 12));
474
475                 buttonPanel.setBorder(BorderFactory.createEmptyBorder(-12, -12, -12, -12));
476                 JButton closeButton = new JButton(closeAction);
477                 buttonPanel.add(closeButton);
478
479                 getRootPane().setDefaultButton(closeButton);
480                 return buttonPanel;
481         }
482
483         /**
484          * Initiates a file scan.
485          */
486         private void initiateFileScan() {
487                 swingInterface.getThreadPool().execute(new Runnable() {
488
489                         /**
490                          * @see java.lang.Runnable#run()
491                          */
492                         @SuppressWarnings("synthetic-access")
493                         public void run() {
494                                 fileTree.setEnabled(false);
495                                 rescanAction.setEnabled(false);
496                                 ProjectFile baseProjectFile = project.getBaseFile();
497                                 if (baseProjectFile != null) {
498                                         fileTreeModel.setBaseProjectFile(baseProjectFile);
499                                 }
500                                 // fileScrollPane.revalidate();
501                                 rescanAction.setEnabled(true);
502                                 fileTree.setEnabled(true);
503                         }
504
505                 });
506         }
507
508         /**
509          * Checks whether the given mouse event is a popup trigger and occured over
510          * a file. If so, the context menu is shown.
511          * 
512          * @param mouseEvent
513          *            The mouse event to check
514          */
515         private void maybeShowContextMenu(MouseEvent mouseEvent) {
516                 if (!mouseEvent.isPopupTrigger()) {
517                         return;
518                 }
519                 List<ProjectFileWrapper> selectedProjectFileWrappers = getSelectedProjectFileWrappers(false);
520                 TreePath clickedPath = fileTree.getPathForLocation(mouseEvent.getX(), mouseEvent.getY());
521                 ProjectFileWrapper clickedProjectFileWrapper = (ProjectFileWrapper) clickedPath.getLastPathComponent();
522                 if (!selectedProjectFileWrappers.contains(clickedProjectFileWrapper)) {
523                         fileTree.setSelectionPath(clickedPath);
524                         selectedProjectFileWrappers = getSelectedProjectFileWrappers(false);
525                 }
526                 logger.log(Level.FINEST, "selectedProjectFileWrappers.size(): " + selectedProjectFileWrappers.size());
527                 if (selectedProjectFileWrappers.size() == 1) {
528                         ProjectFileWrapper projectFileWrapper = selectedProjectFileWrappers.get(0);
529                         ProjectFile projectFile = projectFileWrapper.getProjectFile();
530                         setDefaultFileAction.setEnabled(!isHidden(projectFileWrapper) && projectFile.isFile() && !projectFile.getCompletePath().equals(project.getDefaultFile()));
531                 } else {
532                         setDefaultFileAction.setEnabled(false);
533                 }
534                 overrideMenu.setVisible(selectedProjectFileWrappers.size() > 1);
535                 treeContextMenu.show(fileTree, mouseEvent.getX(), mouseEvent.getY());
536         }
537
538         /**
539          * Finds whether the {@link ProjectFile} given by
540          * <code>projectFileWrapper</code> is hidden.
541          * 
542          * @param projectFileWrapper
543          *            The wrapped project file
544          * @return <code>true</code> if the file is hidden and should not be
545          *         inserted, <code>false</code> otherwise
546          */
547         private boolean isHidden(ProjectFileWrapper projectFileWrapper) {
548                 ProjectFile projectFile = projectFileWrapper.getProjectFile();
549                 FileOverride fileOverride = project.getFileOverrides().get(projectFile.getCompletePath());
550                 logger.log(Level.FINEST, "fileOverride: " + fileOverride);
551                 return ((fileOverride == null) && projectFile.isHidden()) || ((fileOverride != null) && (fileOverride.isInsert() == null) && projectFile.isHidden()) || ((fileOverride != null) && (fileOverride.isInsert() != null) && (Boolean.FALSE.equals(fileOverride.isInsert())));
552         }
553
554         /**
555          * Opens the “apply insert override” dialog and lets the user apply an
556          * override for the “insert” setting for multiple files.
557          */
558         private void applyInsertOverride() {
559                 JCheckBox insertCheckBox = new JCheckBox(I18n.get("fileManager.menu.item.insert.name"));
560                 String okString = I18n.get("general.button.okay.name");
561                 String cancelString = I18n.get("general.button.cancel.name");
562                 int choice = JOptionPane.showOptionDialog(this, new Object[] { I18n.get("fileManager.dialog.insertOverride.message"), insertCheckBox }, I18n.get("fileManager.dialog.insertOverride.title"), JOptionPane.YES_NO_OPTION, JOptionPane.QUESTION_MESSAGE, null, new Object[] { okString, cancelString }, okString);
563                 logger.log(Level.FINEST, "choice: " + choice);
564                 if ((choice == JOptionPane.CLOSED_OPTION) || (choice == 1)) {
565                         return;
566                 }
567                 logger.log(Level.INFO, "selected insert override: " + insertCheckBox.isSelected());
568                 List<ProjectFileWrapper> selectedProjectFileWrappers = getSelectedProjectFileWrappers(true);
569                 for (ProjectFileWrapper selectedProjectFileWrapper : selectedProjectFileWrappers) {
570                         ProjectFile projectFile = selectedProjectFileWrapper.getProjectFile();
571                         FileOverride fileOverride = project.getFileOverride(projectFile);
572                         if (fileOverride == null) {
573                                 fileOverride = new FileOverride();
574                                 project.addFileOverride(projectFile, fileOverride);
575                         }
576                         fileOverride.setInsert(insertCheckBox.isSelected());
577                 }
578                 /* HACK - Swing sucks a bit */
579                 fileTree.setShowsRootHandles(false);
580         }
581
582         /**
583          * Opens the “apply mime type override” dialog and lets the user apply an
584          * override for the “mime type” setting for multiple files.
585          */
586         private void applyMimeTypeOverride() {
587                 List<String> allMimeTypes = MimeTypes.getAllMimeTypes();
588                 allMimeTypes.add(0, null);
589                 JComboBox mimeTypeComboBox = new JComboBox(allMimeTypes.toArray());
590                 String okString = I18n.get("general.button.okay.name");
591                 String cancelString = I18n.get("general.button.cancel.name");
592                 int choice = JOptionPane.showOptionDialog(this, new Object[] { I18n.get("fileManager.dialog.mimeTypeOverride.message"), mimeTypeComboBox }, I18n.get("fileManager.dialog.mimeTypeOverride.title"), JOptionPane.YES_NO_OPTION, JOptionPane.QUESTION_MESSAGE, null, new Object[] { okString, cancelString }, okString);
593                 if ((choice == JOptionPane.CLOSED_OPTION) || (choice == 1)) {
594                         return;
595                 }
596                 logger.log(Level.FINE, "selected mime type: " + mimeTypeComboBox.getSelectedItem());
597                 List<ProjectFileWrapper> selectedProjectFileWrappers = getSelectedProjectFileWrappers(true);
598                 for (ProjectFileWrapper selectedProjectFileWrapper : selectedProjectFileWrappers) {
599                         ProjectFile projectFile = selectedProjectFileWrapper.getProjectFile();
600                         FileOverride fileOverride = project.getFileOverride(projectFile);
601                         if (fileOverride == null) {
602                                 fileOverride = new FileOverride();
603                                 project.addFileOverride(projectFile, fileOverride);
604                         }
605                         fileOverride.setContentType((String) mimeTypeComboBox.getSelectedItem());
606                 }
607         }
608
609         /**
610          * Removes the overrides of all selected files.
611          */
612         private void removeOverride() {
613                 String continueString = I18n.get("general.button.continue.name");
614                 String cancelString = I18n.get("general.button.cancel.name");
615                 List<ProjectFileWrapper> selectedProjectFileWrappers = getSelectedProjectFileWrappers(true);
616                 int choice = JOptionPane.showOptionDialog(this, I18n.get("fileManager.dialog.removeOverride.message", selectedProjectFileWrappers.size()), I18n.get("fileManager.dialog.removeOverride.title"), JOptionPane.OK_CANCEL_OPTION, JOptionPane.WARNING_MESSAGE, null, new Object[] { continueString, cancelString }, continueString);
617                 if ((choice == JOptionPane.CLOSED_OPTION) || (choice == 1)) {
618                         return;
619                 }
620                 for (ProjectFileWrapper selectedProjectFileWrapper : selectedProjectFileWrappers) {
621                         project.removeFileOverride(selectedProjectFileWrapper.getProjectFile());
622                 }
623         }
624
625         /**
626          * Returns all currently selected {@link ProjectFileWrapper}s.
627          * 
628          * @param filesOnly
629          *            <code>true</code> to return only selected files,
630          *            <code>false</code> to include directories
631          * @return All selected project file wrappers
632          */
633         private List<ProjectFileWrapper> getSelectedProjectFileWrappers(boolean filesOnly) {
634                 List<ProjectFileWrapper> selectedProjectFileWrappers = new ArrayList<ProjectFileWrapper>();
635                 TreePath[] selectedPaths = fileTree.getSelectionPaths();
636                 if (selectedPaths != null) {
637                         for (TreePath selectedPath : selectedPaths) {
638                                 ProjectFileWrapper projectFileWrapper = (ProjectFileWrapper) selectedPath.getLastPathComponent();
639                                 if (filesOnly && !projectFileWrapper.getProjectFile().isFile()) {
640                                         continue;
641                                 }
642                                 selectedProjectFileWrappers.add(projectFileWrapper);
643                         }
644                 }
645                 return selectedProjectFileWrappers;
646         }
647
648         /**
649          * Sets the given action’s enabled state to the given enabled state if the
650          * action’s current enabled state is not the given enabled state.
651          * 
652          * @param action
653          *            The action to set the enabled state on
654          * @param enabled
655          *            The new enabled state of the action
656          */
657         private void setEnabled(Action action, boolean enabled) {
658                 if (action.isEnabled() != enabled) {
659                         action.setEnabled(enabled);
660                 }
661         }
662
663         /**
664          * Sets the given button’s selected state to the given selected state if the
665          * button’s current selected state is not the given selected state.
666          * 
667          * @param button
668          *            The button to set the selected state on
669          * @param selected
670          *            The new selected state of the button
671          */
672         private void setSelected(AbstractButton button, boolean selected) {
673                 if (button.isSelected() != selected) {
674                         button.setSelected(selected);
675                 }
676         }
677
678         //
679         // INTERFACE I18nable
680         //
681
682         /**
683          * {@inheritDoc}
684          */
685         public void updateI18n() {
686                 setTitle(I18n.get("fileManager.title", project.getName()));
687                 projectFilesLabel.updateI18n();
688                 filePropertiesLabel.updateI18n();
689                 filePathLabel.updateI18n();
690         }
691
692         //
693         // INTERFACE TreeSelectionListener
694         //
695
696         /**
697          * {@inheritDoc}
698          */
699         public void valueChanged(TreeSelectionEvent treeSelectionEvent) {
700                 List<ProjectFileWrapper> selectedProjectFileWrappers = getSelectedProjectFileWrappers(true);
701                 String filePathText = "";
702                 String fileNameText = "";
703                 String fileSizeText = "";
704                 boolean insertDefaultSelected = false;
705                 boolean overrideInsertEnabled = false;
706                 boolean overrideInsertSelected = false;
707                 boolean insertOverrideEnabled = false;
708                 boolean insertOverrideSelected = false;
709                 if (selectedProjectFileWrappers.size() == 1) {
710                         ProjectFileWrapper projectFileWrapper = selectedProjectFileWrappers.get(0);
711                         ProjectFile projectFile = projectFileWrapper.getProjectFile();
712                         if (projectFile.isFile()) {
713                                 String completePath = projectFile.getCompletePath();
714                                 int lastSeparator = completePath.lastIndexOf(File.separatorChar);
715                                 if (lastSeparator != -1) {
716                                         filePathText = completePath.substring(0, lastSeparator);
717                                 }
718                                 fileNameText = projectFile.getName();
719                                 fileSizeText = String.valueOf(projectFile.getSize());
720                                 insertDefaultSelected = !projectFile.isHidden();
721                                 overrideInsertEnabled = true;
722                                 FileOverride fileOverride = project.getFileOverride(projectFile);
723                                 if (fileOverride != null) {
724                                         Boolean overrideInsert = fileOverride.isInsert();
725                                         overrideInsertSelected = overrideInsert != null;
726                                         insertOverrideEnabled = overrideInsertSelected;
727                                         insertOverrideSelected = overrideInsertSelected ? overrideInsert : !projectFile.isHidden();
728                                 }
729                         }
730                 } else if (selectedProjectFileWrappers.size() > 1) {
731                         /* TODO */
732                 }
733                 filePathTextField.setText(filePathText);
734                 fileNameTextField.setText(fileNameText);
735                 fileSizeTextField.setText(fileSizeText);
736                 setSelected(insertDefaultCheckBox, insertDefaultSelected);
737                 setEnabled(overrideInsertDefaultAction, overrideInsertEnabled);
738                 setSelected(overrideInsertDefaultCheckBox, overrideInsertSelected);
739                 setEnabled(insertOverrideAction, insertOverrideEnabled);
740                 setSelected(insertOverrideCheckBox, insertOverrideSelected);
741         }
742
743         //
744         // INTERFACE MouseListener
745         //
746
747         /**
748          * {@inheritDoc}
749          */
750         public void mouseClicked(MouseEvent mouseEvent) {
751                 maybeShowContextMenu(mouseEvent);
752         }
753
754         /**
755          * {@inheritDoc}
756          */
757         public void mouseEntered(MouseEvent mouseEvent) {
758                 /* ignore. */
759         }
760
761         /**
762          * {@inheritDoc}
763          */
764         public void mouseExited(MouseEvent mouseEvent) {
765                 /* ignore. */
766         }
767
768         /**
769          * {@inheritDoc}
770          */
771         public void mousePressed(MouseEvent mouseEvent) {
772                 maybeShowContextMenu(mouseEvent);
773         }
774
775         /**
776          * {@inheritDoc}
777          */
778         public void mouseReleased(MouseEvent mouseEvent) {
779                 maybeShowContextMenu(mouseEvent);
780         }
781
782         /**
783          * Tree cell renderer that takes care of certain display properties for
784          * project-specific stuff.
785          * 
786          * @author David ‘Bombe’ Roden &lt;bombe@freenetproject.org&gt;
787          */
788         private class FileCellRenderer extends DefaultTreeCellRenderer {
789
790                 /**
791                  * Empty constructor.
792                  */
793                 FileCellRenderer() {
794                         /* do nothing. */
795                 }
796
797                 /**
798                  * @see javax.swing.tree.TreeCellRenderer#getTreeCellRendererComponent(javax.swing.JTree,
799                  *      java.lang.Object, boolean, boolean, boolean, int, boolean)
800                  */
801                 @SuppressWarnings("synthetic-access")
802                 @Override
803                 public Component getTreeCellRendererComponent(JTree tree, Object value, boolean selected, boolean expanded, boolean leaf, int row, boolean hasFocus) {
804                         Component superCellRenderer = super.getTreeCellRendererComponent(tree, value, selected, expanded, leaf, row, hasFocus);
805                         if (!(superCellRenderer instanceof JLabel)) {
806                                 logger.log(Level.SEVERE, "superCellRenderer is not a JLabel!");
807                                 return superCellRenderer;
808                         }
809                         if (!(value instanceof ProjectFileWrapper)) {
810                                 logger.log(Level.SEVERE, "value is not a ProjectFileWrapper!");
811                                 return superCellRenderer;
812                         }
813                         ProjectFileWrapper projectFileWrapper = (ProjectFileWrapper) value;
814                         ProjectFile projectFile = projectFileWrapper.getProjectFile();
815                         FileOverride fileOverride = project.getFileOverride(projectFile);
816                         String completePath = projectFile.getCompletePath();
817                         boolean paintBold = false;
818                         boolean paintHalfColor = false;
819                         boolean showFile = !projectFile.isHidden();
820                         if (fileOverride != null) {
821                                 Boolean insertOverride = fileOverride.isInsert();
822                                 if (insertOverride != null) {
823                                         showFile = insertOverride;
824                                 }
825                         }
826                         if (projectFile.isFile() && !showFile) {
827                                 paintHalfColor = true;
828                         } else if (completePath.equals(project.getDefaultFile())) {
829                                 paintBold = true;
830                         } else if (projectFile.getParents().size() == 1) {
831                                 paintBold = true;
832                         }
833                         if (paintHalfColor) {
834                                 /* TODO - cache colors */
835                                 Color foreground = superCellRenderer.getForeground();
836                                 Color background = selected ? getBackgroundSelectionColor() : getBackgroundNonSelectionColor();
837                                 Color averageColor = new Color((foreground.getRed() + background.getRed()) / 2, (foreground.getGreen() + background.getGreen()) / 2, (foreground.getBlue() + background.getBlue()) / 2);
838                                 superCellRenderer.setForeground(averageColor);
839                         } else {
840                                 superCellRenderer.setForeground(selected ? getTextSelectionColor() : getTextNonSelectionColor());
841                         }
842                         if (paintBold) {
843                                 superCellRenderer.setFont(superCellRenderer.getFont().deriveFont(Font.BOLD));
844                         } else {
845                                 superCellRenderer.setFont(superCellRenderer.getFont().deriveFont(Font.PLAIN));
846                         }
847                         return superCellRenderer;
848                 }
849
850         }
851
852         /**
853          * TreeModel that is based on {@link Project#getBaseFile()}.
854          * 
855          * @author David ‘Bombe’ Roden &lt;bombe@freenetproject.org&gt;
856          */
857         private class ProjectFileTreeModel implements TreeModel, PropertyChangeListener {
858
859                 /** Tree model listeners. */
860                 private final List<TreeModelListener> treeModelListeners = Collections.synchronizedList(new ArrayList<TreeModelListener>());
861
862                 /** The base project file. */
863                 private ProjectFile baseProjectFile;
864
865                 /** Maps path names to project files. */
866                 private final Map<String, ProjectFile> pathProjectFiles = Collections.synchronizedMap(new HashMap<String, ProjectFile>());
867
868                 /** Maps project files to wrappers. */
869                 private final Map<ProjectFile, ProjectFileWrapper> projectFileWrappers = Collections.synchronizedMap(new HashMap<ProjectFile, ProjectFileWrapper>());
870
871                 /**
872                  * Empty constructor.
873                  */
874                 ProjectFileTreeModel() {
875                         /* do nothing. */
876                 }
877
878                 //
879                 // EVENT MANAGEMENT
880                 //
881
882                 /**
883                  * {@inheritDoc}
884                  */
885                 public void addTreeModelListener(TreeModelListener treeModelListener) {
886                         treeModelListeners.add(treeModelListener);
887                 }
888
889                 /**
890                  * {@inheritDoc}
891                  */
892                 public void removeTreeModelListener(TreeModelListener treeModelListener) {
893                         treeModelListeners.remove(treeModelListener);
894                 }
895
896                 /**
897                  * Notifies all listeners that a node has changed.
898                  * 
899                  * @param changedProjectFileWrapper
900                  *            The wrapper around the changed project file
901                  */
902                 protected void fireTreeNodesChanged(ProjectFileWrapper changedProjectFileWrapper) {
903                         ProjectFile changedProjectFile = changedProjectFileWrapper.getProjectFile();
904                         ProjectFile changedProjectFileParent = changedProjectFile.getParent();
905                         ProjectFile currentProjectFileParent = changedProjectFile;
906                         List<ProjectFileWrapper> parentProjectFileWrappers = new ArrayList<ProjectFileWrapper>();
907                         do {
908                                 parentProjectFileWrappers.add(0, projectFileWrappers.get(currentProjectFileParent));
909                                 currentProjectFileParent = currentProjectFileParent.getParent();
910                         } while (currentProjectFileParent != null);
911                         TreeModelEvent treeModelEvent = new TreeModelEvent(this, parentProjectFileWrappers.toArray(), new int[] { getIndexOfChild(projectFileWrappers.get(changedProjectFileParent), changedProjectFileWrapper) }, new Object[] { changedProjectFileWrapper });
912                         for (TreeModelListener treeModelListener : treeModelListeners) {
913                                 treeModelListener.treeNodesChanged(treeModelEvent);
914                         }
915                 }
916
917                 /**
918                  * Notifies all listeners that the tree structure has changed
919                  * significantly.
920                  * 
921                  * @see TreeModelListener#treeStructureChanged(TreeModelEvent)
922                  * @param newRootNode
923                  */
924                 protected void fireTreeStructureChanged(ProjectFileWrapper newRootNode) {
925                         for (TreeModelListener treeModelListener : treeModelListeners) {
926                                 treeModelListener.treeStructureChanged(new TreeModelEvent(this, new Object[] { newRootNode }));
927                         }
928                 }
929
930                 //
931                 // ACCESSORS
932                 //
933
934                 /**
935                  * Sets the new base project file. This causes the model to reload.
936                  * 
937                  * @param baseProjectFile
938                  *            The new base project file
939                  */
940                 @SuppressWarnings("synthetic-access")
941                 public synchronized void setBaseProjectFile(ProjectFile baseProjectFile) {
942                         this.baseProjectFile = baseProjectFile;
943                         projectFileWrappers.clear();
944                         pathProjectFiles.clear();
945                         createWrappers(baseProjectFile);
946                         projectFileWrappers.get(baseProjectFile).setNameOverride(project.getName());
947                         fireTreeStructureChanged(projectFileWrappers.get(baseProjectFile));
948                 }
949
950                 //
951                 // PRIVATE METHODS
952                 //
953
954                 /**
955                  * Creates {@link ProjectFileWrapper}s for all files below the given
956                  * project file.
957                  * 
958                  * @param projectFile
959                  *            The base project file for all project files to create
960                  *            wrappers for
961                  */
962                 private void createWrappers(ProjectFile projectFile) {
963                         projectFileWrappers.put(projectFile, new ProjectFileWrapper(projectFile));
964                         pathProjectFiles.put(projectFile.getCompletePath(), projectFile);
965                         for (ProjectFile projectFileChild : projectFile.getFiles()) {
966                                 if (projectFileChild.isDirectory()) {
967                                         createWrappers(projectFileChild);
968                                 }
969                                 projectFileWrappers.put(projectFileChild, new ProjectFileWrapper(projectFileChild));
970                                 pathProjectFiles.put(projectFileChild.getCompletePath(), projectFileChild);
971                         }
972                 }
973
974                 //
975                 // INTERFACE TreeModel
976                 //
977
978                 /**
979                  * {@inheritDoc}
980                  */
981                 public Object getRoot() {
982                         return projectFileWrappers.get(baseProjectFile);
983                 }
984
985                 /**
986                  * {@inheritDoc}
987                  */
988                 @SuppressWarnings("synthetic-access")
989                 public Object getChild(Object parent, int index) {
990                         if (!(parent instanceof ProjectFileWrapper)) {
991                                 logger.log(Level.SEVERE, "parent is not a ProjectFileWrapper!");
992                                 return null;
993                         }
994                         ProjectFileWrapper projectFileWrapper = (ProjectFileWrapper) parent;
995                         ProjectFile projectFile = projectFileWrapper.getProjectFile();
996                         return projectFileWrappers.get(projectFile.getFiles().get(index));
997                 }
998
999                 /**
1000                  * {@inheritDoc}
1001                  */
1002                 @SuppressWarnings("synthetic-access")
1003                 public int getChildCount(Object parent) {
1004                         if (!(parent instanceof ProjectFileWrapper)) {
1005                                 logger.log(Level.SEVERE, "parent is not a ProjectFileWrapper!");
1006                                 return -1;
1007                         }
1008                         ProjectFileWrapper projectFileWrapper = (ProjectFileWrapper) parent;
1009                         ProjectFile projectFile = projectFileWrapper.getProjectFile();
1010                         return projectFile.getFiles().size();
1011                 }
1012
1013                 /**
1014                  * {@inheritDoc}
1015                  */
1016                 @SuppressWarnings("synthetic-access")
1017                 public int getIndexOfChild(Object parent, Object child) {
1018                         if (!(parent instanceof ProjectFileWrapper)) {
1019                                 logger.log(Level.SEVERE, "parent is not a ProjectFileWrapper!");
1020                                 return -1;
1021                         }
1022                         if (!(child instanceof ProjectFileWrapper)) {
1023                                 logger.log(Level.SEVERE, "child is not a ProjectFileWrapper!");
1024                                 return -1;
1025                         }
1026                         ProjectFileWrapper projectFileWrapper = (ProjectFileWrapper) parent;
1027                         ProjectFile projectFile = projectFileWrapper.getProjectFile();
1028                         return projectFile.getFiles().indexOf(((ProjectFileWrapper) child).getProjectFile());
1029                 }
1030
1031                 /**
1032                  * {@inheritDoc}
1033                  */
1034                 @SuppressWarnings("synthetic-access")
1035                 public boolean isLeaf(Object node) {
1036                         if (!(node instanceof ProjectFileWrapper)) {
1037                                 logger.log(Level.SEVERE, "node is not a ProjectFileWrapper!");
1038                                 return true;
1039                         }
1040                         ProjectFileWrapper projectFileWrapper = (ProjectFileWrapper) node;
1041                         return projectFileWrapper.getProjectFile().isFile();
1042                 }
1043
1044                 /**
1045                  * {@inheritDoc}
1046                  */
1047                 public void valueForPathChanged(TreePath path, Object newValue) {
1048                         /* ignore, items will not be modified in tree. */
1049                 }
1050
1051                 //
1052                 // INTERFACE PropertyChangeListener
1053                 //
1054
1055                 /**
1056                  * @see java.beans.PropertyChangeListener#propertyChange(java.beans.PropertyChangeEvent)
1057                  */
1058                 @SuppressWarnings("synthetic-access")
1059                 public void propertyChange(PropertyChangeEvent propertyChangeEvent) {
1060                         if (Project.PROPERTY_DEFAULT_FILE.equals(propertyChangeEvent.getPropertyName())) {
1061                                 if (propertyChangeEvent.getOldValue() != null) {
1062                                         String oldCompletePath = (String) propertyChangeEvent.getOldValue();
1063                                         logger.log(Level.FINEST, "oldCompletePath: " + oldCompletePath);
1064                                         ProjectFile oldProjectFile = pathProjectFiles.get(oldCompletePath);
1065                                         logger.log(Level.FINEST, "oldProjectFile: " + oldProjectFile);
1066                                         ProjectFileWrapper oldProjectFileWrapper = projectFileWrappers.get(oldProjectFile);
1067                                         logger.log(Level.FINEST, "oldProjectFileWrapper: " + oldProjectFileWrapper);
1068                                         fireTreeNodesChanged(oldProjectFileWrapper);
1069                                 }
1070                                 String newCompletePath = (String) propertyChangeEvent.getNewValue();
1071                                 ProjectFile newProjectFile = pathProjectFiles.get(newCompletePath);
1072                                 ProjectFileWrapper newProjectFileWrapper = projectFileWrappers.get(newProjectFile);
1073                                 System.out.println("newProjectFileWrapper: " + newProjectFileWrapper);
1074                                 fireTreeNodesChanged(newProjectFileWrapper);
1075                                 /* HACK - swing sucks a bit. */
1076                                 fileTree.setShowsRootHandles(false);
1077                         }
1078                 }
1079
1080         }
1081
1082         /**
1083          * Wrapper around a {@link ProjectFile} that overwrites
1084          * {@link Object#toString()} to return the project file’s name.
1085          * 
1086          * @author David ‘Bombe’ Roden &lt;bombe@freenetproject.org&gt;
1087          */
1088         private static class ProjectFileWrapper {
1089
1090                 /** The wrapped project file. */
1091                 private final ProjectFile projectFile;
1092
1093                 /** The override name. */
1094                 private String nameOverride;
1095
1096                 /**
1097                  * Creates a new wrapper around a project file.
1098                  * 
1099                  * @param projectFile
1100                  *            The project file to wrap
1101                  */
1102                 public ProjectFileWrapper(ProjectFile projectFile) {
1103                         this.projectFile = projectFile;
1104                 }
1105
1106                 /**
1107                  * Returns the wrapped project file.
1108                  * 
1109                  * @return The wrapped project file
1110                  */
1111                 public ProjectFile getProjectFile() {
1112                         return projectFile;
1113                 }
1114
1115                 /**
1116                  * Sets the name override. If the name override is not <code>null</code>
1117                  * it will be shown insted of the project file’s name.
1118                  * 
1119                  * @param nameOverride
1120                  *            The name override
1121                  */
1122                 void setNameOverride(String nameOverride) {
1123                         this.nameOverride = nameOverride;
1124                 }
1125
1126                 /**
1127                  * {@inheritDoc}
1128                  */
1129                 @Override
1130                 public String toString() {
1131                         return (nameOverride != null) ? nameOverride : projectFile.getName();
1132                 }
1133
1134         }
1135
1136 }