1 package org
.asamk
.signal
.manager
.helper
;
3 import org
.asamk
.signal
.manager
.Manager
;
4 import org
.asamk
.signal
.manager
.actions
.HandleAction
;
5 import org
.asamk
.signal
.manager
.api
.ReceiveConfig
;
6 import org
.asamk
.signal
.manager
.api
.UntrustedIdentityException
;
7 import org
.asamk
.signal
.manager
.internal
.SignalDependencies
;
8 import org
.asamk
.signal
.manager
.storage
.SignalAccount
;
9 import org
.asamk
.signal
.manager
.storage
.messageCache
.CachedMessage
;
10 import org
.asamk
.signal
.manager
.storage
.recipients
.RecipientAddress
;
11 import org
.slf4j
.Logger
;
12 import org
.slf4j
.LoggerFactory
;
13 import org
.whispersystems
.signalservice
.api
.SignalWebSocket
;
14 import org
.whispersystems
.signalservice
.api
.messages
.SignalServiceEnvelope
;
15 import org
.whispersystems
.signalservice
.api
.push
.ServiceId
;
16 import org
.whispersystems
.signalservice
.api
.push
.ServiceId
.ACI
;
17 import org
.whispersystems
.signalservice
.api
.websocket
.WebSocketConnectionState
;
18 import org
.whispersystems
.signalservice
.api
.websocket
.WebSocketUnavailableException
;
20 import java
.io
.IOException
;
21 import java
.time
.Duration
;
22 import java
.util
.Collection
;
23 import java
.util
.HashMap
;
24 import java
.util
.HashSet
;
25 import java
.util
.List
;
28 import java
.util
.concurrent
.TimeoutException
;
30 import io
.reactivex
.rxjava3
.core
.Observable
;
31 import io
.reactivex
.rxjava3
.schedulers
.Schedulers
;
33 public class ReceiveHelper
{
35 private static final Logger logger
= LoggerFactory
.getLogger(ReceiveHelper
.class);
36 private static final int MAX_BACKOFF_COUNTER
= 9;
38 private final SignalAccount account
;
39 private final SignalDependencies dependencies
;
40 private final Context context
;
42 private ReceiveConfig receiveConfig
= new ReceiveConfig(false, false, false);
43 private boolean needsToRetryFailedMessages
= false;
44 private boolean hasCaughtUpWithOldMessages
= false;
45 private boolean isWaitingForMessage
= false;
46 private boolean shouldStop
= false;
47 private Callable authenticationFailureListener
;
48 private Callable caughtUpWithOldMessagesListener
;
50 public ReceiveHelper(final Context context
) {
51 this.account
= context
.getAccount();
52 this.dependencies
= context
.getDependencies();
53 this.context
= context
;
56 public void setReceiveConfig(final ReceiveConfig receiveConfig
) {
57 this.receiveConfig
= receiveConfig
;
58 dependencies
.setAllowStories(!receiveConfig
.ignoreStories());
61 public void setNeedsToRetryFailedMessages(final boolean needsToRetryFailedMessages
) {
62 this.needsToRetryFailedMessages
= needsToRetryFailedMessages
;
65 public void setAuthenticationFailureListener(final Callable authenticationFailureListener
) {
66 this.authenticationFailureListener
= authenticationFailureListener
;
69 public void setCaughtUpWithOldMessagesListener(final Callable caughtUpWithOldMessagesListener
) {
70 this.caughtUpWithOldMessagesListener
= caughtUpWithOldMessagesListener
;
73 public boolean requestStopReceiveMessages() {
74 this.shouldStop
= true;
75 return isWaitingForMessage
;
78 public void receiveMessagesContinuously(Manager
.ReceiveMessageHandler handler
) {
81 receiveMessages(Duration
.ofMinutes(1), false, null, handler
);
83 } catch (IOException e
) {
84 logger
.warn("Receiving messages failed, retrying", e
);
89 public void receiveMessages(
90 Duration timeout
, boolean returnOnTimeout
, Integer maxMessages
, Manager
.ReceiveMessageHandler handler
91 ) throws IOException
{
92 needsToRetryFailedMessages
= true;
93 hasCaughtUpWithOldMessages
= false;
95 // Use a Map here because java Set doesn't have a get method ...
96 Map
<HandleAction
, HandleAction
> queuedActions
= new HashMap
<>();
98 final var signalWebSocket
= dependencies
.getSignalWebSocket();
99 final var webSocketStateDisposable
= Observable
.merge(signalWebSocket
.getUnidentifiedWebSocketState(),
100 signalWebSocket
.getWebSocketState())
101 .subscribeOn(Schedulers
.computation())
102 .observeOn(Schedulers
.computation())
103 .distinctUntilChanged()
104 .subscribe(this::onWebSocketStateChange
);
105 signalWebSocket
.connect();
108 receiveMessagesInternal(signalWebSocket
, timeout
, returnOnTimeout
, maxMessages
, handler
, queuedActions
);
110 hasCaughtUpWithOldMessages
= false;
111 handleQueuedActions(queuedActions
.keySet());
112 queuedActions
.clear();
113 signalWebSocket
.disconnect();
114 webSocketStateDisposable
.dispose();
119 private void receiveMessagesInternal(
120 final SignalWebSocket signalWebSocket
,
122 boolean returnOnTimeout
,
124 Manager
.ReceiveMessageHandler handler
,
125 final Map
<HandleAction
, HandleAction
> queuedActions
126 ) throws IOException
{
127 int remainingMessages
= maxMessages
== null ?
-1 : maxMessages
;
128 var backOffCounter
= 0;
129 isWaitingForMessage
= false;
131 while (!shouldStop
&& remainingMessages
!= 0) {
132 if (needsToRetryFailedMessages
) {
133 retryFailedReceivedMessages(handler
);
134 needsToRetryFailedMessages
= false;
136 SignalServiceEnvelope envelope
;
137 final CachedMessage
[] cachedMessage
= {null};
138 final var nowMillis
= System
.currentTimeMillis();
139 if (nowMillis
- account
.getLastReceiveTimestamp() > 60000) {
140 account
.setLastReceiveTimestamp(nowMillis
);
142 logger
.debug("Checking for new message from server");
144 isWaitingForMessage
= true;
145 var queueNotEmpty
= signalWebSocket
.readMessageBatch(timeout
.toMillis(), 1, batch
-> {
146 logger
.debug("Retrieved {} envelopes!", batch
.size());
147 isWaitingForMessage
= false;
148 for (final var it
: batch
) {
149 SignalServiceEnvelope envelope1
= new SignalServiceEnvelope(it
.getEnvelope(),
150 it
.getServerDeliveredTimestamp());
151 final var recipientId
= envelope1
.getSourceServiceId()
152 .map(ServiceId
::parseOrNull
)
153 .map(s
-> account
.getRecipientResolver().resolveRecipient(s
))
155 logger
.trace("Storing new message from {}", recipientId
);
156 // store message on disk, before acknowledging receipt to the server
157 cachedMessage
[0] = account
.getMessageCache().cacheMessage(envelope1
, recipientId
);
159 signalWebSocket
.sendAck(it
);
160 } catch (IOException e
) {
161 logger
.warn("Failed to ack envelope to server after storing it: {}", e
.getMessage());
165 isWaitingForMessage
= false;
169 if (remainingMessages
> 0) {
170 remainingMessages
-= 1;
172 envelope
= cachedMessage
[0].loadEnvelope();
173 logger
.debug("New message received from server");
175 logger
.debug("Received indicator that server queue is empty");
176 handleQueuedActions(queuedActions
.keySet());
177 queuedActions
.clear();
179 hasCaughtUpWithOldMessages
= true;
180 caughtUpWithOldMessagesListener
.call();
182 // Continue to wait another timeout for new messages
185 } catch (AssertionError e
) {
186 if (e
.getCause() instanceof InterruptedException
) {
191 } catch (IOException e
) {
192 logger
.debug("Pipe unexpectedly unavailable: {}", e
.getMessage());
193 if (e
instanceof WebSocketUnavailableException
|| "Connection closed!".equals(e
.getMessage())) {
194 final var sleepMilliseconds
= 100 * (long) Math
.pow(2, backOffCounter
);
195 backOffCounter
= Math
.min(backOffCounter
+ 1, MAX_BACKOFF_COUNTER
);
196 logger
.warn("Connection closed unexpectedly, reconnecting in {} ms", sleepMilliseconds
);
198 Thread
.sleep(sleepMilliseconds
);
199 } catch (InterruptedException interruptedException
) {
202 hasCaughtUpWithOldMessages
= false;
203 signalWebSocket
.connect();
207 } catch (TimeoutException e
) {
209 if (returnOnTimeout
) return;
211 } catch (Exception e
) {
212 logger
.error("Unknown error when receiving messages", e
);
217 final var result
= context
.getIncomingMessageHandler().handleEnvelope(envelope
, receiveConfig
, handler
);
218 for (final var h
: result
.first()) {
219 final var existingAction
= queuedActions
.get(h
);
220 if (existingAction
== null) {
221 queuedActions
.put(h
, h
);
223 existingAction
.mergeOther(h
);
226 final var exception
= result
.second();
228 if (hasCaughtUpWithOldMessages
) {
229 handleQueuedActions(queuedActions
.keySet());
230 queuedActions
.clear();
232 if (cachedMessage
[0] != null) {
233 if (exception
instanceof UntrustedIdentityException
) {
234 logger
.debug("Keeping message with untrusted identity in message cache");
235 final var address
= ((UntrustedIdentityException
) exception
).getSender();
236 if (envelope
.getSourceServiceId().isEmpty() && address
.uuid().isPresent()) {
237 final var recipientId
= account
.getRecipientResolver()
238 .resolveRecipient(ACI
.from(address
.uuid().get()));
240 cachedMessage
[0] = account
.getMessageCache()
241 .replaceSender(cachedMessage
[0], recipientId
);
242 } catch (IOException ioException
) {
243 logger
.warn("Failed to move cached message to recipient folder: {}",
244 ioException
.getMessage(),
249 cachedMessage
[0].delete();
252 } catch (Exception e
) {
253 logger
.error("Unknown error when handling messages", e
);
258 private void retryFailedReceivedMessages(Manager
.ReceiveMessageHandler handler
) {
259 Set
<HandleAction
> queuedActions
= new HashSet
<>();
260 for (var cachedMessage
: account
.getMessageCache().getCachedMessages()) {
261 var actions
= retryFailedReceivedMessage(handler
, cachedMessage
);
262 if (actions
!= null) {
263 queuedActions
.addAll(actions
);
266 handleQueuedActions(queuedActions
);
269 private List
<HandleAction
> retryFailedReceivedMessage(
270 final Manager
.ReceiveMessageHandler handler
, final CachedMessage cachedMessage
272 var envelope
= cachedMessage
.loadEnvelope();
273 if (envelope
== null) {
274 cachedMessage
.delete();
278 final var result
= context
.getIncomingMessageHandler().handleRetryEnvelope(envelope
, receiveConfig
, handler
);
279 final var actions
= result
.first();
280 final var exception
= result
.second();
282 if (exception
instanceof UntrustedIdentityException
) {
283 if (System
.currentTimeMillis() - envelope
.getServerDeliveredTimestamp() > 1000L * 60 * 60 * 24 * 30) {
284 // Envelope is more than a month old, cleaning up.
285 cachedMessage
.delete();
288 if (envelope
.getSourceServiceId().isEmpty()) {
289 final var identifier
= ((UntrustedIdentityException
) exception
).getSender();
290 final var recipientId
= account
.getRecipientResolver()
291 .resolveRecipient(new RecipientAddress(identifier
));
293 account
.getMessageCache().replaceSender(cachedMessage
, recipientId
);
294 } catch (IOException ioException
) {
295 logger
.warn("Failed to move cached message to recipient folder: {}",
296 ioException
.getMessage(),
303 // If successful and for all other errors that are not recoverable, delete the cached message
304 cachedMessage
.delete();
308 private void handleQueuedActions(final Collection
<HandleAction
> queuedActions
) {
309 logger
.debug("Handling message actions");
310 for (var action
: queuedActions
) {
311 logger
.debug("Executing action {}", action
.getClass().getSimpleName());
313 action
.execute(context
);
314 } catch (Throwable e
) {
315 logger
.warn("Message action failed.", e
);
320 private void onWebSocketStateChange(final WebSocketConnectionState s
) {
321 if (s
.equals(WebSocketConnectionState
.AUTHENTICATION_FAILED
)) {
322 account
.setRegistered(false);
323 authenticationFailureListener
.call();
327 public interface Callable
{