Package com.symphony.bdk.core.service.datafeed.impl

Class DatafeedLoopV1

java.lang.Object

com.symphony.bdk.core.service.datafeed.impl.DatafeedLoopV1

All Implemented Interfaces:

DatafeedLoop

@API(status=INTERNAL)
public class DatafeedLoopV1
extends Object

A class for implementing the datafeed v1 loop service.

This service will be started by calling DatafeedLoop.start()

At the beginning, a datafeed will be created and the BDK bot will listen to this datafeed to receive the real-time events. With datafeed service v1, we don't have the api endpoint to retrieve the datafeed id that a service account is listening, so, the id of the created datafeed must be persisted in the bot side.

The BDK bot will listen to this datafeed to get all the received real-time events.

From the second time, the bot will firstly retrieve the datafeed that was persisted and try to read the real-time events from this datafeed. If this datafeed is expired or faulty, the datafeed service will create the new one for listening.

This service will be stopped by calling DatafeedLoop.stop()

If the datafeed service is stopped during a read datafeed call, it has to wait until the last read finish to be really stopped

Field Summary

Fields

Modifier and Type	Field	Description
protected final AuthSession	authSession
protected final com.symphony.bdk.core.config.model.BdkConfig	bdkConfig
protected final UserV2	botInfo
protected DatafeedApi	datafeedApi
protected final AtomicBoolean	started

Constructor Summary

Constructors

Constructor	Description
DatafeedLoopV1(DatafeedApi datafeedApi, AuthSession authSession, com.symphony.bdk.core.config.model.BdkConfig config, UserV2 botInfo)
DatafeedLoopV1(DatafeedApi datafeedApi, AuthSession authSession, com.symphony.bdk.core.config.model.BdkConfig config, UserV2 botInfo, DatafeedIdRepository repository)

Method Summary

Modifier and Type	Method	Description
protected void	handleV4EventList(List<V4Event> events)	Handle a received listener by using the subscribed RealTimeEventListener.
long	lastPullTimestamp()	The timestamp of the last successful pulling
protected void	refresh()
protected Optional<String>	retrieveDatafeed()
protected void	runLoop()
void	start()	Start the datafeed events service
void	stop()	Stop the datafeed events service.
void	subscribe(RealTimeEventListener listener)	The bot subscribes to a RealTimeEventListener
void	unsubscribe(RealTimeEventListener listener)	The bot unsubscribes to a RealTimeEventListener

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

authSession

protected final AuthSession authSession

bdkConfig

protected final com.symphony.bdk.core.config.model.BdkConfig bdkConfig

botInfo

protected final UserV2 botInfo

started

protected final AtomicBoolean started

datafeedApi

protected DatafeedApi datafeedApi

Constructor Details

DatafeedLoopV1

public DatafeedLoopV1(DatafeedApi datafeedApi,
 AuthSession authSession,
 com.symphony.bdk.core.config.model.BdkConfig config,
 UserV2 botInfo)

DatafeedLoopV1

public DatafeedLoopV1(DatafeedApi datafeedApi,
 AuthSession authSession,
 com.symphony.bdk.core.config.model.BdkConfig config,
 UserV2 botInfo,
 DatafeedIdRepository repository)

Method Details

runLoop

protected void runLoop()
                throws Throwable

Throws:

Throwable

retrieveDatafeed

protected Optional<String> retrieveDatafeed()

subscribe

public void subscribe(RealTimeEventListener listener)

The bot subscribes to a RealTimeEventListener

Specified by:

subscribe in interface DatafeedLoop

Parameters:

listener - a Datafeed event listener to be subscribed

unsubscribe

public void unsubscribe(RealTimeEventListener listener)

The bot unsubscribes to a RealTimeEventListener

Specified by:

unsubscribe in interface DatafeedLoop

Parameters:

listener - a Datafeed event listener to be unsubscribed

start

public void start()
           throws AuthUnauthorizedException,
com.symphony.bdk.http.api.ApiException

Start the datafeed events service

Specified by:

start in interface DatafeedLoop

Throws:

AuthUnauthorizedException

com.symphony.bdk.http.api.ApiException

stop

public void stop()

Stop the datafeed events service. The datafeed service will be stopped after a small delay to finish the last read datafeed call.

Specified by:

stop in interface DatafeedLoop

handleV4EventList

protected void handleV4EventList(@Nullable
 List<V4Event> events)
                          throws RequeueEventException

Handle a received listener by using the subscribed RealTimeEventListener.

Parameters:

events - List of Datafeed events to be handled

Throws:

RequeueEventException - Raised if a listener fails and the developer wants to explicitly not update the ack id.

refresh

protected void refresh()
                throws AuthUnauthorizedException

Throws:

AuthUnauthorizedException

lastPullTimestamp

public long lastPullTimestamp()

The timestamp of the last successful pulling

Specified by:

lastPullTimestamp in interface DatafeedLoop

Returns:

timestamp value in long