This page last changed on Dec 09, 2009 by nickh.
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.



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 .

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

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

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

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

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

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

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
Document generated by Confluence on Jun 22, 2010 14:31