tmf: Update copyright headers in tmf.ui
[deliverable/tracecompass.git] / org.eclipse.linuxtools.tmf.ui / src / org / eclipse / linuxtools / tmf / ui / project / model / TmfProjectModelElement.java
index ab626f95b4f04c57bc8ff24454515b8efb92f056..39f0b84f7a64f489ce4c965d49da8e34dfbbbaeb 100644 (file)
@@ -1,13 +1,14 @@
 /*******************************************************************************
- * Copyright (c) 2010 Ericsson
- * 
+ * Copyright (c) 2010, 2013 Ericsson
+ *
  * All rights reserved. This program and the accompanying materials are
  * made available under the terms of the Eclipse Public License v1.0 which
  * accompanies this distribution, and is available at
  * http://www.eclipse.org/legal/epl-v10.html
- * 
+ *
  * Contributors:
  *   Francois Chouinard - Initial API and implementation
+ *   Bernd Hufmann - Added supplementary files/folder handling
  *******************************************************************************/
 
 package org.eclipse.linuxtools.tmf.ui.project.model;
@@ -29,8 +30,11 @@ import org.eclipse.linuxtools.internal.tmf.ui.Activator;
 import org.eclipse.linuxtools.tmf.core.TmfCommonConstants;
 
 /**
- * <b><u>TmfProjectModelElement</u></b>
+ * The implementation of the base TMF project model element. It provides default implementation
+ * of the <code>ITmfProjectModelElement</code> interface.
  * <p>
+ * @version 1.0
+ * @author Francois Chouinard
  */
 public abstract class TmfProjectModelElement implements ITmfProjectModelElement, IResourceChangeListener {
 
@@ -39,16 +43,35 @@ public abstract class TmfProjectModelElement implements ITmfProjectModelElement,
     // ------------------------------------------------------------------------
 
     private final String fName;
+    /**
+     * The project model element resource.
+     */
     protected final IResource fResource;
+    /**
+     * The project model resource location (URI)
+     */
     protected final URI fLocation;
+    /**
+     * The project model path of a resource.
+     */
     protected final IPath fPath;
     private final ITmfProjectModelElement fParent;
+    /**
+     * The list of children elements.
+     */
     protected final List<ITmfProjectModelElement> fChildren;
 
     // ------------------------------------------------------------------------
     // Constructor
     // ------------------------------------------------------------------------
-
+    /**
+     * Constructor.
+     *
+     * Creates a base project model element.
+     * @param name The name of the element.
+     * @param resource The element resource.
+     * @param parent The parent model element.
+     */
     protected TmfProjectModelElement(String name, IResource resource, ITmfProjectModelElement parent) {
         fName = name;
         fResource = resource;
@@ -59,56 +82,93 @@ public abstract class TmfProjectModelElement implements ITmfProjectModelElement,
         ResourcesPlugin.getWorkspace().addResourceChangeListener(this);
     }
 
+    private void dispose() {
+        ResourcesPlugin.getWorkspace().removeResourceChangeListener(this);
+    }
+
     // ------------------------------------------------------------------------
     // ITmfProjectModelElement
     // ------------------------------------------------------------------------
-
+    /*
+     * (non-Javadoc)
+     * @see org.eclipse.linuxtools.tmf.ui.project.model.ITmfProjectModelElement#getName()
+     */
     @Override
     public String getName() {
         return fName;
     }
-
+    /*
+     * (non-Javadoc)
+     * @see org.eclipse.linuxtools.tmf.ui.project.model.ITmfProjectModelElement#getResource()
+     */
     @Override
     public IResource getResource() {
         return fResource;
     }
-
+    /*
+     * (non-Javadoc)
+     * @see org.eclipse.linuxtools.tmf.ui.project.model.ITmfProjectModelElement#getPath()
+     */
     @Override
     public IPath getPath() {
         return fPath;
     }
-
+    /*
+     * (non-Javadoc)
+     * @see org.eclipse.linuxtools.tmf.ui.project.model.ITmfProjectModelElement#getLocation()
+     */
     @Override
     public URI getLocation() {
         return fLocation;
     }
-
+    /*
+     * (non-Javadoc)
+     * @see org.eclipse.linuxtools.tmf.ui.project.model.ITmfProjectModelElement#getParent()
+     */
     @Override
     public ITmfProjectModelElement getParent() {
         return fParent;
     }
-
+    /*
+     * (non-Javadoc)
+     * @see org.eclipse.linuxtools.tmf.ui.project.model.ITmfProjectModelElement#hasChildren()
+     */
     @Override
     public boolean hasChildren() {
         return fChildren.size() > 0;
     }
-
+    /*
+     * (non-Javadoc)
+     * @see org.eclipse.linuxtools.tmf.ui.project.model.ITmfProjectModelElement#getChildren()
+     */
     @Override
     public List<ITmfProjectModelElement> getChildren() {
         return fChildren;
     }
-
+    /*
+     * (non-Javadoc)
+     * @see org.eclipse.linuxtools.tmf.ui.project.model.ITmfProjectModelElement#addChild(org.eclipse.linuxtools.tmf.ui.project.model.ITmfProjectModelElement)
+     */
     @Override
     public void addChild(ITmfProjectModelElement child) {
         fChildren.add(child);
     }
-
+    /*
+     * (non-Javadoc)
+     * @see org.eclipse.linuxtools.tmf.ui.project.model.ITmfProjectModelElement#removeChild(org.eclipse.linuxtools.tmf.ui.project.model.ITmfProjectModelElement)
+     */
     @Override
     public void removeChild(ITmfProjectModelElement child) {
         fChildren.remove(child);
+        if (child instanceof TmfProjectModelElement) {
+            ((TmfProjectModelElement) child).dispose();
+        }
         refresh();
     }
-
+    /*
+     * (non-Javadoc)
+     * @see org.eclipse.linuxtools.tmf.ui.project.model.ITmfProjectModelElement#refresh()
+     */
     @Override
     public void refresh() {
         // Do nothing by default: sub-classes override this on an "as-needed"
@@ -118,7 +178,10 @@ public abstract class TmfProjectModelElement implements ITmfProjectModelElement,
     // ------------------------------------------------------------------------
     // IResourceChangeListener
     // ------------------------------------------------------------------------
-
+    /*
+     * (non-Javadoc)
+     * @see org.eclipse.core.resources.IResourceChangeListener#resourceChanged(org.eclipse.core.resources.IResourceChangeEvent)
+     */
     @Override
     public void resourceChanged(IResourceChangeEvent event) {
         // Do nothing by default: sub-classes override this on an "as-needed"
@@ -128,34 +191,40 @@ public abstract class TmfProjectModelElement implements ITmfProjectModelElement,
     // ------------------------------------------------------------------------
     // Object
     // ------------------------------------------------------------------------
-
+    /*
+     * (non-Javadoc)
+     * @see java.lang.Object#hashCode()
+     */
     @Override
     public int hashCode() {
         final int prime = 31;
         int result = 1;
-        result = prime * result + ((fLocation == null) ? 0 : fLocation.hashCode());
-        result = prime * result + ((fName == null) ? 0 : fName.hashCode());
         result = prime * result + ((fPath == null) ? 0 : fPath.hashCode());
         return result;
     }
-
+    /*
+     * (non-Javadoc)
+     * @see java.lang.Object#equals(java.lang.Object)
+     */
     @Override
     public boolean equals(Object other) {
-        if (this == other)
+        if (this == other) {
             return true;
-        if (other == null)
+        }
+        if (other == null) {
             return false;
-        if (!(other instanceof TmfProjectModelElement))
+        }
+        if (!(other instanceof TmfProjectModelElement)) {
             return false;
+        }
         TmfProjectModelElement element = (TmfProjectModelElement) other;
-        return element.fName.equals(fName) && element.fLocation.equals(fLocation);
+        return element.fPath.equals(fPath);
     }
 
-    
     /**
      * Returns the trace specific supplementary directory under the project's supplementary folder.
-     * The folder will be created if it doesn't exist. 
-     * 
+     * The folder will be created if it doesn't exist.
+     *
      * @param supplFoldername - folder name.
      * @return returns the trace specific supplementary directory
      */
@@ -166,12 +235,12 @@ public abstract class TmfProjectModelElement implements ITmfProjectModelElement,
 
     /**
      * Returns the supplementary folder for this project
-     * 
-     * @return the supplementary folder for this project  
+     *
+     * @return the supplementary folder for this project
      */
     public IFolder getSupplementaryFolderParent() {
         TmfProjectElement project = getProject();
-        IProject projectResource = (IProject)project.getResource();
+        IProject projectResource = project.getResource();
         IFolder supplFolderParent = projectResource.getFolder(TmfCommonConstants.TRACE_SUPPLEMENATARY_FOLDER_NAME);
 
         if (!supplFolderParent.exists()) {
This page took 0.027174 seconds and 5 git commands to generate.