org.whispersystems.signalservice.api

Class SignalServiceMessageSender

java.lang.Object

org.whispersystems.signalservice.api.SignalServiceMessageSender

public class SignalServiceMessageSender
extends java.lang.Object

The main interface for sending Signal Service messages.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SignalServiceMessageSender.EventListener

Constructor Summary

Constructors

Constructor and Description
SignalServiceMessageSender(java.lang.String url, TrustStore trustStore, java.lang.String user, java.lang.String password, org.whispersystems.libsignal.state.SignalProtocolStore store, java.lang.String userAgent, org.whispersystems.libsignal.util.guava.Optional<SignalServiceMessageSender.EventListener> eventListener) Construct a SignalServiceMessageSender.

Method Summary

Modifier and Type	Method and Description
void	sendDeliveryReceipt(SignalServiceAddress recipient, long messageId) Send a delivery receipt for a received message.
void	sendMessage(java.util.List<SignalServiceAddress> recipients, SignalServiceDataMessage message) Send a message to a group.
void	sendMessage(SignalServiceAddress recipient, SignalServiceDataMessage message) Send a message to a single recipient.
void	sendMessage(SignalServiceSyncMessage message)

Methods inherited from class java.lang.Object

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

Constructor Detail

SignalServiceMessageSender

public SignalServiceMessageSender(java.lang.String url,
                                  TrustStore trustStore,
                                  java.lang.String user,
                                  java.lang.String password,
                                  org.whispersystems.libsignal.state.SignalProtocolStore store,
                                  java.lang.String userAgent,
                                  org.whispersystems.libsignal.util.guava.Optional<SignalServiceMessageSender.EventListener> eventListener)

Construct a SignalServiceMessageSender.

Parameters:

url - The URL of the Signal Service.

trustStore - The trust store containing the Signal Service's signing TLS certificate.

user - The Signal Service username (eg phone number).

password - The Signal Service user password.

store - The SignalProtocolStore.

eventListener - An optional event listener, which fires whenever sessions are setup or torn down for a recipient.

Method Detail

sendDeliveryReceipt

public void sendDeliveryReceipt(SignalServiceAddress recipient,
                                long messageId)
                         throws java.io.IOException

Send a delivery receipt for a received message. It is not necessary to call this when receiving messages through SignalServiceMessagePipe.

Parameters:

recipient - The sender of the received message you're acknowledging.

messageId - The message id of the received message you're acknowledging.

Throws:

java.io.IOException

sendMessage

public void sendMessage(SignalServiceAddress recipient,
                        SignalServiceDataMessage message)
                 throws UntrustedIdentityException,
                        java.io.IOException

Send a message to a single recipient.

Parameters:

recipient - The message's destination.

message - The message.

Throws:

UntrustedIdentityException

java.io.IOException

sendMessage

public void sendMessage(java.util.List<SignalServiceAddress> recipients,
                        SignalServiceDataMessage message)
                 throws java.io.IOException,
                        EncapsulatedExceptions

Send a message to a group.

Parameters:

recipients - The group members.

message - The group message.

Throws:

java.io.IOException

EncapsulatedExceptions

sendMessage

public void sendMessage(SignalServiceSyncMessage message)
                 throws java.io.IOException,
                        UntrustedIdentityException

Throws:

java.io.IOException

UntrustedIdentityException