ManagedReferences

Managed references that in addition to keeping and locating references can also manage their lifecycle.

Inherits: ReferencesDecorator, IOpenable

Description

The ManagedReferences class allows you to create managed references that in additon to keeping and locating references can also manage their lifecycle, such as:

  • Auto-creation of missing components using available factories
  • Auto-linking newly added components
  • Auto-opening newly added components
  • Auto-closing removed components

Constructors

Creates a new instance of the decorator.

public ManagedReferences(object[] tuples = null)

  • tuples: object[] - tuples where odd values are component locators (descriptors) and even values are component references

Fields

_references

References

protected _references: References

_builder

Builder

protected _builder: BuildReferencesDecorator

_linker

Linker

protected _linker: LinkReferencesDecorator

_runner

Runner

protected _runner: RunReferencesDecorator

Instance methods

Close

Closes the component and frees used resources.

public Task CloseAsync(string correlationId)

  • correlationId: string - (optional) transaction id used to trace execution through the call chain.

IsOpen

Checks if the component is open.

public bool IsOpen()

  • returns: bool - True if the component is open and False otherwise.

Open

Opens the component.

public Task OpenAsync(string correlationId)

  • correlationId: string - (optional) transaction id used to trace execution through the call chain.

Static methods

FromTuples

Removes all component references that match the specified locator.

public static ManagedReferences FromTyples(params object[] tuples)

  • locator: object[] - locator to remove references by.
  • returns: ManagedReferences - list containing all removed references.

See also