bundles/org.eclipse.ui.ide/src/org/eclipse/ui/internal/ide/IDEWorkbenchPlugin.java - platform/eclipse.platform.ui - Git at Google

 /*******************************************************************************
  * Copyright (c) 2000, 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.internal.ide;

 import java.text.MessageFormat;
 import java.util.ArrayList;
 import java.util.List;

 import org.eclipse.core.resources.IWorkspace;
 import org.eclipse.core.resources.ResourcesPlugin;
 import org.eclipse.core.runtime.CoreException;
 import org.eclipse.core.runtime.IBundleGroup;
 import org.eclipse.core.runtime.IBundleGroupProvider;
 import org.eclipse.core.runtime.IConfigurationElement;
 import org.eclipse.core.runtime.IProduct;
 import org.eclipse.core.runtime.IStatus;
 import org.eclipse.core.runtime.Platform;
 import org.eclipse.jface.resource.ImageDescriptor;
 import org.eclipse.swt.custom.BusyIndicator;
 import org.eclipse.ui.internal.ide.registry.CapabilityRegistry;
 import org.eclipse.ui.internal.ide.registry.MarkerImageProviderRegistry;
 import org.eclipse.ui.internal.ide.registry.ProjectImageRegistry;
 import org.eclipse.ui.plugin.AbstractUIPlugin;
 import org.osgi.framework.Bundle;

 /**
  * This internal class represents the top of the IDE workbench.
  *
  * This class is responsible for tracking various registries
  * font, preference, graphics, dialog store.
  *
  * This class is explicitly referenced by the
  * IDE workbench plug-in's  "plugin.xml"
  *
  * @since 3.0
  */
 public class IDEWorkbenchPlugin extends AbstractUIPlugin {
     // Default instance of the receiver
     private static IDEWorkbenchPlugin inst;

     // Global workbench ui plugin flag. Only workbench implementation is allowed to use this flag
     // All other plugins, examples, or test cases must *not* use this flag.
     public static boolean DEBUG = false;

     /**
      * The IDE workbench plugin ID.
      */
     public static final String IDE_WORKBENCH = "org.eclipse.ui.ide"; //$NON-NLS-1$

     /**
      * The ID of the default text editor.
      * This must correspond to EditorsUI.DEFAULT_TEXT_EDITOR_ID.
      */
     public static final String DEFAULT_TEXT_EDITOR_ID = "org.eclipse.ui.DefaultTextEditor"; //$NON-NLS-1$

     // IDE workbench extension point names
     public static final String PL_MARKER_IMAGE_PROVIDER = "markerImageProviders"; //$NON-NLS-1$

     public static final String PL_MARKER_HELP = "markerHelp"; //$NON-NLS-1$

     public static final String PL_MARKER_RESOLUTION = "markerResolution"; //$NON-NLS-1$

     public static final String PL_CAPABILITIES = "capabilities"; //$NON-NLS-1$

     public static final String PL_PROJECT_NATURE_IMAGES = "projectNatureImages"; //$NON-NLS-1$

 	private final static String ICONS_PATH = "$nl$/icons/full/";//$NON-NLS-1$

     /**
      * Project image registry; lazily initialized.
      */
     private ProjectImageRegistry projectImageRegistry = null;

     /**
      * Marker image registry; lazily initialized.
      */
     private MarkerImageProviderRegistry markerImageProviderRegistry = null;

     /**
      * Capability registry; lazily initialized.
      */
     private CapabilityRegistry capabilityRegistry;


 	/**
 	 * Create an instance of the receiver.
 	 */
 	public IDEWorkbenchPlugin() {
 		super();
 		inst = this;
 	}
     /**
      * Creates an extension.  If the extension plugin has not
      * been loaded a busy cursor will be activated during the duration of
      * the load.
      *
      * @param element the config element defining the extension
      * @param classAttribute the name of the attribute carrying the class
      * @return Object the extension object
      * @throws CoreException
      */
     public static Object createExtension(final IConfigurationElement element,
 			final String classAttribute) throws CoreException {
 		// If plugin has been loaded create extension.
 		// Otherwise, show busy cursor then create extension.
 		Bundle plugin = Platform.getBundle(element.getNamespace());
 		if (plugin.getState() == Bundle.ACTIVE) {
 			return element.createExecutableExtension(classAttribute);
 		} else {
             final Object[] ret = new Object[1];
             final CoreException[] exc = new CoreException[1];
             BusyIndicator.showWhile(null, new Runnable() {
                 public void run() {
                     try {
                         ret[0] = element
                                 .createExecutableExtension(classAttribute);
                     } catch (CoreException e) {
                         exc[0] = e;
                     }
                 }
             });
             if (exc[0] != null)
                 throw exc[0];
             else
                 return ret[0];
         }
     }

     /* Return the default instance of the receiver. This represents the runtime plugin.
      *
      * @see AbstractPlugin for the typical implementation pattern for plugin classes.
      */
     public static IDEWorkbenchPlugin getDefault() {
         return inst;
     }

     /**
      * Return the workspace used by the workbench
      *
      * This method is internal to the workbench and must not be called
      * by any plugins.
      */
     public static IWorkspace getPluginWorkspace() {
         return ResourcesPlugin.getWorkspace();
     }

     /**
      * Logs the given message to the platform log.
      *
      * If you have an exception in hand, call log(String, Throwable) instead.
      *
      * If you have a status object in hand call log(String, IStatus) instead.
      *
      * This convenience method is for internal use by the IDE Workbench only and
      * must not be called outside the IDE Workbench.
      *
      * @param message
      *            A high level UI message describing when the problem happened.
      */
     public static void log(String message) {
         getDefault().getLog().log(
                 StatusUtil.newStatus(IStatus.ERROR, message, null));
     }

     /**
      * Logs the given message and throwable to the platform log.
      *
      * If you have a status object in hand call log(String, IStatus) instead.
      *
      * This convenience method is for internal use by the IDE Workbench only and
      * must not be called outside the IDE Workbench.
      *
      * @param message
      *            A high level UI message describing when the problem happened.
      * @param t
      *            The throwable from where the problem actually occurred.
      */
     public static void log(String message, Throwable t) {
         IStatus status = StatusUtil.newStatus(IStatus.ERROR, message, t);
         log(message, status);
     }

     /**
      * Logs the given throwable to the platform log, indicating the class and
      * method from where it is being logged (this is not necessarily where it
      * occurred).
      *
      * This convenience method is for internal use by the IDE Workbench only and
      * must not be called outside the IDE Workbench.
      *
      * @param clazz
      *            The calling class.
      * @param methodName
      *            The calling method name.
      * @param t
      *            The throwable from where the problem actually occurred.
      */
     public static void log(Class clazz, String methodName, Throwable t) {
         String msg = MessageFormat.format("Exception in {0}.{1}: {2}", //$NON-NLS-1$
                 new Object[] { clazz.getName(), methodName, t });
         log(msg, t);
     }

     /**
      * Logs the given message and status to the platform log.
      *
      * This convenience method is for internal use by the IDE Workbench only and
      * must not be called outside the IDE Workbench.
      *
      * @param message
      *            A high level UI message describing when the problem happened.
      *            May be <code>null</code>.
      * @param status
      *            The status describing the problem. Must not be null.
      */
     public static void log(String message, IStatus status) {

         //1FTUHE0: ITPCORE:ALL - API - Status & logging - loss of semantic info

         if (message != null) {
             getDefault().getLog().log(
                     StatusUtil.newStatus(IStatus.ERROR, message, null));
         }

         getDefault().getLog().log(status);
     }

     /* (non-javadoc)
      * Method declared on AbstractUIPlugin
      */
     protected void refreshPluginActions() {
         // do nothing
     }


     /**
      * Return the manager that maps project nature ids to images.
      */
     public ProjectImageRegistry getProjectImageRegistry() {
         if (projectImageRegistry == null) {
             projectImageRegistry = new ProjectImageRegistry();
             projectImageRegistry.load();
         }
         return projectImageRegistry;
     }

     /**
      * Returns the marker image provider registry for the workbench.
      *
      * @return the marker image provider registry
      */
     public MarkerImageProviderRegistry getMarkerImageProviderRegistry() {
         if (markerImageProviderRegistry == null) {
             markerImageProviderRegistry = new MarkerImageProviderRegistry();
         }
         return markerImageProviderRegistry;
     }

     /**
      * Returns the capability registry for the workbench.
      *
      * @return the capability registry
      */
     public CapabilityRegistry getCapabilityRegistry() {
         if (capabilityRegistry == null) {
             capabilityRegistry = new CapabilityRegistry();
             capabilityRegistry.load();
         }
         return capabilityRegistry;
     }

     /**
      * Returns the about information of all known features,
      * omitting any features which are missing this information.
      *
      * @return a possibly empty list of about infos
      */
     public AboutInfo[] getFeatureInfos() {
         // cannot be cached since bundle groups come and go
         List infos = new ArrayList();

         // add an entry for each bundle group
         IBundleGroupProvider[] providers = Platform.getBundleGroupProviders();
         if (providers != null)
             for (int i = 0; i < providers.length; ++i) {
                 IBundleGroup[] bundleGroups = providers[i].getBundleGroups();
                 for (int j = 0; j < bundleGroups.length; ++j)
                     infos.add(new AboutInfo(bundleGroups[j]));
             }

         return (AboutInfo[]) infos.toArray(new AboutInfo[infos.size()]);
     }

     /**
      * Returns the about information of the primary feature.
      *
      * @return info about the primary feature, or <code>null</code> if there
      * is no primary feature or if this information is unavailable
      */
     public AboutInfo getPrimaryInfo() {
         IProduct product = Platform.getProduct();
         return product == null ? null : new AboutInfo(product);
     }

 	/**
 	 * Get the workbench image with the given path relative to
 	 * ICON_PATH.
 	 * @param relativePath
 	 * @return ImageDescriptor
 	 */
 	public static ImageDescriptor getIDEImageDescriptor(String relativePath){
 		return imageDescriptorFromPlugin(IDE_WORKBENCH, ICONS_PATH + relativePath);
 	}


 }
	/*******************************************************************************
	* Copyright (c) 2000, 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.internal.ide;

	import java.text.MessageFormat;
	import java.util.ArrayList;
	import java.util.List;

	import org.eclipse.core.resources.IWorkspace;
	import org.eclipse.core.resources.ResourcesPlugin;
	import org.eclipse.core.runtime.CoreException;
	import org.eclipse.core.runtime.IBundleGroup;
	import org.eclipse.core.runtime.IBundleGroupProvider;
	import org.eclipse.core.runtime.IConfigurationElement;
	import org.eclipse.core.runtime.IProduct;
	import org.eclipse.core.runtime.IStatus;
	import org.eclipse.core.runtime.Platform;
	import org.eclipse.jface.resource.ImageDescriptor;
	import org.eclipse.swt.custom.BusyIndicator;
	import org.eclipse.ui.internal.ide.registry.CapabilityRegistry;
	import org.eclipse.ui.internal.ide.registry.MarkerImageProviderRegistry;
	import org.eclipse.ui.internal.ide.registry.ProjectImageRegistry;
	import org.eclipse.ui.plugin.AbstractUIPlugin;
	import org.osgi.framework.Bundle;

	/**
	* This internal class represents the top of the IDE workbench.
	*
	* This class is responsible for tracking various registries
	* font, preference, graphics, dialog store.
	*
	* This class is explicitly referenced by the
	* IDE workbench plug-in's "plugin.xml"
	*
	* @since 3.0
	*/
	public class IDEWorkbenchPlugin extends AbstractUIPlugin {
	// Default instance of the receiver
	private static IDEWorkbenchPlugin inst;

	// Global workbench ui plugin flag. Only workbench implementation is allowed to use this flag
	// All other plugins, examples, or test cases must not use this flag.
	public static boolean DEBUG = false;

	/**
	* The IDE workbench plugin ID.
	*/
	public static final String IDE_WORKBENCH = "org.eclipse.ui.ide"; //$NON-NLS-1$

	/**
	* The ID of the default text editor.
	* This must correspond to EditorsUI.DEFAULT_TEXT_EDITOR_ID.
	*/
	public static final String DEFAULT_TEXT_EDITOR_ID = "org.eclipse.ui.DefaultTextEditor"; //$NON-NLS-1$

	// IDE workbench extension point names
	public static final String PL_MARKER_IMAGE_PROVIDER = "markerImageProviders"; //$NON-NLS-1$

	public static final String PL_MARKER_HELP = "markerHelp"; //$NON-NLS-1$

	public static final String PL_MARKER_RESOLUTION = "markerResolution"; //$NON-NLS-1$

	public static final String PL_CAPABILITIES = "capabilities"; //$NON-NLS-1$

	public static final String PL_PROJECT_NATURE_IMAGES = "projectNatureImages"; //$NON-NLS-1$

	private final static String ICONS_PATH = "$nl$/icons/full/";//$NON-NLS-1$

	/**
	* Project image registry; lazily initialized.
	*/
	private ProjectImageRegistry projectImageRegistry = null;

	/**
	* Marker image registry; lazily initialized.
	*/
	private MarkerImageProviderRegistry markerImageProviderRegistry = null;

	/**
	* Capability registry; lazily initialized.
	*/
	private CapabilityRegistry capabilityRegistry;


	/**
	* Create an instance of the receiver.
	*/
	public IDEWorkbenchPlugin() {
	super();
	inst = this;
	}
	/**
	* Creates an extension. If the extension plugin has not
	* been loaded a busy cursor will be activated during the duration of
	* the load.
	*
	* @param element the config element defining the extension
	* @param classAttribute the name of the attribute carrying the class
	* @return Object the extension object
	* @throws CoreException
	*/
	public static Object createExtension(final IConfigurationElement element,
	final String classAttribute) throws CoreException {
	// If plugin has been loaded create extension.
	// Otherwise, show busy cursor then create extension.
	Bundle plugin = Platform.getBundle(element.getNamespace());
	if (plugin.getState() == Bundle.ACTIVE) {
	return element.createExecutableExtension(classAttribute);
	} else {
	final Object[] ret = new Object[1];
	final CoreException[] exc = new CoreException[1];
	BusyIndicator.showWhile(null, new Runnable() {
	public void run() {
	try {
	ret[0] = element
	.createExecutableExtension(classAttribute);
	} catch (CoreException e) {
	exc[0] = e;
	}
	}
	});
	if (exc[0] != null)
	throw exc[0];
	else
	return ret[0];
	}
	}

	/* Return the default instance of the receiver. This represents the runtime plugin.
	*
	* @see AbstractPlugin for the typical implementation pattern for plugin classes.
	*/
	public static IDEWorkbenchPlugin getDefault() {
	return inst;
	}

	/**
	* Return the workspace used by the workbench
	*
	* This method is internal to the workbench and must not be called
	* by any plugins.
	*/
	public static IWorkspace getPluginWorkspace() {
	return ResourcesPlugin.getWorkspace();
	}

	/**
	* Logs the given message to the platform log.
	*
	* If you have an exception in hand, call log(String, Throwable) instead.
	*
	* If you have a status object in hand call log(String, IStatus) instead.
	*
	* This convenience method is for internal use by the IDE Workbench only and
	* must not be called outside the IDE Workbench.
	*
	* @param message
	* A high level UI message describing when the problem happened.
	*/
	public static void log(String message) {
	getDefault().getLog().log(
	StatusUtil.newStatus(IStatus.ERROR, message, null));
	}

	/**
	* Logs the given message and throwable to the platform log.
	*
	* If you have a status object in hand call log(String, IStatus) instead.
	*
	* This convenience method is for internal use by the IDE Workbench only and
	* must not be called outside the IDE Workbench.
	*
	* @param message
	* A high level UI message describing when the problem happened.
	* @param t
	* The throwable from where the problem actually occurred.
	*/
	public static void log(String message, Throwable t) {
	IStatus status = StatusUtil.newStatus(IStatus.ERROR, message, t);
	log(message, status);
	}

	/**
	* Logs the given throwable to the platform log, indicating the class and
	* method from where it is being logged (this is not necessarily where it
	* occurred).
	*
	* This convenience method is for internal use by the IDE Workbench only and
	* must not be called outside the IDE Workbench.
	*
	* @param clazz
	* The calling class.
	* @param methodName
	* The calling method name.
	* @param t
	* The throwable from where the problem actually occurred.
	*/
	public static void log(Class clazz, String methodName, Throwable t) {
	String msg = MessageFormat.format("Exception in {0}.{1}: {2}", //$NON-NLS-1$
	new Object[] { clazz.getName(), methodName, t });
	log(msg, t);
	}

	/**
	* Logs the given message and status to the platform log.
	*
	* This convenience method is for internal use by the IDE Workbench only and
	* must not be called outside the IDE Workbench.
	*
	* @param message
	* A high level UI message describing when the problem happened.
	* May be <code>null</code>.
	* @param status
	* The status describing the problem. Must not be null.
	*/
	public static void log(String message, IStatus status) {

	//1FTUHE0: ITPCORE:ALL - API - Status & logging - loss of semantic info

	if (message != null) {
	getDefault().getLog().log(
	StatusUtil.newStatus(IStatus.ERROR, message, null));
	}

	getDefault().getLog().log(status);
	}

	/* (non-javadoc)
	* Method declared on AbstractUIPlugin
	*/
	protected void refreshPluginActions() {
	// do nothing
	}


	/**
	* Return the manager that maps project nature ids to images.
	*/
	public ProjectImageRegistry getProjectImageRegistry() {
	if (projectImageRegistry == null) {
	projectImageRegistry = new ProjectImageRegistry();
	projectImageRegistry.load();
	}
	return projectImageRegistry;
	}

	/**
	* Returns the marker image provider registry for the workbench.
	*
	* @return the marker image provider registry
	*/
	public MarkerImageProviderRegistry getMarkerImageProviderRegistry() {
	if (markerImageProviderRegistry == null) {
	markerImageProviderRegistry = new MarkerImageProviderRegistry();
	}
	return markerImageProviderRegistry;
	}

	/**
	* Returns the capability registry for the workbench.
	*
	* @return the capability registry
	*/
	public CapabilityRegistry getCapabilityRegistry() {
	if (capabilityRegistry == null) {
	capabilityRegistry = new CapabilityRegistry();
	capabilityRegistry.load();
	}
	return capabilityRegistry;
	}

	/**
	* Returns the about information of all known features,
	* omitting any features which are missing this information.
	*
	* @return a possibly empty list of about infos
	*/
	public AboutInfo[] getFeatureInfos() {
	// cannot be cached since bundle groups come and go
	List infos = new ArrayList();

	// add an entry for each bundle group
	IBundleGroupProvider[] providers = Platform.getBundleGroupProviders();
	if (providers != null)
	for (int i = 0; i < providers.length; ++i) {
	IBundleGroup[] bundleGroups = providers[i].getBundleGroups();
	for (int j = 0; j < bundleGroups.length; ++j)
	infos.add(new AboutInfo(bundleGroups[j]));
	}

	return (AboutInfo[]) infos.toArray(new AboutInfo[infos.size()]);
	}

	/**
	* Returns the about information of the primary feature.
	*
	* @return info about the primary feature, or <code>null</code> if there
	* is no primary feature or if this information is unavailable
	*/
	public AboutInfo getPrimaryInfo() {
	IProduct product = Platform.getProduct();
	return product == null ? null : new AboutInfo(product);
	}

	/**
	* Get the workbench image with the given path relative to
	* ICON_PATH.
	* @param relativePath
	* @return ImageDescriptor
	*/
	public static ImageDescriptor getIDEImageDescriptor(String relativePath){
	return imageDescriptorFromPlugin(IDE_WORKBENCH, ICONS_PATH + relativePath);
	}


	}