CompositeConnectionResolver

Inherits: IConfigurable, IReferenceable

Description

The CompositeConnectionResolver class allows you to resolve connection and credential parameters, validate them and generate connection options.

Configuration parameters

connection(s):

• discovery_key: (optional) key to retrieve the connection from IDiscovery
• protocol: communication protocol
• host: host name or IP address
• port: port number
• uri: resource URI or connection string with all parameters in it

credential(s):

• store_key: (optional) key to retrieve the credentials from ICredentialStore
• username: username
• password: user’s password

References

• *:discovery:*:*:1.0 - (optional) IDiscovery services to resolve connections
• *:credential-store:*:*:1.0 - (optional) Credential stores to resolve credentials ICredentialStore

Fields

Instance methods

Compose

Composes composite connection options from connection and credential parameters.

public ConfigParams Compose(IContext context, IList<ConnectionParams> connections, CredentialParams credential, ConfigParams parameters)

• context: IContext - (optional) a context to trace execution through a call chain.
• connections: IList<ConnectionParams> - connection parameters
• credential: CredentialParams - credential parameters
• parameters: ConfigParams - optional parameters
• returns: ConfigParams - resolved options or error.

ComposeOptions

Composite of several merger options

protected ConfigParams ComposeOptions(IList<ConnectionParams> connections, CredentialParams credential, ConfigParams parameters)

• connections: ConnectionParams[] - connection parameters
• credential: CredentialParams - credential parameters
• parameters: IList<ConnectionParams> - optional parameters
• returns: ConfigParams - resolved options or error

Configure

Configures component by passing configuration parameters.

public void Configure(ConfigParams config)

• config: ConfigParams - configuration parameters to be set.

FinalizeOptions

Finalize merged options. This method can be overriden in child classes.

protected ConfigParams FinalizeOptions(ConfigParams options)

• options: ConfigParams - options: connection options
• returns: ConfigParams - finalized connection options

MergeConnection

Merges connection options with connection parameters. This method can be overriden in child classes.

protected ConfigParams MergeConnection(ConfigParams options, ConnectionParams connection)

• options: ConfigParams - connection options
• connection: ConnectionParams - connection parameters to be merged
• returns: ConfigParams - merged connection options.

MergeCredential

Merges connection options with credential parameters. This method can be overriden in child classes.

protected ConfigParams MergeCredential(ConfigParams options, CredentialParams credential)

• options: ConfigParams - connection options
• credential: CredentialParams - credential parameters to be merged
• returns: ConfigParams - merged connection options.

MergeOptional

Merges connection options with optional parameters. This method can be overriden in child classes.

protected ConfigParams MergeOptional(ConfigParams options, ConfigParams parameters)

• options: ConfigParams - connection options
• parameters: CredentialParams - optional parameters to be merged
• returns: ConfigParams - merged connection options.

ResolveAsync

Resolves connection options from connection and credential parameters.

public Task<ConfigParams> ResolveAsync(IContext context):

• context: IContext - (optional) a context to trace execution through a call chain.
• returns: Task<ConfigParams> - resolved options or error

SetReferences

Sets references to dependent components.

public void SetReferences(references: IReferences)

• references: IReferences - references to locate the component dependencies.

ValidateConnection

Validates connection parameters. Throws error if validation failed. This method can be overriden in child classes.

protected void ValidateConnection(IContext context, ConnectionParams) connection)

• context: IContext - (optional) a context to trace execution through a call chain.
• connection: ConnectionParams - connection parameters to be validated

ValidateCredential

Validates credential parameters. This method can be overriden in child classes.

protected void ValidateCredential(IContext context, CredentialParams credential)

• context: IContext - (optional) a context to trace execution through a call chain.
• credential: CredentialParams - credential parameters to be validated