processCurrentlyQueuedCommands is false, then any current commands in the queue will be dequeued - guaranteed commands will be persisted; if and when {@link #startSending()} is called, they will be re-queued (if the VM dies in the meantime, only the guaranteedcommands will be preserved upon the restart). Any commands currently being executed will be interrupted and, if they do not require guaranteed delivery, will be lost. If processCurrentlyQueuedCommands is true, then all commands in the queue will be processed - once the queue is empty and all commands sent, this method will return. If this client was not already {@link #isSending() stopped}, this method returns true to indicate the client's mode has changed from started to stopped.
If this client is already {@link #isSending() stopped}, this method does nothing and returns false to indicate the mode hasn't changed - it is still in the stopped mode.
This method will not return until the the executor thread pool has completely shutdown.
@param process_currently_queued_commands iftrue, this will block and wait for all current commandsin the queue to be sent before returning
@return true if this client was sending prior to this method being called (and hence this clientchanged modes); false if this client was not already sending and thus this method ended up being a no-op
| |
| |