Skip to content

java

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

java

README.md

Java Examples

Example Code Disclaimer: ALL EXAMPLE CODE IS PROVIDED ON AN “AS IS” AND “AS AVAILABLE” BASIS FOR ILLUSTRATIVE PURPOSES ONLY. LSEG MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, AS TO THE OPERATION OF EXAMPLE CODE, OR THE INFORMATION, CONTENT OR MATERIALS USED IN CONNECTION WITH EXAMPLE CODE. YOU EXPRESSLY AGREE THAT YOUR USE OF EXAMPLE CODE IS AT YOUR SOLE RISK

Summary

The purpose of these examples is to show retrieving JSON-formatted market content from a WebSocket server. The examples are as follows:

  • MarketPrice: Retrieves market-price content for TRI.N.
  • MarketPriceBatchView: Retrieves market-price content for TRI.N, IBM.N, and T.N, using a batch request. It also specifies a view that requests content only for fields BID, ASK, and BIDSIZE.
  • MarketPriceAuthentication: Retrieves market-price content for TRI.N, after authenticating with an authentication server.
  • MarketPricePosting: Retrieves market-price content for TRI.N, and posts market-price content back to it.
  • MarketPricePing: Retrieves market-price content for TRI.N, and monitors connection health by sending ping messages.

MarketPrice forms the basis of the other examples, which implement additional features. To see the code specific to each feature, a diff tool can be used to compare the MarketPrice source file with that of the appropriate example.

These applications are intended as basic usage examples. Some of the design choices were made to favor simplicity and readability over performance. This application is not intended to be used for measuring performance.

Command Line Usage

./gradlew :MarketPrice:run --args="[--hostname hostname] [--port port] [--app_id appID] [--user user] [--snapshot]"

./gradlew :MarketPriceBatchView:run --args="[--hostname hostname ] [--port port] [--app_id appID] [--user user]"

./gradlew :MarketPriceAuthentication:run --args="[--hostname hostname ] [--port port] [--app_id appID] [--user user] [--password password] [--auth_port port]"

./gradlew :MarketPricePosting:run --args="[--hostname hostname ] [--port port] [--app_id appID] [--user user]"

Pressing the CTRL+C buttons terminates any example.

Setup

Run ./gradlew build

Running Examples

./gradlew :MarketPrice:run --args="--hostname "`

Source File Description

  • MarketPrice - Source file for the MarketPrice example.

  • MarketPriceBatchView - Source file for the MarketPriceBatchView example.

  • MarketPriceAuthentication - Source file for the MarketPriceAuthentication example.

  • MarketPricePosting - Source file for the MarketPricePosting example.

  • MarketPricePing - Source file for the MarketPricePing example.

Versions Used In Test

  • JDK 11
  • Gradle 8.9