blob: 22c752441b4881ae5d899468a7ebdfc8df270fe5 [file] [log] [blame]
/*******************************************************************************
* Copyright (c) 2005, 2008 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
* Wind River Systems - added saving and restoring properties
*******************************************************************************/
package org.eclipse.debug.internal.ui.viewers.model.provisional;
import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;
import java.util.Set;
import java.util.Map.Entry;
import org.eclipse.core.runtime.ListenerList;
import org.eclipse.core.runtime.SafeRunner;
import org.eclipse.jface.util.IPropertyChangeListener;
import org.eclipse.jface.util.PropertyChangeEvent;
import org.eclipse.jface.util.SafeRunnable;
import org.eclipse.ui.IElementFactory;
import org.eclipse.ui.IMemento;
import org.eclipse.ui.IPersistableElement;
import org.eclipse.ui.PlatformUI;
/**
* Presentation context.
* <p>
* Clients may instantiate and subclass this class.
* </p>
* @since 3.2
*/
public class PresentationContext implements IPresentationContext {
private static final String PRESENTATION_CONTEXT_PROPERTIES = "PRESENTATION_CONTEXT_PROPERTIES"; //$NON-NLS-1$
private static final String BOOLEAN = "BOOLEAN"; //$NON-NLS-1$
private static final String STRING = "STRING"; //$NON-NLS-1$
private static final String INTEGER = "INTEGER"; //$NON-NLS-1$
private static final String PERSISTABLE = "PERSISTABLE"; //$NON-NLS-1$
private String fId;
private ListenerList fListeners = new ListenerList();
private Map fProperties = new HashMap();
/**
* Constructs a presentation context for the given id.
*
* @param id presentation context id
*/
public PresentationContext(String id) {
fId = id;
}
/* (non-Javadoc)
* @see org.eclipse.debug.internal.ui.viewers.provisional.IPresentationContext#getColumns()
*/
public String[] getColumns() {
return (String[]) getProperty(IPresentationContext.PROPERTY_COLUMNS);
}
/**
* Fires a property change event to all registered listeners
*
* @param property property name
* @param oldValue old value or <code>null</code>
* @param newValue new value or <code>null</code>
*/
protected void firePropertyChange(String property, Object oldValue, Object newValue) {
if (!fListeners.isEmpty()) {
final PropertyChangeEvent event = new PropertyChangeEvent(this, property, oldValue, newValue);
Object[] listeners = fListeners.getListeners();
for (int i = 0; i < listeners.length; i++) {
final IPropertyChangeListener listener = (IPropertyChangeListener) listeners[i];
SafeRunner.run(new SafeRunnable() {
public void run() throws Exception {
listener.propertyChange(event);
}
});
}
}
}
/**
* Sets the visible column ids.
*
* @param ids column identifiers
*/
public void setColumns(String[] ids) {
setProperty(IPresentationContext.PROPERTY_COLUMNS, ids);
}
/* (non-Javadoc)
* @see org.eclipse.debug.internal.ui.viewers.model.provisional.IPresentationContext#dispose()
*/
public void dispose() {
fListeners.clear();
fProperties.clear();
}
/* (non-Javadoc)
* @see org.eclipse.debug.internal.ui.viewers.provisional.IPresentationContext#addPropertyChangeListener(org.eclipse.jface.util.IPropertyChangeListener)
*/
public void addPropertyChangeListener(IPropertyChangeListener listener) {
fListeners.add(listener);
}
/* (non-Javadoc)
* @see org.eclipse.debug.internal.ui.viewers.provisional.IPresentationContext#removePropertyChangeListener(org.eclipse.jface.util.IPropertyChangeListener)
*/
public void removePropertyChangeListener(IPropertyChangeListener listener) {
fListeners.remove(listener);
}
/* (non-Javadoc)
* @see org.eclipse.debug.internal.ui.viewers.provisional.IPresentationContext#getId()
*/
public String getId() {
return fId;
}
/* (non-Javadoc)
* @see org.eclipse.debug.internal.ui.viewers.provisional.IPresentationContext#getProperty(java.lang.String)
*/
public Object getProperty(String property) {
synchronized (fProperties) {
return fProperties.get(property);
}
}
/* (non-Javadoc)
* @see org.eclipse.debug.internal.ui.viewers.provisional.IPresentationContext#setProperty(java.lang.String, java.lang.Object)
*/
public void setProperty(String property, Object value) {
synchronized (fProperties) {
Object oldValue = fProperties.get(property);
if (!isEqual(oldValue, value)) {
fProperties.put(property, value);
firePropertyChange(property, oldValue, value);
}
}
}
/**
* Restores the presentation context properties from the given memento.
* @param memento Memento to restore from.
*/
public void initProperties(IMemento memento) {
IMemento presentationMemento = null;
IMemento[] mementos = memento.getChildren(PRESENTATION_CONTEXT_PROPERTIES);
for (int i = 0; i < mementos.length; i++) {
if (getId().equals(mementos[i].getID())) {
presentationMemento = mementos[i];
break;
}
}
if (presentationMemento != null) {
IMemento[] stringProperties = presentationMemento.getChildren(STRING);
for (int i = 0; i < stringProperties.length; i++) {
fProperties.put(stringProperties[i].getID(), stringProperties[i].getString(STRING));
}
IMemento[] integerMementos = presentationMemento.getChildren(INTEGER);
for (int i = 0; i < integerMementos.length; i++) {
fProperties.put(integerMementos[i].getID(), integerMementos[i].getInteger(INTEGER));
}
IMemento[] booleanMementos = presentationMemento.getChildren(BOOLEAN);
for (int i = 0; i < booleanMementos.length; i++) {
fProperties.put(booleanMementos[i].getID(), booleanMementos[i].getBoolean(BOOLEAN));
}
IMemento[] persistableMementos = presentationMemento.getChildren(PERSISTABLE);
for (int i = 0; i < persistableMementos.length; i++) {
String factoryID = persistableMementos[i].getString(PERSISTABLE);
if (factoryID != null) {
IElementFactory factory = PlatformUI.getWorkbench().getElementFactory(factoryID);
if (factory != null) {
Object element = factory.createElement(persistableMementos[i]);
if (element != null) {
fProperties.put(persistableMementos[i].getID(), element);
}
}
}
}
}
}
/**
* Saves the current presentation context properties to the given memento.
* @param memento Memento to save to.
*/
public void saveProperites(IMemento memento) {
if (fProperties.size() == 0) {
return;
}
IMemento properties = memento.createChild(PRESENTATION_CONTEXT_PROPERTIES, getId());
Iterator iterator = fProperties.entrySet().iterator();
while (iterator.hasNext()) {
Map.Entry entry = (Entry) iterator.next();
if (entry.getValue() instanceof String) {
IMemento value = properties.createChild(STRING, (String)entry.getKey());
value.putString(STRING, (String)entry.getValue());
} else if (entry.getValue() instanceof Integer) {
IMemento value = properties.createChild(INTEGER, (String)entry.getKey());
value.putInteger(INTEGER, ((Integer)entry.getValue()).intValue());
} else if (entry.getValue() instanceof Boolean) {
IMemento value = properties.createChild(BOOLEAN, (String)entry.getKey());
value.putBoolean(BOOLEAN, ((Boolean)entry.getValue()).booleanValue());
} else if (entry.getValue() instanceof IPersistableElement) {
IPersistableElement persistable = (IPersistableElement)entry.getValue();
IMemento value = properties.createChild(PERSISTABLE, (String)entry.getKey());
value.putString(PERSISTABLE, persistable.getFactoryId());
persistable.saveState(value);
}
}
}
private boolean isEqual(Object a, Object b) {
if (a == null) {
return b == null;
}
return a.equals(b);
}
/* (non-Javadoc)
* @see org.eclipse.debug.internal.ui.viewers.model.provisional.IPresentationContext#getProperties()
*/
public String[] getProperties() {
synchronized (fProperties) {
Set keys = fProperties.keySet();
return (String[]) keys.toArray(new String[keys.size()]);
}
}
}