com.symphony.bdk.core.service.signal

Interface OboSignalService

All Known Implementing Classes:

SignalService

@API(status=STABLE)
public interface OboSignalService

Service interface exposing OBO-enabled endpoints to manage signals information.

Method Summary

Modifier and Type	Method and Description
Signal	createSignal(BaseSignal signal) Create a new signal.
void	deleteSignal(java.lang.String id) Delete an existing signal.
Signal	getSignal(java.lang.String id) Gets details about the specified signal.
java.util.stream.Stream<Signal>	listAllSignals() Lists paginated stream of signals on behalf of the user with the default chunkSize and totalSize equal 100.
java.util.stream.Stream<Signal>	listAllSignals(StreamPaginationAttribute pagination) Lists paginated stream of signals on behalf of the user.
java.util.stream.Stream<ChannelSubscriber>	listAllSubscribers(java.lang.String id) Get the paginated stream of subscribers for a specified signal with the default chunkSize and totalSize equal to 100.
java.util.stream.Stream<ChannelSubscriber>	listAllSubscribers(java.lang.String id, StreamPaginationAttribute pagination) Get the paginated stream of subscribers for a specified signal.
java.util.List<Signal>	listSignals() Lists signals on behalf of the user with default limit equal 50.
java.util.List<Signal>	listSignals(PaginationAttribute pagination) Lists signals on behalf of the user.
java.util.List<ChannelSubscriber>	listSubscribers(java.lang.String id) Get the subscribers for a specified signal with default limit equal to 100.
java.util.List<ChannelSubscriber>	listSubscribers(java.lang.String id, PaginationAttribute pagination) Get the subscribers for a specified signal.
ChannelSubscriptionResponse	subscribeUsersToSignal(java.lang.String id, java.lang.Boolean pushed, java.util.List<java.lang.Long> userIds) Subscribe a list of users to a signal.
ChannelSubscriptionResponse	unsubscribeUsersFromSignal(java.lang.String id, java.util.List<java.lang.Long> userIds) Unsubscribe a list of users from a signal.
Signal	updateSignal(java.lang.String id, BaseSignal signal) Update an existing signal.

Method Detail

listSignals

java.util.List<Signal> listSignals(@Nonnull
                                   PaginationAttribute pagination)

Lists signals on behalf of the user. SignalService.listSignals(PaginationAttribute)

Parameters:

pagination - The skip and limit for pagination.

Returns:

List of signals that the user has created and public signals to which they have subscribed.

See Also:

List Signals

listSignals

java.util.List<Signal> listSignals()

Lists signals on behalf of the user with default limit equal 50. SignalService.listSignals()

Returns:

List of signals that the user has created and public signals to which they have subscribed.

See Also:

List Signals

listAllSignals

@API(status=EXPERIMENTAL)
java.util.stream.Stream<Signal> listAllSignals(@Nonnull
                                                                         StreamPaginationAttribute pagination)

Lists paginated stream of signals on behalf of the user. SignalService.listAllSignals(StreamPaginationAttribute)

Parameters:

pagination - The chunkSize and totalSize for pagination.

Returns:

a Stream containing the signals.

See Also:

List Signals

listAllSignals

@API(status=EXPERIMENTAL)
java.util.stream.Stream<Signal> listAllSignals()

Lists paginated stream of signals on behalf of the user with the default chunkSize and totalSize equal 100. SignalService.listAllSignals()

Returns:

a Stream containing the signals.

See Also:

List Signals

getSignal

Signal getSignal(@Nonnull
                 java.lang.String id)

Gets details about the specified signal. SignalService.getSignal(String)

Parameters:

id - The id of the signal.

Returns:

Details of the specified signal.

See Also:

Get Signal

createSignal

Signal createSignal(@Nonnull
                    BaseSignal signal)

Create a new signal. SignalService.createSignal(BaseSignal)

Parameters:

signal - A signal object to be created.

Returns:

A new created signal object.

See Also:

Create Signal

updateSignal

Signal updateSignal(@Nonnull
                    java.lang.String id,
                    @Nonnull
                    BaseSignal signal)

Update an existing signal. SignalService.updateSignal(String, BaseSignal)

Parameters:

id - The id of the signal to be updated.

signal - The signal object to be updated.

Returns:

The updated signal.

See Also:

Update Signal

deleteSignal

void deleteSignal(@Nonnull
                  java.lang.String id)

Delete an existing signal. SignalService.deleteSignal(String)

Parameters:

id - The id of the signal to be deleted.

See Also:

Delete Signal

subscribeUsersToSignal

ChannelSubscriptionResponse subscribeUsersToSignal(@Nonnull
                                                   java.lang.String id,
                                                   @Nullable
                                                   java.lang.Boolean pushed,
                                                   @Nullable
                                                   java.util.List<java.lang.Long> userIds)

Subscribe a list of users to a signal. SignalService.subscribeUsersToSignal(String, Boolean, List)

Parameters:

id - The id of the signal to be subscribed.

pushed - Prevents the user from unsubscribing from the Signal (only for bulk subscriptions). Requires the canManageSignalSubscription entitlement.

userIds - List of user ids to subscribe to the signal

Returns:

The subscription information.

See Also:

Subscribe Signal

unsubscribeUsersFromSignal

ChannelSubscriptionResponse unsubscribeUsersFromSignal(@Nonnull
                                                       java.lang.String id,
                                                       @Nullable
                                                       java.util.List<java.lang.Long> userIds)

Unsubscribe a list of users from a signal. SignalService.unsubscribeUsersFromSignal(String, List)

Parameters:

id - The id of the signal to be unsubscribed.

userIds - The list of user ids to unsubscribe from the signal.

Returns:

The unsubscription information.

See Also:

Unsubscribe Signal

listSubscribers

java.util.List<ChannelSubscriber> listSubscribers(@Nonnull
                                                  java.lang.String id,
                                                  @Nonnull
                                                  PaginationAttribute pagination)

Get the subscribers for a specified signal. SignalService.listSubscribers(String, PaginationAttribute)

Parameters:

id - The id of the specified signal.

pagination - The skip and limit for pagination.

Returns:

List of subscribers of the signal.

See Also:

Subscribers

listSubscribers

java.util.List<ChannelSubscriber> listSubscribers(@Nonnull
                                                  java.lang.String id)

Get the subscribers for a specified signal with default limit equal to 100. SignalService.listSubscribers(String)

Parameters:

id - The id of the specified signal.

Returns:

List of subscribers of the signal.

See Also:

Subscribers

listAllSubscribers

@API(status=EXPERIMENTAL)
java.util.stream.Stream<ChannelSubscriber> listAllSubscribers(@Nonnull
                                                                                        java.lang.String id,
                                                                                        @Nonnull
                                                                                        StreamPaginationAttribute pagination)

Get the paginated stream of subscribers for a specified signal. SignalService.listAllSubscribers(String, StreamPaginationAttribute)

Parameters:

id - The id of the specified signal.

pagination - The chunkSize and totalSize for pagination.

Returns:

a Stream containing the subscribers.

See Also:

Subscribers

listAllSubscribers

@API(status=EXPERIMENTAL)
java.util.stream.Stream<ChannelSubscriber> listAllSubscribers(@Nonnull
                                                                                        java.lang.String id)

Get the paginated stream of subscribers for a specified signal with the default chunkSize and totalSize equal to 100. SignalService.listAllSubscribers(String)

Parameters:

id - The id of the specified signal.

Returns:

a Stream containing the subscribers.

See Also:

Subscribers