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:
Implementation |
URL |
|---|---|
PHP |
http://wso2wsastest1.cloudapp.net/php_stocktrader/config_service/config_svc.php |
.NET |
http://stocktraderazure.cloudapp.net:8081/tradeconfigservice.svc |
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 |
Information identifying the business service instance that is making the request |
in |
|
N/A |
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 |
Information identifying the client instance that is making the request |
in |
|
N/A |
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 |
Information identifying the order processor instance that is making the request |
in |
|
N/A |
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 |
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 |
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 |
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 |
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 |
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 |