M2 Feature

This page discusses a component that will become available as part of the M2 release of the StockTrader sample application.

Description

The StockTrader Configuration Service provides service endpoint and database configuration information to the various components that make up the Stonehenge StockTrader Sample Application. It relies on the StockTrader Database for storage of this information.

The StockTrader Client contains a UI for managing service endpoints that interfaces with the configuration service to update configuration information.

Table of Contents



Live Demonstrations

In December of 2009, the PHP and .NET implementations of the StockTrader Configuration Service were ported to run on Windows Azure. These live cloud-based versions of the StockTrader Configuration Service can be accessed using the URLs in the table below:

Service Operations

The ConfigServiceService port which exposes these operations is located under the namespace http://Trade.TraderConfigHost. The contract for this service varies slightly between implementations. Those actions that are not supported in all implementations have been marked with an asterisk (star).

GetBSConfig

The GetBSConfig operation is used to get information about how the StockTrader Business Service should communicate with the StockTrader Order Processor Service and the StockTrader Database.

Parameter

Type

Description

Direction

bs

BSConfigRequest

Information identifying the business service instance that is making the request

in

N/A

BSConfigResponse

Configuration data indicating endpoint information and security requirements for the StockTrader Order Processor Service and the StockTrader Database

out

GetBSLocations

The GetBSLocations operation is used to get a list of endpoints hosting the StockTrader Business Service.

Parameter

Type

Description

Direction

N/A

Array of ServiceLocation

A list of endpoints hosting the StockTrader Business Service

out

GetClientConfig

The GetClientConfig operation is used to get information about how the StockTrader Client should communicate with the StockTrader Business Service.

Parameter

Type

Description

Direction

client

ClientConfigRequest

Information identifying the client instance that is making the request

in

N/A

ClientConfigResponse

Configuration data indicating endpoint information and security requirements for the StockTrader Business Service

out

GetOPSConfig

The GetOPSConfig operation is used to get information about how the StockTrader Order Processor Service should communicate with the StockTrader Database.

Parameter

Type

Description

Direction

ops

OPSConfigRequest

Information identifying the order processor instance that is making the request

in

N/A

OPSConfigResponse

Configuration data indicating the type and location of the StockTrader Database

out

GetOPSLocations

The GetOPSLocations operation is used to get a list of endpoints hosting the StockTrader Order Processor Service.

Parameter

Type

Description

Direction

N/A

Array of ServiceLocation

A list of endpoints hosting the StockTrader Order Processor Service

out

SetBSToOPS

The SetBSToOPS operation is used to configure a mapping from a StockTrader Business Service instance to a corresponding StockTrader Order Processor Service instance. By performing the mapping in this fashion, each StockTrader Business Service implementation can be configured to connect to a different StockTrader Order Processor Service, instead of there simply being a single order processor shared by all business services.

The pairing information stored by this operation includes only an identifier for each service (e.g., WSAS_BS, PHP_OPS). Actual endpoint information for these named instances are retrieved when the GetBSConfig operation is called by a specific StockTrader Business Service instance.

Parameter

Type

Description

Direction

bsConfig

BSToOPS

A key value pairing of a StockTrader Business Service instance and a StockTrader Order Processor Service instance.

in

SetClientToBS

The SetClientToBS operation is used to configure a mapping from a StockTrader Client instance to a corresponding StockTrader Business Service instance. By performing the mapping in this fashion, each StockTrader Client implementation can be configured to connect to a different StockTrader Business Service, instead of there simply being a single business service shared by all clients.

The pairing information stored by this operation includes only an identifier for each service (e.g., DOTNET_CLIENT, PHP_BS). Actual endpoint information for these named instances are retrieved when the GetClientConfig action is called by a specific StockTrader Client instance.

Parameter

Type

Description

Direction

clientConfig

ClientToBS

A key value pairing of a StockTrader Client instance and a StockTrader Business Service instance.

in

SetServiceLocation

The SetServiceLocation operation is used to change the properties of a given named endpoint. This operation cannot update the name, but instead will use the name as a key to update the location and security information associated with a given service. If the service does not already exist in the StockTrader Database, this operation will add the service.

Parameter

Type

Description

Direction

location

ServiceLocation

New configuration data for the service

in

DBConfig(star)

The DBConfig operation is used to save information about the location of a given StockTrader Database in the StockTrader Database.

Parameter

Type

Description

Direction

config

DBConfig

Database location information to save in the StockTrader Database

in

GetDBConfigs(star)

The GetDBConfigs operation is used to retrieve a list of all known StockTrader Database instances.

Parameter

Type

Description

Direction

N/A

Array of DBConfig

List of all known StockTrader Database instances

out

ActiveDB(star)

The ActiveDB operation is used to select the database connection that will be used by the application.

Parameter

Type

Description

Direction

activeConfig

String

Name of the database that will be set as active

in

GetActiveDB(star)

The GetActiveDB operation is used to retrieve the configuration information associated with the currently active StockTrader Database instance.

Parameter

Type

Description

Direction

N/A

DBConfig

Configuration for the active StockTrader Database instance

out

GetClientToBSConnections(star)

The GetClientToBSConnections operation is used to get a list of all known StockTrader Client and StockTrader Business Service pairings.

Parameter

Type

Description

Direction

N/A

Array of ClientToBS

List of known pairings of StockTrader Client and StockTrader Business Service instances

out

GetBSToOPSConnections(star)

The GetBSToOPSConnections operation is used to get a list of all known StockTrader Business Service and StockTrader Order Processor Service pairings.

Parameter

Type

Description

Direction

N/A

Array of BSToOPS

List of known pairings of StockTrader Business Service and StockTrader Order Processor Service instances

out

  • No labels