Eclipse Platform
2.1

org.eclipse.debug.core
Interface IExpressionManager


public interface IExpressionManager

The expression manager manages the collection of registered expressions in the workspace. An expression is a snippet of code that can be evaluated to produce a value. Expression creation and evaluation are client responsibilities.

Clients interested in expression change notification may register with the expression manager - see IExpressionListener and IExpressionsListener.

This interface is not intended to be implemented by clients.

Since:
2.0
See Also:
IExpression, IExpressionListener, IExpressionsListener

Method Summary
 void addExpression(IExpression expression)
          Adds the given expression to the collection of registered expressions in the workspace and notifies all registered listeners.
 void addExpressionListener(IExpressionListener listener)
          Adds the given listener to the collection of registered expression listeners.
 void addExpressionListener(IExpressionsListener listener)
          Adds the given listener to the collection of registered expression listeners.
 void addExpressions(IExpression[] expressions)
          Adds the given expressions to the collection of registered expressions in the workspace and notifies all registered listeners.
 IExpression[] getExpressions()
          Returns a collection of all registered expressions, possibly empty.
 IExpression[] getExpressions(String modelIdentifier)
          Returns a collection of all expressions registered for the given debug model,possibly empty.
 boolean hasExpressions()
          Returns whether there are any registered expressions
 void removeExpression(IExpression expression)
          Removes the given expression from the expression manager, and notifies all registered listeners.
 void removeExpressionListener(IExpressionListener listener)
          Removes the given listener from the collection of registered expression listeners.
 void removeExpressionListener(IExpressionsListener listener)
          Removes the given listener from the collection of registered expression listeners.
 void removeExpressions(IExpression[] expressions)
          Removes the given expressions from the collection of registered expressions in the workspace and notifies all registered listeners.
 

Method Detail

addExpression

public void addExpression(IExpression expression)
Adds the given expression to the collection of registered expressions in the workspace and notifies all registered listeners. This has no effect if the given expression is already registered.
Parameters:
expression - the expression to add

addExpressions

public void addExpressions(IExpression[] expressions)
Adds the given expressions to the collection of registered expressions in the workspace and notifies all registered listeners. Has no effect on expressions already registered.
Parameters:
expressions - the expressions to add
Since:
2.1

getExpressions

public IExpression[] getExpressions()
Returns a collection of all registered expressions, possibly empty.
Returns:
an array of expressions

hasExpressions

public boolean hasExpressions()
Returns whether there are any registered expressions
Returns:
whether there are any registered expressions

getExpressions

public IExpression[] getExpressions(String modelIdentifier)
Returns a collection of all expressions registered for the given debug model,possibly empty.
Parameters:
modelIdentifier - identifier of a debug model plug-in
Returns:
an array of expressions

removeExpression

public void removeExpression(IExpression expression)
Removes the given expression from the expression manager, and notifies all registered listeners. Has no effect if the given expression is not currently registered.
Parameters:
expression - the expression to remove

removeExpressions

public void removeExpressions(IExpression[] expressions)
Removes the given expressions from the collection of registered expressions in the workspace and notifies all registered listeners. Has no effect on expressions not already registered.
Parameters:
expressions - the expressions to remove
Since:
2.1

addExpressionListener

public void addExpressionListener(IExpressionListener listener)
Adds the given listener to the collection of registered expression listeners. Has no effect if an identical listener is already registered.
Parameters:
listener - the listener to add

removeExpressionListener

public void removeExpressionListener(IExpressionListener listener)
Removes the given listener from the collection of registered expression listeners. Has no effect if an identical listener is not already registered.
Parameters:
listener - the listener to remove

addExpressionListener

public void addExpressionListener(IExpressionsListener listener)
Adds the given listener to the collection of registered expression listeners. Has no effect if an identical listener is already registered.
Parameters:
listener - the listener to add
Since:
2.1

removeExpressionListener

public void removeExpressionListener(IExpressionsListener listener)
Removes the given listener from the collection of registered expression listeners. Has no effect if an identical listener is not already registered.
Parameters:
listener - the listener to remove
Since:
2.1

Eclipse Platform
2.1

Copyright (c) IBM Corp. and others 2000, 2003. All Rights Reserved.