IModelingSession (Modelio 3.5 API)

```
public interface IModelingSession
```
This interface represents a project session. A modeling session is used to update a modelio project and to give the right model navigation roots.

The current modeling session can be accessed using the following API: IModelingSession session = Modelio.getInstance().getModelingSession();

The IModelingSession interface groups the following features:
- Transaction management
- Model change management
- Model root access
- MObject status management

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`void`	`addModelHandler(IModelChangeHandler handler)` Add a model change listener.
`void`	`addModelListener(IModelChangeListener listener)` Add a model change handler.
`void`	`addStatusHandler(IStatusChangeHandler handler)` Add a status change listener.
`void`	`addStatusListener(IStatusChangeListener listener)` Add a status handler.
`ITransaction`	`createTransaction(String transactionName)` Create a new transaction in the project.
`<T extends MObject> Collection<T>`	`findByAtt(Class<T> metaclass, String att, String value)` Get an element in the model from its metaclass, a meta attribute name and value . If "element" is given, every model elements will be checked.
`Collection<? extends MObject>`	`findByAtt(MClass metaclass, String att, String value)` Get an element in the model from its metaclass, a meta attribute name and value . If "element" is given, every model elements will be checked.
`<T extends MObject> Collection<T>`	`findByClass(Class<T> metaclass)` Get all elements in the model from their metaclass.
`Collection<? extends MObject>`	`findByClass(MClass metaclass)` Get all elements in the model from their metaclass.
`<T extends MObject> T`	`findElementById(Class<T> metaclass, String id)` Get an element in the model from its id and metaclass.
`MObject`	`findElementById(MClass metaclass, String id)` Get an element in the model from its id and metaclass.
`IMetamodelExtensions`	`getMetamodelExtensions()` Returns the metamodel extension of the project.
`IUmlModel`	`getModel()` Returns the UML Model of the project.
`String`	`getName()` Get the name of this session.
`IAnalystModel`	`getRequirementModel()` Returns the Requirement Model of the project.
`void`	`removeModelHandler(IModelChangeHandler handler)` Remove a model change handler.
`void`	`removeModelListener(IModelChangeListener listener)` Remove a model change listener.
`void`	`removeStatusHandler(IStatusChangeHandler handler)` Remove a status change handler.
`void`	`removeStatusListener(IStatusChangeListener listener)` Remove a status change listener.

- Method Detail
  - addModelHandler
```
void addModelHandler(IModelChangeHandler handler)
```
    Add a model change listener.
    Handlers can modify the model.
    This model listener is used to be notified of the model structural changes, through the use of the IModelChangeHandler listener class.
    
    Parameters:
    
    handler - the model change listener to add.
  - addModelListener
```
void addModelListener(IModelChangeListener listener)
```
    Add a model change handler.
    Added listeners must not modify the model. If model modifications should be done use addModelHandler() method.
    This model listener is used to be notified of the model structural changes, through the use of the IModelChangeListener listener class.
    
    Parameters:
    
    listener - the model change listener to add.
  - addStatusHandler
```
void addStatusHandler(IStatusChangeHandler handler)
```
    Add a status change listener.
    Handlers can modify the model.
    This model listener is used to be notified of the model status changes (read/write), through the use of the IStatusChangeHandler listener class.
    
    Parameters:
    
    handler - the model change listener to add.
  - addStatusListener
```
void addStatusListener(IStatusChangeListener listener)
```
    Add a status handler.
    Added listeners must not modify the model. If model modifications should be done use addModelHandler() method.
    This model listener is used to be notified of all the model status changes (read/write), through the use of the IStatusChangeListener listener class.
    
    Parameters:
    
    listener - the model change listener to add.
  - createTransaction
```
ITransaction createTransaction(String transactionName)
```
    Create a new transaction in the project.
    
    All the model updates have to be carried out in the context of a transaction, which has to be created, through the use of this method, and Committed via the #commit(ITransaction) method or rollbacked using the #rollback(ITransaction) method.
    
    Parameters:
    
    transactionName - A transaction name. This name is just a label that might be displayed in log files, a console or dialog boxes.
    
    Returns:
    
    the created transaction.
  - findByAtt
```
<T extends MObject> Collection<T> findByAtt(Class<T> metaclass,
                                            String att,
                                            String value)
```
    Get an element in the model from its metaclass, a meta attribute name and value .
    If "element" is given, every model elements will be checked.
    
    Parameters:
    
    metaclass - the metaclass to look for.
    
    att - the name of the meta attribute to check the value in.
    
    value - the value to look for in the attribute.
    
    Returns:
    
    A model element, or null if no match is found.
  - findByAtt
```
Collection<? extends MObject> findByAtt(MClass metaclass,
                                        String att,
                                        String value)
```
    Get an element in the model from its metaclass, a meta attribute name and value .
    If "element" is given, every model elements will be checked.
    
    Parameters:
    
    metaclass - the metaclass to look for.
    
    att - the name of the meta attribute to check the value in.
    
    value - the value to look for in the attribute.
    
    Returns:
    
    A model element, or null if no match is found.
  - findByClass
```
<T extends MObject> Collection<T> findByClass(Class<T> metaclass)
```
    Get all elements in the model from their metaclass.
    
    Parameters:
    
    metaclass - the metaclass to look for.
    
    Returns:
    
    A list of all model elements, or null if no match is found.
  - findByClass
```
Collection<? extends MObject> findByClass(MClass metaclass)
```
    Get all elements in the model from their metaclass.
    
    Parameters:
    
    metaclass - the metaclass to look for.
    
    Returns:
    
    A list of all model elements, or null if no match is found.
  - findElementById
```
<T extends MObject> T findElementById(Class<T> metaclass,
                                      String id)
```
    Get an element in the model from its id and metaclass.
    
    Parameters:
    
    metaclass - the metaclass to look for.
    
    id - the id to look for.
    
    Returns:
    
    A model element, or null if no match is found.
  - findElementById
```
MObject findElementById(MClass metaclass,
                        String id)
```
    Get an element in the model from its id and metaclass.
    
    Parameters:
    
    id -
    
    metaclass - the metaclass to look for.
    
    Returns:
    
    A model element, or null if no match is found.
  - getMetamodelExtensions
```
IMetamodelExtensions getMetamodelExtensions()
```
    Returns the metamodel extension of the project.
    
    The metamodel extensions are added by the tool when modules are deployed. It corresponds to the stereotypes, note types and tag types brought by modules.
    
    Returns:
    
    the stereotypes, tag types and not types brought by deployed modules.
  - getModel
```
IUmlModel getModel()
```
    Returns the UML Model of the project.
    
    This method is often used to get the root package using the IUmlModel#getRoot() method
    
    Returns:
    
    the UML Model connected to the session.
  - getName
```
String getName()
```
    Get the name of this session.
    
    Returns:
    
    the name of this session.
  - getRequirementModel
```
IAnalystModel getRequirementModel()
```
    Returns the Requirement Model of the project.
    
    The requirement model owns three model roots: the requirement container, the dictionary and the requirement administration models.
    
    Returns:
    
    the Requirement Model connected to the session.
  - removeModelHandler
```
void removeModelHandler(IModelChangeHandler handler)
```
    Remove a model change handler.
    
    Parameters:
    
    handler - the model change handler to remove.
  - removeModelListener
```
void removeModelListener(IModelChangeListener listener)
```
    Remove a model change listener.
    
    Parameters:
    
    listener - the model change listener to remove.
  - removeStatusHandler
```
void removeStatusHandler(IStatusChangeHandler handler)
```
    Remove a status change handler.
    
    Parameters:
    
    handler - the status change handler to remove.
  - removeStatusListener
```
void removeStatusListener(IStatusChangeListener listener)
```
    Remove a status change listener.
    
    Parameters:
    
    listener - the status change listener to remove.

Interface IModelingSession

Method Summary

Method Detail

addModelHandler

addModelListener

addStatusHandler

addStatusListener

createTransaction

findByAtt

findByAtt

findByClass

findByClass

findElementById

findElementById

getMetamodelExtensions

getModel

getName

getRequirementModel

removeModelHandler

removeModelListener

removeStatusHandler

removeStatusListener