/*******************************************************************************
* Copyright (c) 2005, 2006 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.commands;
import java.net.URL;
import java.util.ArrayList;
import java.util.List;
import org.eclipse.core.runtime.IConfigurationElement;
import org.eclipse.core.runtime.IExtensionDelta;
import org.eclipse.core.runtime.IExtensionRegistry;
import org.eclipse.core.runtime.IRegistryChangeEvent;
import org.eclipse.core.runtime.Platform;
import org.eclipse.ui.PlatformUI;
import org.eclipse.ui.commands.ICommandService;
import org.eclipse.ui.internal.registry.IWorkbenchRegistryConstants;
import org.eclipse.ui.internal.services.RegistryPersistence;
import org.eclipse.ui.internal.util.BundleUtility;
/**
* <p>
* Handles persistence for the command images.
* </p>
* <p>
* This class is only intended for internal use within the
* <code>org.eclipse.ui.workbench</code> plug-in.
* </p>
* <p>
* <strong>PROVISIONAL</strong>. This class or interface has been added as part
* of a work in progress. There is a guarantee neither that this API will work
* nor that it will remain the same. Please do not use this API without
* consulting with the Platform/UI team.
* </p>
*
* @since 3.2
*/
final class CommandImagePersistence extends RegistryPersistence {
/**
* The index of the image elements in the indexed array.
*
* @see CommandImagePersistence#read()
*/
private static final int INDEX_IMAGES = 0;
/**
* Reads all of the images from the command images extension point.
*
* @param configurationElements
* The configuration elements in the command images extension
* point; must not be <code>null</code>, but may be empty.
* @param configurationElementCount
* The number of configuration elements that are really in the
* array.
* @param commandImageManager
* The command image manager to which the images should be added;
* must not be <code>null</code>.
* @param commandService
* The command service for the workbench; must not be
* <code>null</code>.
*/
private static final void readImagesFromRegistry(
final IConfigurationElement[] configurationElements,
final int configurationElementCount,
final CommandImageManager commandImageManager,
final ICommandService commandService) {
// Undefine all the previous images.
commandImageManager.clear();
final List warningsToLog = new ArrayList(1);
for (int i = 0; i < configurationElementCount; i++) {
final IConfigurationElement configurationElement = configurationElements[i];
// Read out the command identifier.
final String commandId = readRequired(configurationElement,
ATT_COMMAND_ID, warningsToLog, "Image needs an id"); //$NON-NLS-1$
if (commandId == null) {
continue;
}
if (!commandService.getCommand(commandId).isDefined()) {
// Reference to an undefined command. This is invalid.
addWarning(warningsToLog,
"Cannot bind to an undefined command", //$NON-NLS-1$
configurationElement, commandId);
continue;
}
// Read out the style.
final String style = readOptional(configurationElement, ATT_STYLE);
// Read out the default icon.
final String icon = readRequired(configurationElement, ATT_ICON,
warningsToLog, commandId);
if (icon == null) {
continue;
}
final String disabledIcon = readOptional(configurationElement,
ATT_DISABLEDICON);
final String hoverIcon = readOptional(configurationElement,
ATT_HOVERICON);
final URL iconURL = BundleUtility.find(configurationElement
.getNamespace(), icon);
commandImageManager.bind(commandId,
CommandImageManager.TYPE_DEFAULT, style, iconURL);
if (disabledIcon != null) {
final URL disabledIconURL = BundleUtility.find(
configurationElement.getNamespace(), disabledIcon);
commandImageManager.bind(commandId,
CommandImageManager.TYPE_DISABLED, style,
disabledIconURL);
}
if (hoverIcon != null) {
final URL hoverIconURL = BundleUtility.find(
configurationElement.getNamespace(), hoverIcon);
commandImageManager.bind(commandId,
CommandImageManager.TYPE_HOVER, style, hoverIconURL);
}
}
logWarnings(
warningsToLog,
"Warnings while parsing the images from the 'org.eclipse.ui.commandImages' extension point."); //$NON-NLS-1$
}
/**
* The command image manager which should be populated with the values from
* the registry; must not be <code>null</code>.
*/
private final CommandImageManager commandImageManager;
/**
* The command service for the workbench; must not be <code>null</code>.
*/
private final ICommandService commandService;
/**
* Constructs a new instance of <code>CommandImagePersistence</code>.
*
* @param commandImageManager
* The command image manager which should be populated with the
* values from the registry; must not be <code>null</code>.
* @param commandService
* The command service for the workbench; must not be
* <code>null</code>.
*/
CommandImagePersistence(final CommandImageManager commandImageManager,
final ICommandService commandService) {
this.commandImageManager = commandImageManager;
this.commandService = commandService;
}
protected final boolean isChangeImportant(final IRegistryChangeEvent event) {
final IExtensionDelta[] imageDeltas = event.getExtensionDeltas(
PlatformUI.PLUGIN_ID,
IWorkbenchRegistryConstants.PL_COMMAND_IMAGES);
return (imageDeltas.length != 0);
}
/**
* Reads all of the command images from the registry.
*/
protected final void read() {
super.read();
// Create the extension registry mementos.
final IExtensionRegistry registry = Platform.getExtensionRegistry();
int imageCount = 0;
final IConfigurationElement[][] indexedConfigurationElements = new IConfigurationElement[1][];
// Sort the commands extension point based on element name.
final IConfigurationElement[] commandImagesExtensionPoint = registry
.getConfigurationElementsFor(EXTENSION_COMMAND_IMAGES);
for (int i = 0; i < commandImagesExtensionPoint.length; i++) {
final IConfigurationElement configurationElement = commandImagesExtensionPoint[i];
final String name = configurationElement.getName();
// Check if it is a binding definition.
if (TAG_IMAGE.equals(name)) {
addElementToIndexedArray(configurationElement,
indexedConfigurationElements, INDEX_IMAGES,
imageCount++);
}
}
readImagesFromRegistry(indexedConfigurationElements[INDEX_IMAGES],
imageCount, commandImageManager, commandService);
}
}