This microservice is the controller for the IBM Stock Trader application. The various clients talk solely to this microservice, which then takes care of coordinating calls to the downstream microservices and merging the results. The following operations are available:
GET / - gets summary data for all brokers.
POST /{owner} - creates a new broker for the specified owner.
GET /{owner} - gets details for the specified broker.
PUT /{owner} - updates the broker for the specified owner (by adding a stock).
DELETE /{owner} - removes the broker for the specified owner.
GET /{owner}/returns - gets the return on investment for this broker.
POST /{owner}/feedback - submits feedback (to the Watson Tone Analyzer)
All operations return JSON. A broker object contains fields named owner, total, loyalty, balance,
commissions, free, sentiment, and nextCommission, plus an array of stocks. A stock object contains
fields named symbol, shares, commission, price, total, and date. The only operation that takes any
query params is the PUT operation, which expects params named symbol and shares. Also, the feedback
operation takes a JSON object in the http body, with a single field named text.
For example, doing a PUT http://localhost:9080/broker/John?symbol=IBM&shares=123 (against a freshly
created broker for John) would return JSON like {"owner": "John", "total": 19120.35, "loyalty": "Bronze", "balance": 40.01, "commissions": 9.99, "free": 0, "sentiment": "Unknown", "nextCommission": 8.99, "stocks": [{"symbol": "IBM", "shares": 123, "commission": 9.99, "price": 155.45, "total": 19120.35, "date": "2017-06-26"}]}.
The above REST call would call the Portfolio microservice to buy the shares of stock. If configured (via the
USE_ACCOUNT environment variable), it would also call the Account microservice to determine the new loyalty
level, the account balance, and other such optional fields. If not configured to use the Account microservice,
it will return -1 for each optional number and "Unknown" for each optional string.
This project requires one secret called jwt.
kubectl create secret generic jwt -n stock-trader --from-literal=audience=stock-trader --from-literal=issuer=http://stock-trader.ibm.comTo build broker clone this repo and run:
mvn package
docker build -t broker:latest -t <REPO>/stock-trader/broker:latest .
docker tag broker:latest <REPO>/stock-trader/broker:latest
docker push <REPO>/stock-trader/broker:latestUse the WebSphere Liberty helm chart to deploy the Broker microservice:
helm repo add ibm-charts https://raw.githubusercontent.com/IBM/charts/master/repo/stable/
helm install ibm-charts/ibm-websphere-liberty -f <VALUES_YAML> -n <RELEASE_NAME> --tls