Class Environment

This stands for the environment in which the scenario engine operates. The register references all the relations and all the relational objects. It stores every executed realizations and those that need to be executed.

Inheritance

object

Environment

Implements

IContext

ITypeDescriptorContext

IServiceProvider

IRealizationManager

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Namespace: Xareus.Scenarios.Relations

Assembly: Xareus.Scenarios.Relations.dll

Syntax

public class Environment : IContext, ITypeDescriptorContext, IServiceProvider, IRealizationManager

Constructors

Environment(IEngine)

Declaration

public Environment(IEngine engine)

Parameters

Type	Name	Description
IEngine	engine

Fields

RELATION_ENGINE_PATH

Declaration

public const string RELATION_ENGINE_PATH = "RelationEngine"

Field Value

Type	Description
string

subContexts

Declaration

protected List<IContext> subContexts

Field Value

Type	Description
List<IContext>

subContextsInPath

Declaration

protected Dictionary<string, List<IContext>> subContextsInPath

Field Value

Type	Description
Dictionary<string, List<IContext>>

Properties

Container

Gets the container representing this TypeDescriptor request.

Declaration

public virtual IContainer Container { get; }

Property Value

Type	Description
IContainer	An System.ComponentModel.IContainer with the set of objects for this TypeDescriptor; otherwise, null if there is no container or if the TypeDescriptor does not use outside objects.

Instance

Gets the object that is connected with this type descriptor request.

Declaration

public virtual object Instance { get; }

Property Value

Type	Description
object	The object that invokes the method on the TypeDescriptor; otherwise, null if there is no object responsible for the call.

Objects

Declaration

public Dictionary<string, IObject> Objects { get; }

Property Value

Type	Description
Dictionary<string, IObject>

PropertyDescriptor

Gets the System.ComponentModel.PropertyDescriptor that is associated with the given context item.

Declaration

public virtual PropertyDescriptor PropertyDescriptor { get; }

Property Value

Type	Description
PropertyDescriptor	The System.ComponentModel.PropertyDescriptor that describes the given context item; otherwise, null if there is no System.ComponentModel.PropertyDescriptor responsible for the call.

RelationEngine

The relation engine linked to this environment

Declaration

public IEngine RelationEngine { get; }

Property Value

Type	Description
IEngine

Relations

Declaration

public Dictionary<string, IRelation> Relations { get; }

Property Value

Type	Description
Dictionary<string, IRelation>

Methods

AddExecutedRealization(Realization)

Add the given realization to the log.

Declaration

public void AddExecutedRealization(Realization realization)

Parameters

Type	Name	Description
Realization	realization

AddSubContext(IContext)

Add a sub-context that will be browsed when accessing values

Declaration

public void AddSubContext(IContext subContext)

Parameters

Type	Name	Description
IContext	subContext

AddSubContext(IContext, string)

Add a sub-context that will be browsed when accessing values

Declaration

public void AddSubContext(IContext subContext, string path)

Parameters

Type	Name	Description
IContext	subContext
string	path

Clear()

Declaration

public void Clear()

EnqueueRealizationToExecute(Realization)

Add the given realization to the backlog.

Declaration

public void EnqueueRealizationToExecute(Realization realization)

Parameters

Type	Name	Description
Realization	realization

GetExecutedRealizations(IRelation, HashSet<IObject>, DateTime, DateTime)

Returns every realization that match the given relation and objects and that were created between the start and end DateTime.

Declaration

public IEnumerable<Realization> GetExecutedRealizations(IRelation relation, HashSet<IObject> objects, DateTime start, DateTime end)

Parameters

Type	Name	Description
IRelation	relation
HashSet<IObject>	objects
DateTime	start
DateTime	end

Returns

Type	Description
IEnumerable<Realization>

GetNextRealizationToExecute()

Returns the oldest realization in the backlog.

Declaration

public Realization GetNextRealizationToExecute()

Returns

Type	Description
Realization

GetPaths()

Lists all the valid paths

Declaration

public IEnumerable<string> GetPaths()

Returns

Type	Description
IEnumerable<string>

GetService(Type)

Gets the service object of the specified type.

Declaration

public virtual object GetService(Type serviceType)

Parameters

Type	Name	Description
Type	serviceType	An object that specifies the type of service object to get.

Returns

Type	Description
object	A service object of type serviceType. -or- null if there is no service object of type serviceType.

GetValue(string)

Get the first value at the given path in the environment or one of its sub contexts

Declaration

public object GetValue(string path)

Parameters

Type	Name	Description
string	path

Returns

Type	Description
object

GetValueOrDefault(string, object)

Get the first value at the given path in the environment or one of its sub contexts or the given default value if not found

Declaration

public object GetValueOrDefault(string path, object defaultValue = null)

Parameters

Type	Name	Description
string	path
object	defaultValue

Returns

Type	Description
object

HasPath(string)

Checks if the given path exists in the environment or on of its sub contexts

Declaration

public bool HasPath(string path)

Parameters

Type	Name	Description
string	path

Returns

Type	Description
bool

HasSubContext(IContext, bool)

Check if a sub-context is present in the Environment

Declaration

public bool HasSubContext(IContext subContext, bool atAnyPath = true)

Parameters

Type	Name	Description
IContext	subContext
bool	atAnyPath

Returns

Type	Description
bool

OnComponentChanged()

Raises the ComponentChanged event.

Declaration

public virtual void OnComponentChanged()

OnComponentChanging()

Raises the ComponentChanging event.

Declaration

public virtual bool OnComponentChanging()

Returns

Type	Description
bool	true if this object can be changed; otherwise, false.

RemoveSubContext(IContext, bool)

Remove a sub-context

Declaration

public void RemoveSubContext(IContext subContext, bool atAnyPath = true)

Parameters

Type	Name	Description
IContext	subContext
bool	atAnyPath

SetValue(string, object)

Sets the value at the given path in the environment (note that sub contexts won't be affected)

Declaration

public void SetValue(string path, object value)

Parameters

Type	Name	Description
string	path
object	value

Union(string, IContext)

Merges the given context into this one at the given path

Declaration

public void Union(string path, IContext other)

Parameters

Type	Name	Description
string	path
IContext	other

Union(IContext, bool)

Declaration

public void Union(IContext other, bool overrideDuplicates = true)

Parameters

Type	Name	Description
IContext	other
bool	overrideDuplicates

Implements

IContext

System.ComponentModel.ITypeDescriptorContext

IServiceProvider

IRealizationManager