Sportradar Unified Odds SDK for Java

https://github.com/sportradar/unifiedoddssdkjava
Admin
Sportradar Unified Odds SDK for Java is a client library that simplifies access to Sportradar's...
Tokens:566,721
Snippets:5,353
Trust Score:7.5
Update:1 month ago
Show doc for...
Tokens:
Raw
### Queue events and start replay with speed factor

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/_autodocs/api-reference/UofSdkForReplay.md

Example showing how to configure the UofSdkForReplay, add sport events to the replay, and start the replay with a speed factor and max delay.

```APIDOC
## Queue events and start replay with speed factor

### Description
Example of using UofSdkForReplay to queue sport events and start a replay with a speed factor.

### Code Example
```java
import com.sportradar.unifiedodds.sdk.*;
import com.sportradar.unifiedodds.sdk.internal.impl.ReplayManager;
import com.sportradar.utils.Urn;

UofConfiguration configuration = UofSdk.getUofConfigurationBuilder()
        .setAccessTokenFromApplicationYaml()
        .selectCustom()
        .loadConfigFromApplicationYml()
        .build();

UofSdkForReplay uofSdkForReplay = new UofSdkForReplay(new GlobalEventsListener(), configuration);
uofSdkForReplay.getSessionBuilder()
        .setMessageInterest(MessageInterest.AllMessages)
        .setListener(new MessageListener("ReplaySessionSetup"))
        .build();

ReplayManager replayManager = uofSdkForReplay.getReplayManager();

replayManager.addSportEventToReplay(Urn.parse("sr:match:12089842"));
replayManager.addSportEventToReplay(Urn.parse("sr:match:12089826"));
uofSdkForReplay.open();

// replay events 30x faster, max 500ms delay between messages
replayManager.play(30, 500);
```
```

--------------------------------

### start()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/impl/EventChangeManagerImpl.html

Starts the scheduled job for fetching fixture and result changes.

```APIDOC
## start()

### Description
Starts scheduled job for fetching fixture and result changes.

### Method
start

### Parameters
None

### Returns
void
```

--------------------------------

### play()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/impl/ReplayManager.html

Starts replay playback.

```APIDOC
## play()

### Description
Starts replay playback.

### Method
play

### Returns
- **boolean** - true if playback started successfully, false otherwise.
```

--------------------------------

### play()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/_autodocs/api-reference/UofSdkForReplay.md

Starts replaying all queued events.

```APIDOC
## play()

### Description
Starts replaying all queued events.

### Return Type
boolean
```

--------------------------------

### open()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/impl/SdkTaskSchedulerImpl.html

Opens the SDK task scheduler and starts all scheduled tasks.

```APIDOC
## open()

### Description
Opens the SDK task scheduler and starts all the scheduled tasks.

### Method
```java
public void open()
```

### Parameters
None

### Returns
void

### Specified By
`SdkTaskScheduler` interface.
```

--------------------------------

### getStartTimeTbd()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/entities/Fixture.html

An indication if the start time is yet to be defined.

```APIDOC
## getStartTimeTbd()

### Description
An indication if the start time is yet to be defined.

### Method
`Boolean getStartTimeTbd()`

### Returns
- **Boolean** - True if start time is to be defined, false otherwise.
```

--------------------------------

### getStartTime()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/entities/ReplaySportEvent.html

Returns an Integer specifying the start time.

```APIDOC
## Method: getStartTime

### Description
Returns an Integer specifying the start time of the replay sport event.

### Method Signature
```java
Integer getStartTime()
```

### Returns
- **Integer** - specifying the start time
```

--------------------------------

### UofConfigurationImpl.getEnvironment()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/cfg/class-use/Environment.html

Instance method to get the environment from the implementation class.

```APIDOC
## UofConfigurationImpl.getEnvironment()

### Description
Returns the environment from the UofConfigurationImpl.

### Method
Environment getEnvironment()

### Returns
- **Environment** - The configured environment.

### Example
java
Environment env = configImpl.getEnvironment();

```

--------------------------------

### ExportableCourseCi.getId()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/utils/class-use/Urn.html

Gets the identifier of the exportable course.

```APIDOC
## ExportableCourseCi.getId()

### Description
Gets the identifier of the exportable course.

### Method
getId

### Parameters
None

### Returns
Urn
```

--------------------------------

### RecoveryInitiated.getEventId()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/utils/class-use/Urn.html

Gets the associated event identifier.

```APIDOC
## RecoveryInitiated.getEventId()

### Description
Gets the associated event identifier.

### Method
getEventId

### Parameters
None

### Returns
Urn
```

--------------------------------

### getStartTime()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/entities/Fixture.html

Returns the Date instance specifying when the fixture is scheduled to start.

```APIDOC
## getStartTime()

### Description
Returns the Date instance specifying when the fixture is scheduled to start.

### Method
`Date getStartTime()`

### Returns
- **Date** - The scheduled start time of the fixture.
```

--------------------------------

### getConnectionStarted()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/impl/rabbitconnection/AmqpConnectionFactory.html

Gets the timestamp when the connection started.

```APIDOC
## getConnectionStarted()

### Description
Gets the timestamp when the connection started.

### Method
`long getConnectionStarted()`

### Returns
- `long` - the timestamp when the connection started
```

--------------------------------

### Basic configuration, session, and open

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/_autodocs/api-reference/UofSdk.md

Shows how to build a UofConfiguration with an access token and production environment, create a UofSdk instance, set up a session with a listener and message interest, and open/close the SDK. The close() call is commented as AutoCloseable cleanup.

```java
import com.sportradar.unifiedodds.sdk.*;

MyUofListener listener = new MyUofListener();
MyUofGlobalEventsListener globalEventsListener = new MyUofGlobalEventsListener();

UofConfiguration config = UofSdk.getUofConfigurationBuilder()
        .setAccessToken("your-token")
        .selectEnvironment(Environment.Production)
        .build();

UofSdk uofSdk = new UofSdk(globalEventsListener, config);

uofSdk.getSessionBuilder()
        .setListener(listener)
        .setMessageInterest(MessageInterest.AllMessages)
        .build();

uofSdk.open();      // starts receiving messages on the listener callback
// ... later ...
uofSdk.close();     // AutoCloseable, cleans up connections and schedulers
```

--------------------------------

### Constructor: RoutingKeyInfo(String fullRoutingKey, boolean systemRoutingKey)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/extended/RoutingKeyInfo.html

Initializes a new RoutingKeyInfo instance with a full routing key and a flag indicating whether it is a system routing key.

```APIDOC
## Constructor: RoutingKeyInfo(String fullRoutingKey, boolean systemRoutingKey)

### Description
Initializes a new RoutingKeyInfo instance with the provided full routing key and a flag indicating whether it is a system routing key.

### Parameters
- **fullRoutingKey** (String) - Required - The complete routing key.
- **systemRoutingKey** (boolean) - Required - Indicates if the routing key is a system routing key.

### Usage Example
```java
RoutingKeyInfo info = new RoutingKeyInfo("some.routing.key", false);
```
```

--------------------------------

### EventChangeManager usage example

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/_autodocs/api-reference/EventChangeManager.md

Shows how to obtain the EventChangeManager from UofSdk, set a listener for fixture and result changes, configure poll intervals, start and stop the job. The setFixtureChangeInterval and setResultChangeInterval methods require durations between 1 minute and 12 hours.

```java
EventChangeManager eventChangeManager = uofSdk.getEventChangeManager();

eventChangeManager.setListener(new EventChangeListener() {
    @Override
    public void onFixtureChange(Urn eventId, Date updated, SportEvent sportEvent) {
        System.out.println("fixture changed: " + eventId + " at " + updated);
    }

    @Override
    public void onResultChange(Urn eventId, Date updated, SportEvent sportEvent) {
        System.out.println("result changed: " + eventId + " at " + updated);
    }
});

// Poll every 5 minutes; resume from where we stopped last time
eventChangeManager.setFixtureChangeInterval(Duration.ofMinutes(5));
eventChangeManager.setResultChangeInterval(Duration.ofMinutes(5));
eventChangeManager.start();

// ... later
eventChangeManager.stop();
```

--------------------------------

### build

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/cfg/ConfigurationBuilderBase.html

Builds and returns a UofConfiguration instance with the configured settings.

```APIDOC
## build

### Method
build

### Returns

UofConfiguration - The constructed UofConfiguration instance.
```

--------------------------------

### onEventBooked

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/caching/CompetitionCi.html

Method that gets triggered when the associated event gets booked through the BookingManager.

```APIDOC
## onEventBooked

### Description
Method that gets triggered when the associated event gets booked through the BookingManager.

### Method
POST

### Endpoint
CompetitionCi.onEventBooked()

### Response
#### Success Response (200)
- **void** - No return value.

```

--------------------------------

### SportEventCache.onEventBooked(Urn id)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/caching/SportEventCache.html

Method that gets triggered when the associated event gets booked through the BookingManager.

```APIDOC
## SportEventCache.onEventBooked(Urn id)

### Description
Method that gets triggered when the associated event gets booked through the BookingManager.

### Method
SportEventCache.onEventBooked

### Signature
void onEventBooked(Urn id)

### Parameters
- **id** (Urn) - Required - The id of the booked event.
```

--------------------------------

### Queue events and start replay with speed factor

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/_autodocs/api-reference/UofSdkForReplay.md

Demonstrates how to configure the UofSdkForReplay, add sport events to the replay queue, and initiate playback with a specified speed factor and delay.

```java
import com.sportradar.unifiedodds.sdk.*;
import com.sportradar.unifiedodds.sdk.internal.impl.ReplayManager;
import com.sportradar.utils.Urn;

UofConfiguration configuration = UofSdk.getUofConfigurationBuilder()
        .setAccessTokenFromApplicationYaml()
        .selectCustom()
        .loadConfigFromApplicationYml()
        .build();

UofSdkForReplay uofSdkForReplay = new UofSdkForReplay(new GlobalEventsListener(), configuration);
uofSdkForReplay.getSessionBuilder()
        .setMessageInterest(MessageInterest.AllMessages)
        .setListener(new MessageListener("ReplaySessionSetup"))
        .build();

ReplayManager replayManager = uofSdkForReplay.getReplayManager();

replayManager.addSportEventToReplay(Urn.parse("sr:match:12089842"));
replayManager.addSportEventToReplay(Urn.parse("sr:match:12089826"));
uofSdkForReplay.open();

// replay events 30x faster, max 500ms delay between messages
replayManager.play(30, 500);
```

--------------------------------

### Initialize and open UofSdk

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/index.html

Sets up the Unified Odds SDK by creating listeners, building a configuration with an access token and integration selection, constructing the UofSdk, building a session with message interest, and opening the SDK to start receiving messages.

```java
        MyUofListener listener = new MyUofListener();
        MyUofGlobalEventsListener globalEventsListener = new MyUofGlobalEventsListener();

        UofConfiguration config = UofSdk.getUofConfigurationBuilder()
            .setAccessToken("your-integration-token-here")
            .selectIntegration()
            .build();

        UofSdk uofSdk = new UofSdk(globalEventsListener, config);

        UofSessionBuilder sessionBuilder = uofSdk.getSessionBuilder();
        sessionBuilder.setListener(listener).setMessageInterest(MessageInterest.AllMessages).build();

        uofSdk.open();
```

--------------------------------

### setStartTime(Date startTime)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/oddsentities/exportable/ExportableFixtureCi.html

Sets the start time of the fixture. This method allows updating the scheduled start date and time.

```APIDOC
## setStartTime(Date startTime)

### Description
Sets the start time of the fixture. This method allows updating the scheduled start date and time.

### Method
Setter

### Signature
`void setStartTime(Date startTime)`

### Parameters
- **startTime** (Date) - Required - The start time of the fixture.

### Return Type
void
```

--------------------------------

### setStartTimeTbd(Boolean startTimeTbd)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/oddsentities/exportable/ExportableFixtureCi.html

Sets whether the start time is to be determined. This method allows updating the TBD status of the fixture start time.

```APIDOC
## setStartTimeTbd(Boolean startTimeTbd)

### Description
Sets whether the start time is to be determined. This method allows updating the TBD status of the fixture start time.

### Method
Setter

### Signature
`void setStartTimeTbd(Boolean startTimeTbd)`

### Parameters
- **startTimeTbd** (Boolean) - Required - Indicates if the start time is to be determined.

### Return Type
void
```

--------------------------------

### open()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/impl/SdkProducerManager.html

Opens the producer manager, initializing any required resources.

```APIDOC
## open()

### Description
Opens the producer manager, initializing any required resources.

### Method
open

### Signature
`void open()`

### Parameters
None

### Returns
void
```

--------------------------------

### setStartTimeConfirmed(boolean startTimeConfirmed)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/oddsentities/exportable/ExportableFixtureCi.html

Sets whether the start time is confirmed. This method allows updating the confirmation status of the fixture start time.

```APIDOC
## setStartTimeConfirmed(boolean startTimeConfirmed)

### Description
Sets whether the start time is confirmed. This method allows updating the confirmation status of the fixture start time.

### Method
Setter

### Signature
`void setStartTimeConfirmed(boolean startTimeConfirmed)`

### Parameters
- **startTimeConfirmed** (boolean) - Required - Indicates if the start time is confirmed.

### Return Type
void
```

--------------------------------

### YAML configuration file (application.yml)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/_autodocs/configuration.md

Example of the `application.yml` file loaded by `SdkConfigurationYamlReader`. Placeholders show where to set the access token, node ID, default language, desired languages, disabled producers, exception handling strategy, environment, and custom messaging/API host settings.

```yaml
sportradar:
  sdk:
    uf:
      accessToken:            # access token
      nodeId:                 # node id
      defaultLanguage:        # default language
      desiredLanguages:       # comma delimited list, e.g. en,it,de
      disabledProducers:      # comma delimited list, e.g. 3,4
      exceptionHandlingStrategy:  # Throw / Catch
      environment:            # Integration, Production, Custom, Replay, GlobalReplay, ...
      messagingHost:          # custom env
      messagingPort:
      messagingUsername:
      messagingPassword:
      messagingVirtualHost:
      messagingUseSsl:
      apiHost:                # custom env
      apiPort:
      apiUseSsl:
```

--------------------------------

### Constructor: RoutingKeyInfo(String fullRoutingKey, Urn sportId, Urn eventId)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/extended/RoutingKeyInfo.html

Initializes a new RoutingKeyInfo instance with a full routing key, sport ID, and event ID.

```APIDOC
## RoutingKeyInfo(String fullRoutingKey, Urn sportId, Urn eventId)

### Description
Initializes a new RoutingKeyInfo instance with the provided full routing key, sport ID, and event ID.

### Parameters
- **fullRoutingKey** (String) - Required - The complete routing key.
- **sportId** (Urn) - Required - The sport identifier as a Urn.
- **eventId** (Urn) - Required - The event identifier as a Urn.

### Example
```java
RoutingKeyInfo info = new RoutingKeyInfo("key", sportUrn, eventUrn);
```
```

--------------------------------

### get(String, Map<String,String>)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/impl/LogHttpDataFetcher.html

Performs an HTTP GET request to the specified path with the given headers and returns the response data.

```APIDOC
## Method: get

### Description
Performs an HTTP GET request to the specified path with the provided headers and returns the response data.

### Signature
public HttpData get(String path, Map<String,String> headers) throws CommunicationException

### Parameters
- **path** (String) - Required - The request path.
- **headers** (Map<String,String>) - Required - A map of header names to values.

### Returns
- **HttpData** - The response data.

### Throws
- **CommunicationException** - If a communication error occurs.
```

--------------------------------

### Manual recovery after restart

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/_autodocs/api-reference/ProducerManager.md

Example showing how to set a recovery point for a producer and open the SDK.

```APIDOC
## Manual recovery after restart

### Description
Demonstrates setting a recovery point 2 days back for the LiveOdds producer (id: 1) and opening the SDK.

### Code Example
```java
import java.util.Calendar;

ProducerManager producerManager = uofSdk.getProducerManager();

// Set recovery point 2 days back for the LiveOdds producer (id: 1)
Calendar cal = Calendar.getInstance();
cal.add(Calendar.DATE, -2);
producerManager.setProducerRecoveryFromTimestamp(1, cal.getTime().getTime());

// configure sessions...
uofSdk.open();
```
```

--------------------------------

### onEventBooked(Urn id)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/caching/SportEventCache.html

Method that gets triggered when the associated event gets booked through the BookingManager. It is used to notify the cache of a successful booking.

```APIDOC
## onEventBooked(Urn id)

### Description
Method that gets triggered when the associated event gets booked through the BookingManager.

### Method
onEventBooked

### Parameters
- **id** (Urn) - Required - The Urn of the event that was successfully booked.

### Returns
void
```

--------------------------------

### setScheduledStartTimeChanges(List<ExportableScheduledStartTimeChangeCi> scheduledStartTimeChanges)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/oddsentities/exportable/ExportableFixtureCi.html

Sets the list of scheduled start time changes for the fixture. This method allows updating the collection of start time change records.

```APIDOC
## setScheduledStartTimeChanges(List<ExportableScheduledStartTimeChangeCi> scheduledStartTimeChanges)

### Description
Sets the list of scheduled start time changes for the fixture. This method allows updating the collection of start time change records.

### Method
Setter

### Signature
`void setScheduledStartTimeChanges(List<ExportableScheduledStartTimeChangeCi> scheduledStartTimeChanges)`

### Parameters
- **scheduledStartTimeChanges** (List<ExportableScheduledStartTimeChangeCi>) - Required - The list of scheduled start time change objects.

### Return Type
void
```

--------------------------------

### build()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/cfg/ConfigurationBuilderBase.html

Builds and returns the configuration.

```APIDOC
## build()

### Description
Builds and returns a UofConfiguration instance.

### Method
build()

### Return Type
UofConfiguration - the built configuration instance

### Parameters
None

### Example
```java
UofConfiguration config = builder.build();
```
```

--------------------------------

### onMessageProcessingStarted(int uniqueMessageProcessorIdentifier, int producerId, Long requestId, long now)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/managers/RecoveryManager.html

Method invoked when the AMQP message processing started. This callback is used to signal the start of processing a message.

```APIDOC
## onMessageProcessingStarted(int uniqueMessageProcessorIdentifier, int producerId, Long requestId, long now)

### Description
Method invoked when the AMQP message processing started.

### Method
Callback

### Parameters
- **uniqueMessageProcessorIdentifier** (int) - Required - The unique identifier of the message processor.
- **producerId** (int) - Required - The identifier of the producer.
- **requestId** (Long) - Required - The request identifier associated with the message.
- **now** (long) - Required - The current timestamp.

### Return Type
void
```

--------------------------------

### getSetting(Environment environment)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/impl/EnvironmentManager.html

Gets the MQ and API settings for the specified Environment.

```APIDOC
## getSetting(Environment environment)

### Description
Gets the MQ and API settings for the specified Environment.

### Method
static EnvironmentSetting getSetting(Environment environment)

### Parameters
- **environment** (Environment) - Required - The environment for which to retrieve the settings.

### Returns
- **EnvironmentSetting** - The MQ and API settings for the specified environment.
```

--------------------------------

### getNodeId()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/oddsentities/RecoveryInfo.html

Gets the node identifier.

```APIDOC
## getNodeId()

### Description
Gets the node identifier.

### Method
`int getNodeId()`

### Returns
- **int** - the node identifier
```

--------------------------------

### getEventStatus()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/entities/Competition.html

Get the event status.

```APIDOC
## getEventStatus()

### Description
Get the event status.

### Method
`default EventStatus getEventStatus()`

### Returns
- `EventStatus` - the event status.
```

--------------------------------

### open(List<String> routingKeys, ChannelMessageConsumer channelMessageConsumer, String messageInterest)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/impl/rabbitconnection/OnDemandChannelSupervisor.html

Opens the current channel and binds the created queue to the provided routing keys. Throws IOException if the routing keys bind failed.

```APIDOC
## open(List<String> routingKeys, ChannelMessageConsumer channelMessageConsumer, String messageInterest)

### Description
Opens the current channel and binds the created queue to the provided routing keys.

### Method
open

### Parameters
- **routingKeys** (List<String>) - Required - A list of routing keys which should be binded.
- **channelMessageConsumer** (ChannelMessageConsumer) - Required - A ChannelMessageConsumer which consumes the received payloads.
- **messageInterest** (String) - Required - Message interest this channel is linked to.

### Throws
- **IOException** - if the routing keys bind failed.

```

--------------------------------

### getCache()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/cfg/UofConfiguration.html

Get the cache configuration.

```APIDOC
## getCache()

### Description
Get the cache configuration.

### Method
GET (Java method call)

### Signature
`UofCacheConfiguration getCache()`

### Return Type
`UofCacheConfiguration` - The cache configuration.

```

--------------------------------

### Logging via LoggerDefinitions

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/_autodocs/api-reference/MessageInterest.md

Shows how to initialize a logger using the UfSdkClientInteractionLog marker interface.

```java
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

private static final Logger clientInteractionLogger = LoggerFactory.getLogger(
        LoggerDefinitions.UfSdkClientInteractionLog.class);

public void book(Urn eventId) {
    clientInteractionLogger.info("BookingManager.bookLiveOddsEvent({})", eventId);
    // ...
}
```

--------------------------------

### Constructor UofSdkForReplay(UofGlobalEventsListener, UofConfiguration, CustomisableSdkModule)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/UofSdkForReplay.html

Initializes a new UofSdkForReplay instance with the provided listener, configuration, and customisable SDK module.

```APIDOC
## Constructor UofSdkForReplay(UofGlobalEventsListener, UofConfiguration, CustomisableSdkModule)

### Description
Initializes a new UofSdkForReplay instance with the specified global events listener, configuration, and customisable SDK module.

### Parameters
- **listener** (UofGlobalEventsListener) - Required - The listener for global events.
- **config** (UofConfiguration) - Required - The configuration for the SDK.
- **customisableSdkModule** (CustomisableSdkModule) - Required - The customisable SDK module.

### Example
```java
UofGlobalEventsListener listener = ...;
UofConfiguration config = ...;
CustomisableSdkModule module = ...;
UofSdkForReplay sdk = new UofSdkForReplay(listener, config, module);
```
```

--------------------------------

### getApi()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/cfg/UofConfiguration.html

Get the Api configuration.

```APIDOC
## getApi()

### Description
Get the Api configuration.

### Method
GET (Java method call)

### Signature
`UofApiConfiguration getApi()`

### Return Type
`UofApiConfiguration` - The API configuration.

```

--------------------------------

### getAdditional()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/cfg/UofConfiguration.html

Get the additional configuration.

```APIDOC
## getAdditional()

### Description
Get the additional configuration.

### Method
GET (Java method call)

### Signature
`UofAdditionalConfiguration getAdditional()`

### Return Type
`UofAdditionalConfiguration` - The additional configuration.

```

--------------------------------

### Constructor: ProducerInfoCi(SapiProductInfo pInfo)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/caching/ci/ProducerInfoCi.html

Initializes a new instance of the ProducerInfoCi class with the provided SapiProductInfo.

```APIDOC
## Constructor: ProducerInfoCi(SapiProductInfo pInfo)

### Description
Initializes a new instance of the ProducerInfoCi class.

### Parameters
- **pInfo** (SapiProductInfo) - Required - The product information used to initialize the instance.

```

--------------------------------

### Constructor UofSdkForReplay(UofGlobalEventsListener, UofConfiguration)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/UofSdkForReplay.html

Initializes a new UofSdkForReplay instance with the provided listener and configuration.

```APIDOC
## Constructor UofSdkForReplay(UofGlobalEventsListener, UofConfiguration)

### Description
Initializes a new UofSdkForReplay instance with the specified global events listener and configuration.

### Parameters
- **listener** (UofGlobalEventsListener) - Required - The listener for global events.
- **config** (UofConfiguration) - Required - The configuration for the SDK.

### Example
```java
UofGlobalEventsListener listener = ...;
UofConfiguration config = ...;
UofSdkForReplay sdk = new UofSdkForReplay(listener, config);
```
```

--------------------------------

### getChangeReason()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/oddsentities/OddsChange.html

Get the reason why the odds changed.

```APIDOC
## Interface Method

### Description
Get the reason why the odds changed.

### Method
`OddsChangeReason getChangeReason()`

### Parameters
None.

### Return Value
- **OddsChangeReason** - The enum representing the reason for the odds change.

### Example
```java
OddsChangeReason reason = oddsChange.getChangeReason();
```
```

--------------------------------

### Constructor ExportableTournamentStageCi(String id, Map<Locale,String> names, Date scheduled, Date scheduledEnd, Boolean startTimeTbd, String replacedBy, BookingStatus bookingStatus, List<String> competitorIds, ExportableVenueCi venue, ExportableSportEventConditionsCi conditions, Map<String,Map<String,String>> competitorsReferences, String parentStageId, List<String> stagesIds, StageType stageType, String categoryId, Locale defaultLocale, List<Locale> cachedLocales, String liveOdds, SportEventType sportEventType)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/oddsentities/exportable/ExportableTournamentStageCi.html

Creates an instance of ExportableTournamentStageCi with the provided parameters to represent an exportable tournament stage.

```APIDOC
## Constructor: ExportableTournamentStageCi

### Description
Creates an instance of ExportableTournamentStageCi with the provided parameters to represent an exportable tournament stage.

### Parameters
- **id** (String) - Required - The unique identifier of the tournament stage.
- **names** (Map<Locale,String>) - Required - A map of localized names for the tournament stage.
- **scheduled** (Date) - Required - The scheduled start date and time.
- **scheduledEnd** (Date) - Required - The scheduled end date and time.
- **startTimeTbd** (Boolean) - Required - Indicates if the start time is to be determined.
- **replacedBy** (String) - Required - The identifier of the event that replaces this one, if any.
- **bookingStatus** (BookingStatus) - Required - The booking status of the event.
- **competitorIds** (List<String>) - Required - A list of competitor identifiers.
- **venue** (ExportableVenueCi) - Required - The venue information.
- **conditions** (ExportableSportEventConditionsCi) - Required - The sport event conditions.
- **competitorsReferences** (Map<String,Map<String,String>>) - Required - References for competitors.
- **parentStageId** (String) - Required - The identifier of the parent stage, if any.
- **stagesIds** (List<String>) - Required - A list of stage identifiers.
- **stageType** (StageType) - Required - The type of the stage.
- **categoryId** (String) - Required - The identifier of the category.
- **defaultLocale** (Locale) - Required - The default locale for the event.
- **cachedLocales** (List<Locale>) - Required - A list of cached locales.
- **liveOdds** (String) - Required - The live odds information.
- **sportEventType** (SportEventType) - Required - The type of the sport event.

### Example
```java
ExportableTournamentStageCi stage = new ExportableTournamentStageCi(
    "id",
    namesMap,
    scheduledDate,
    scheduledEndDate,
    true,
    null,
    BookingStatus.UNKNOWN,
    competitorIds,
    venue,
    conditions,
    competitorsReferences,
    null,
    stagesIds,
    StageType.CUP,
    "categoryId",
    Locale.ENGLISH,
    cachedLocales,
    "liveOdds",
    SportEventType.NOT_STARTED
);
```
```

--------------------------------

### Initialize UofSdk Instance

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/migration-guide-v3.md

Builds the UofConfiguration from SDK properties and initializes the UofSdk instance.

```java
UofConfiguration config = UofSdk.getUofConfigurationBuilder().buildConfigFromSdkProperties();
UofSdk uofSdk = new UofSdk(new GlobalEventsListener(), config);
```

--------------------------------

### getProbability()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/entities/custombet/CalculationFilter.html

Gets the probability value for the calculation.

```APIDOC
## getProbability()

### Description
Gets the probability value for the calculation.

### Method
`double getProbability()`

### Returns
- **double** - the probability value
```

--------------------------------

### PrebuiltBetsImpl

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/impl/custombetentities/PrebuiltBetsImpl.html

Constructor for the PrebuiltBetsImpl class.

```APIDOC
## Constructor: PrebuiltBetsImpl

### Description
Creates a new instance of the PrebuiltBetsImpl class using the provided CapiPreBuiltBets data object.

### Signature
public PrebuiltBetsImpl(com.sportradar.uf.custombet.datamodel.CapiPreBuiltBets preBuiltBets)

### Parameters
- **preBuiltBets** (com.sportradar.uf.custombet.datamodel.CapiPreBuiltBets) - Required - The CAPI pre-built bets data object.

```

--------------------------------

### getOdds()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/entities/custombet/CalculationFilter.html

Gets the odds value for the calculation.

```APIDOC
## getOdds()

### Description
Gets the odds value for the calculation.

### Method
`double getOdds()`

### Returns
- **double** - the odds value
```

--------------------------------

### getCourses()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/entities/Venue.html

Gets the list of the course holes.

```APIDOC
## getCourses()

### Description
Gets the list of the course holes.

### Method
`default List<Course> getCourses()`

### Returns
- `List<Course>` - The list of the course holes.
```

--------------------------------

### Constructor ProducerData(int id, String name, String description, boolean active, String apiUrl, String producerScopes, Integer statefulRecoveryWindowInMinutes)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/impl/ProducerData.html

Creates a new ProducerData instance with the specified producer details.

```APIDOC
## Constructor

### Signature
`ProducerData(int id, String name, String description, boolean active, String apiUrl, String producerScopes, Integer statefulRecoveryWindowInMinutes)`

### Description
Creates a new ProducerData instance with the given producer details.

### Parameters
- **id** (int) - The producer ID.
- **name** (String) - The producer name.
- **description** (String) - The producer description.
- **active** (boolean) - Whether the producer is active.
- **apiUrl** (String) - The API URL for the producer.
- **producerScopes** (String) - The producer scopes as a string.
- **statefulRecoveryWindowInMinutes** (Integer) - The stateful recovery window in minutes.
```

--------------------------------

### getUsage()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/cfg/UofConfiguration.html

Gets the settings for usage exporter.

```APIDOC
## getUsage()

### Description
Gets the settings for usage exporter.

### Method
GET (Java method call)

### Signature
`UofUsageConfiguration getUsage()`

### Return Type
`UofUsageConfiguration` - The usage configuration.

```

--------------------------------

### open

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/UofSdk.html

This method opens/starts the feed with all the built sessions and creates the various tasks needed for optimal UofSdk operation.

```APIDOC
## open

### Description
This method opens/starts the feed with all the built sessions and creates the various tasks needed for optimal UofSdk operation.

### Method
POST

### Endpoint
`open()`

### Throws
- **InitException** - if the feed cannot be opened

```

--------------------------------

### buildConfigFromApplicationYml()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/cfg/TokenSetterImpl.html

Sets the general configuration properties to values read from a configuration file. Only values that can be set through ConfigurationBuilderBase methods are set. Any values already set by methods on the current instance are overridden. Builds and returns a UofConfigurationImpl instance.

```APIDOC
## buildConfigFromApplicationYml()

### Description
Sets the general configuration properties to values read from configuration file. Only value which can be set through ConfigurationBuilderBase methods are set. Any values already set by methods on the current instance are overridden. Builds and returns a UofConfigurationImpl instance. The YAML file should be named "application.yml" and located in the application resources folder.

### Method
buildConfigFromApplicationYml

### Signature
public UofConfiguration buildConfigFromApplicationYml()

### Returns
- **UofConfiguration** - builds and returns a UofConfigurationImpl instance
```

--------------------------------

### getProducer()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/cfg/UofConfiguration.html

Get the producer and session configuration.

```APIDOC
## getProducer()

### Description
Get the producer and session configuration.

### Method
GET (Java method call)

### Signature
`UofProducerConfiguration getProducer()`

### Return Type
`UofProducerConfiguration` - The producer and session configuration.

```

--------------------------------

### getEnvironmentSettings()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/impl/EnvironmentManager.html

Gets the list of all possible environment settings (Custom is not listed, as user should manually put MQ and API host).

```APIDOC
## getEnvironmentSettings()

### Description
Gets the list of all possible environment settings (Custom is not listed, as user should manually put MQ and API host).

### Method
static List<EnvironmentSetting> getEnvironmentSettings()

### Returns
- **List<EnvironmentSetting>** - A list of all possible environment settings.
```

--------------------------------

### Fluent build with environment selection

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/_autodocs/api-reference/cfg.md

Builds a UofConfiguration using the fluent builder with a predefined environment (GlobalIntegration). Sets access token, node ID, languages, recovery time, and inactivity seconds before building the configuration.

```java
ConfigurationBuilder cfgBuilder = UofSdk.getUofConfigurationBuilder()
        .setAccessToken("your-token")
        .selectEnvironment(Environment.GlobalIntegration)
        .setNodeId(17)
        .setDefaultLanguage(Locale.ENGLISH)
        .setDesiredLanguages(Arrays.asList(Locale.GERMAN, Locale.FRENCH))
        .setMaxRecoveryTime(3600)
        .setInactivitySeconds(30);

UofConfiguration config = cfgBuilder.build();
```

--------------------------------

### build()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/impl/CustomBetSelectionBuilderImpl.html

Builds and returns a Selection instance.

```APIDOC
## build()

### Description
Builds and returns a Selection instance.

### Method
build

### Signature
`Selection build()`

### Returns
- **Selection** - The built Selection instance.

```

--------------------------------

### getOldTime()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/oddsentities/exportable/ExportableScheduledStartTimeChangeCi.html

Returns the original scheduled start time.

```APIDOC
## getOldTime()

### Description
Returns the original scheduled start time.

### Method
public Date getOldTime()

### Returns
- **Date** - The original scheduled start time.
```

--------------------------------

### setStartTimeTbd

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/oddsentities/exportable/ExportableFixtureCi.html

Sets whether the start time is to be determined.

```APIDOC
## setStartTimeTbd

### Description
Sets whether the start time is to be determined.

### Method
public void setStartTimeTbd(Boolean startTimeTbd)

### Parameters
- **startTimeTbd** (Boolean) - true if the start time is to be determined, false otherwise.
```

--------------------------------

### play(double speedupFactor, int maxDelayInMs, Boolean runParallel)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/_autodocs/api-reference/UofSdkForReplay.md

Starts replay with speed control and parallel replay option.

```APIDOC
## play(double speedupFactor, int maxDelayInMs, Boolean runParallel)

### Description
Additionally controls parallel event replay.

### Parameters
- **speedupFactor** (double) - Required - The speedup factor.
- **maxDelayInMs** (int) - Required - Maximum delay between messages in milliseconds.
- **runParallel** (Boolean) - Required - Whether to run parallel replay.

### Return Type
boolean
```

--------------------------------

### isStartTimeTbd()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/caching/SportEventCi.html

Returns whether the start time is to be determined.

```APIDOC
## isStartTimeTbd()

### Description
Returns the Boolean specifying if the start time to be determined is set for the current instance.

### Method
java.util.Optional<java.lang.Boolean> isStartTimeTbd()

### Returns
- **Type**: java.util.Optional<java.lang.Boolean>
- **Description**: The Optional containing the Boolean value, or empty if not available.
```

--------------------------------

### buildConfigFromApplicationYml

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/cfg/TokenSetter.html

Builds a UofConfiguration from the application.yml file.

```APIDOC
## buildConfigFromApplicationYml

### Description
Sets the general configuration properties to values read from configuration file. Only values which can be set through ConfigurationBuilderBase methods are set. Any values already set by methods on the current instance are overridden. Builds and returns a UofConfiguration instance. The YAML file should be named "application.yml" and located in the application resources folder.

### Method
buildConfigFromApplicationYml

### Signature
UofConfiguration buildConfigFromApplicationYml()

### Returns
UofConfiguration - Builds and returns a UofConfiguration instance.
```

--------------------------------

### AND/OR groups and prebuilt bets

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/_autodocs/api-reference/CustomBetManager.md

Shows how to construct complex bet requests using AND/OR logic and how to retrieve prebuilt betting recommendations, including error handling for communication failures.

```java
CalculateRequestBuilder request = customBetManager.getCalculateRequestBuilder()
        .andSelection(homeWin)              // leg 1
        .andSelection(awayWinOfAnother)     // leg 2
        .andAnyOfSelections(correctScore1, correctScore2) // leg 3: any of the two
        .andAnyOfSelections(teamTotalOver, teamTotalUnder);

Calculation result = customBetManager.calculateProbability(request);

// Prebuilt bets
PrebuiltBetsRequest prebuiltRequest = customBetManager.getPrebuiltBetsRequestBuilder()
        .setEventId(Urn.parse("sr:match:12329150"))
        .setCount(10)
        .setLength(2)
        .build();

try {
    PrebuiltBets prebuiltBets = customBetManager.getPrebuiltBets(prebuiltRequest);
    for (EventRecommendations recs : prebuiltBets.getEvents()) {
        for (Recommendation r : recs.getRecommendations()) {
            System.out.println("prebuilt odds " + r.getOdds() + " probability " + r.getProbability());
        }
    }
} catch (CommunicationException e) {
    // API request failed
}
```

--------------------------------

### getScheduledStartTimeChanges()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/entities/Fixture.html

Returns the list of all ScheduledStartTimeChange to start time.

```APIDOC
## getScheduledStartTimeChanges()

### Description
Returns the list of all ScheduledStartTimeChange to start time.

### Method
`List<ScheduledStartTimeChange> getScheduledStartTimeChanges()`

### Returns
- **List<ScheduledStartTimeChange>** - List of scheduled start time changes.
```

--------------------------------

### create()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/cfg/SdkConfigurationPropertiesReaderFactory.html

Creates a new SdkConfigurationPropertiesReader instance without specifying a file name.

```APIDOC
## create()

### Description
Creates a new SdkConfigurationPropertiesReader instance without specifying a file name.

### Method
create()

### Signature
public static SdkConfigurationPropertiesReader create()

### Parameters
None

### Returns
SdkConfigurationPropertiesReader - A new instance of SdkConfigurationPropertiesReader.
```

--------------------------------

### getUuid

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/utils/SdkHelper.html

Gets a substring of a UUID of the specified size.

```APIDOC
## getUuid

### Description
Gets a substring of a UUID of the specified size.

### Method
public static String getUuid(int size)

### Parameters
- **size** (int) - Required - The substring size.

### Returns
String - The substring of the UUID.
```

--------------------------------

### build()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/UofSessionBuilder.html

Creates the newly configured session using the supplied message interest and listeners. Returns the session instance.

```APIDOC
## build()

### Description
Creates the newly configured session using the supplied message interest and listeners. Returns the session instance.

### Method
build

### Returns
- **UofSession** - The session instance
```

--------------------------------

### getResponseMessage()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/oddsentities/RecoveryInfo.html

Gets the response message of the recovery request.

```APIDOC
## getResponseMessage()

### Description
Gets the response message of the recovery request.

### Method
`String getResponseMessage()`

### Returns
- **String** - the response message of the recovery request
```

--------------------------------

### configure()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/di/MasterInjectionModule.html

Configures the dependency injection bindings for the SDK. This method is called by the Guice framework to set up the module's bindings.

```APIDOC
## configure()

### Description
Configures the dependency injection bindings for the SDK. This method is called by the Guice framework to set up the module's bindings.

### Method
`protected void configure()`

### Overrides
`configure` in class `com.google.inject.AbstractModule`
```

--------------------------------

### Retrieve static market descriptions and mappings

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/_autodocs/api-reference/MarketDescriptionManager.md

Demonstrates how to obtain the MarketDescriptionManager from the SDK, iterate through market descriptions in a specific locale, and retrieve market mapping data for a specific producer.

```java
MarketDescriptionManager manager = uofSdk.getMarketDescriptionManager();

for (MarketDescription md : manager.getMarketDescriptions(Locale.GERMAN)) {
    System.out.println(md.getId() + " = " + md.getName(Locale.GERMAN));
}

Producer producer = uofSdk.getProducerManager().getProducer(1); // LiveOdds
List<MarketMappingData> mappings = manager.getMarketMapping(123, producer);
```

--------------------------------

### getResponseCode()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/oddsentities/RecoveryInfo.html

Gets the response code of the recovery request.

```APIDOC
## getResponseCode()

### Description
Gets the response code of the recovery request.

### Method
`int getResponseCode()`

### Returns
- **int** - the response code of the recovery request
```

--------------------------------

### getTimestamp()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/oddsentities/RecoveryInfo.html

Gets the timestamp specifying when the recovery was initiated.

```APIDOC
## getTimestamp()

### Description
Gets the timestamp specifying when the recovery was initiated.

### Method
`long getTimestamp()`

### Returns
- **long** - the timestamp specifying when the recovery was initiated
```

--------------------------------

### create(String fileName)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/cfg/SdkConfigurationPropertiesReaderFactory.html

Creates a new SdkConfigurationPropertiesReader instance using the specified file name.

```APIDOC
## create(String fileName)

### Description
Creates a new SdkConfigurationPropertiesReader instance using the specified file name.

### Method
create(String fileName)

### Signature
public static SdkConfigurationPropertiesReader create(String fileName)

### Parameters
- **fileName** (String) - Required - The name of the properties file to read.

### Returns
SdkConfigurationPropertiesReader - A new instance of SdkConfigurationPropertiesReader.
```

--------------------------------

### Example: Live-only session and event-scoped session

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/_autodocs/api-reference/UofSessionBuilder.md

Shows how to create a live-only session and a session restricted to specific events.

```APIDOC
## Example: Live-only session and event-scoped session

### Description
Creates a live-only session (excludes pre-match OddsChange, filters BetSettlement until confirmed) and a session restricted to two specific events.

### Code
```java
import com.sportradar.utils.Urn;

// Live-only: excludes pre-match OddsChange, filters BetSettlement until confirmed
uofSdk.getSessionBuilder()
        .setListener(listener)
        .setMessageInterest(MessageInterest.LiveMessagesOnly)
        .build();

// Session restricted to two specific events
Set<Urn> events = new HashSet<>(Arrays.asList(
        Urn.parse("sr:match:12329150"),
        Urn.parse("sr:match:12329151")));

uofSdk.getSessionBuilder()
        .setListener(listener)
        .setSpecificEventsOnly(events)
        .build();
```

```

--------------------------------

### getHost()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/cfg/UofUsageConfigurationImpl.html

Gets the host to which the usage metrics are exported.

```APIDOC
## getHost()

### Description
Gets the host to which the usage metrics are exported.

### Method
getHost

### Returns
String - the host.
```

--------------------------------

### getExportTimeoutInSec()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/internal/cfg/UofUsageConfigurationImpl.html

Gets the timeout for exporting usage metrics.

```APIDOC
## getExportTimeoutInSec()

### Description
Gets the timeout for exporting usage metrics.

### Method
getExportTimeoutInSec

### Returns
int - the export timeout in seconds.
```

--------------------------------

### buildConfigFromApplicationYml()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/cfg/TokenSetter.html

Sets the general configuration properties to values read from configuration file.

```APIDOC
## buildConfigFromApplicationYml()

### Description
Sets the general configuration properties to values read from configuration file.

### Method
buildConfigFromApplicationYml

### Returns
- **UofConfiguration** - The built configuration.
```

--------------------------------

### MarketManagerImpl.getMarketDescriptions()

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/entities/markets/class-use/MarketDescription.html

Get the list of all available market descriptions.

```APIDOC
## Method: getMarketDescriptions()

### Description
Get the list of all available market descriptions.

### Method
GET

### Endpoint
Not applicable (SDK method)

### Parameters
None

### Response
#### Success Response (200)
- **List<MarketDescription>** - List of market descriptions

#### Response Example
```java
List<MarketDescription> descriptions = marketManagerImpl.getMarketDescriptions();
```
```

--------------------------------

### UofSdk(UofGlobalEventsListener listener, UofConfiguration config)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/_autodocs/api-reference/UofSdk.md

Public constructor that initializes the SDK with a global events listener and configuration. Does not connect; initialization is lazy. Throws NullPointerException if either argument is null.

```APIDOC
## UofSdk(UofGlobalEventsListener listener, UofConfiguration config)

### Description
Public constructor that initializes the SDK with a global events listener and configuration. Does not connect; initialization is lazy. Throws NullPointerException if either argument is null.

### Method
Constructor

### Signature
```java
public UofSdk(final UofGlobalEventsListener listener, final UofConfiguration config)
```

### Parameters
- **listener** (UofGlobalEventsListener) - Required - Listener that handles global feed events (producer status, connection status, recovery status)
- **config** (UofConfiguration) - Required - Configuration obtained from `UofSdk.getUofConfigurationBuilder()`

### Exceptions
- **NullPointerException** - Thrown if either argument is null (Guava `Preconditions.checkNotNull`)

### Notes
- Initialization is lazy; does not connect.

```

--------------------------------

### setStartDate(Date startDate)

Source: https://github.com/sportradar/unifiedoddssdkjava/blob/master/docs/com/sportradar/unifiedodds/sdk/oddsentities/exportable/ExportableSeasonCi.html

Sets the start date of the season.

```APIDOC
## Method setStartDate

### Description
Sets the start date of the season.

### Signature
`void setStartDate(Date startDate)`

### Parameters
- **startDate** (Date) - Required - The start date to set.

### Example
```java
season.setStartDate(startDate);
```
```
Tokens:
Raw