Bug 87951 - [ViewMgmt] View registry API exposes internal Category class

Bug 79324 - [DynamicUI] If view and perspective descriptors go away, their handlers are never disposed

2 files changed, 56 insertions, 2 deletions

diff --git a/bundles/org.eclipse.ui.workbench/Eclipse UI/org/eclipse/ui/views/IViewCategory.java b/bundles/org.eclipse.ui.workbench/Eclipse UI/org/eclipse/ui/views/IViewCategory.java
new file mode 100644
index 00000000000..85e735b64dd
--- /dev/null
+++ b/bundles/org.eclipse.ui.workbench/Eclipse UI/org/eclipse/ui/views/IViewCategory.java
@@ -0,0 +1,55 @@
+/*******************************************************************************
+ * Copyright (c) 2005 IBM Corporation and others.
+ * 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:
+ *     IBM Corporation - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.ui.views;
+
+import org.eclipse.core.runtime.IPath;
+
+/**
+ * Represents a categorization of views.
+ * 
+ * <p>
+ * This interface is not intended to be implemented by clients.
+ * </p>
+ * 
+ * @since 3.1
+ */
+public interface IViewCategory {
+
+    /**
+     * Return the views contained within this category. Never <code>null</code>,
+     * but may be empty.
+     * 
+     * @return the views contained within this category
+     */
+    IViewDescriptor[] getViews();
+
+    /**
+     * Return the id of this category.  Never <code>null</code>.
+     * 
+     * @return the id
+     */
+    String getId();
+
+    /**
+     * Return the human readable name of this view category.  Never <code>null</code>.
+     * 
+     * @return the label
+     */
+    String getLabel();
+
+    /**
+     * Return this categories path. The segments of this path will correspond to
+     * category ids.
+     * 
+     * @return the path
+     */
+    IPath getPath();
+}
diff --git a/bundles/org.eclipse.ui.workbench/Eclipse UI/org/eclipse/ui/views/IViewRegistry.java b/bundles/org.eclipse.ui.workbench/Eclipse UI/org/eclipse/ui/views/IViewRegistry.java
index ddca01ac016..be9c7e7c36c 100644
--- a/bundles/org.eclipse.ui.workbench/Eclipse UI/org/eclipse/ui/views/IViewRegistry.java
+++ b/bundles/org.eclipse.ui.workbench/Eclipse UI/org/eclipse/ui/views/IViewRegistry.java
@@ -10,7 +10,6 @@
  *******************************************************************************/
 package org.eclipse.ui.views;
 
-import org.eclipse.ui.internal.registry.Category;
 
 /**
  * The view registry maintains a list of views explicitly registered
@@ -41,7 +40,7 @@ public interface IViewRegistry {
      * 
      * @return the categories.  Never <code>null</code>.
      */
-    public Category[] getCategories();
+    public IViewCategory[] getCategories();
 
     /**
      * Return a list of views defined in the registry.