Available services

These services are already defined and implemented in the Caplin Libraries.

Click on a service name to see details further down this page, or click on the API links to go directly to the full API reference document for that service.

BladeRunner Services

alias interface Description

br.html-service

caplin.services.HtmlResourceService

Used to retrieve HTML templates for the app.

br.xml-service

caplin.services.XmlResourceService

Used to retrieve XML documents for the app.

Caplin Trader Services

The following services are not available in BladeRunner by default, but are provided with Caplin Trader.

Click on a service name to see details further down this page, or click on the API links to go directly to the full API reference document for that service.

alias Name Description

caplin.business-date-service

caplin.fx.services.BusinessDateService

Retrieves FX business date information.

caplin.currency-pair-service

caplin.fx.services.CurrencyPairService

Lists FX currency pairs valid for the current user.

caplin.tenor-service

caplin.fx.services.TenorService

Lists FX tenors viewable by the current user.

caplin.layout-service

caplin.layout.LayoutService

Provides access to the user’s layouts.

caplin.connection-service

caplin.services.ConnectionService

Connects the app to a data streaming service.

caplin.message-service

caplin.services.MessageService

Accesses asynchronous messaging services.

caplin.preference-service

caplin.services.PreferencesService

Manages storage of user preferences.

caplin.user-service

caplin.services.UserService

Provides the login name of the current user.

caplin.permission-service

caplin.services.security.PermissionService

Provides permission sets for the logged in user.

caplin.tobo-user-service

caplin.trading.service.TOBOUserService

Manages activities of users who can trade on behalf of other users.

caplin.trade-permission-service

caplin.trading.service.TradePermissionService

Provides higher level permissioning information that can be used throughout the application.

caplin.trade-message-service

caplin.trading.trademodel.TradeMessageService

Provides an API for sending trade messages to the underlying trading system.

caplin.trade-service

caplin.trading.service.TradeService

Assists trade creation via factories registered with the trade service.

caplin.config-service

caplin.services.ConfigService

Provides information specific to this app instance.

caplin.user-prompt-service

caplin.services.UserPromptService

Manages the display of prompts to users.

caplin.log-store-service

caplin.core.log.LogStoreService

Used to cache and retrieve app log messages.

BladeRunner Services Detail

Provided Implementations refers only to implementations provided with BladeRunner as standard. Implementations that are provided as part of Caplin Trader are not mentioned in this section.

br.html-service

Description: Provides a means for retrieving HTML templates to be used in the application. Presenter uses this service internally to provide HTML resources for presentation models, but it’s possible to use this service for other uses.

br.xml-service

Description: Provides a means for retrieving XML documents to be used in the application. This includes grid definitions, Renderer definitions and state machine XML

Caplin Trader Services Detail

caplin.business-date-service

Description: A service that retrieves FX business date information, e.g. settlements dates for tenors, valid calendar trading dates, etc…​ It includes various listeners to capture changes to different date types, and supports asynchronous calls for business dates if needed.

caplin.currency-pair-service

Description: Provides a list of Foreign Exchange currency pairs that the current logged in user is entitled to view.

caplin.layout-service

Description: Provides access to the user’s layouts.

caplin.tenor-service

Description: Provides a list of Foreign Exchange tenors that the current logged in user is entitled to view.

caplin.connection-service

Description: Provides information about the status of a connection to a streaming server

caplin.message-service

Description: Provides access to publish/subscriber asynchronous messaging services, usually coupled with the ConnectionService.

This has been changed from caplin.services.MessageService.

caplin.preference-service

Description: A service that manages saving and retrieving of a user’s preferences.

caplin.user-service

Description: A service that provides the login name of the user that is currently logged in.

caplin.permission-service

Description: Provides a set of permissions and entitlements for the logged in user.

caplin.tobo-user-service

Description: A service designed for managing the activities of a client user who is permissioned to trade on behalf of other (TOBO) users.

caplin.trade-permission-service

Description: Provides high level trade permissioning information that can be used in trading applications that require tickets and tiles.

caplin.trade-message-service

Description: Provides an API for sending trade messages to the underlying trading system.

caplin.trade-service

Description: Provides an entry point for trade creation via delegation to factories registered with the trade service.

caplin.config-service

Description: Provides information specific to this application instance. Examples of this information are lists of available locales, application versions, URLs for web services etc.

caplin.user-prompt-service

Description: A service that manages how prompts are displayed to the user.

caplin.log-store-service

Description: A service that caches application log messages, and can be used to retrieve them at an arbitrary point in time.

The aliases listed are correct for version 3.10.0 and later. If you are using an older version, use the previous aliases below.

caplin.config-service was previously br.config-service.

caplin.user-prompt-service was previously br.user-prompt-service.

caplin.log-store-service was previously br.log-store-service.