Package io.atomix.cluster.messaging.impl

Class DefaultClusterCommunicationService

java.lang.Object

io.atomix.cluster.messaging.impl.DefaultClusterCommunicationService

All Implemented Interfaces:

ClusterCommunicationService, ManagedClusterCommunicationService, Managed<ClusterCommunicationService>

public class DefaultClusterCommunicationService
extends Object
implements ManagedClusterCommunicationService

Cluster communication service implementation.

Field Summary

Fields

Modifier and Type	Field	Description
protected final ClusterMembershipService	membershipService
protected final MessagingService	messagingService
protected final UnicastService	unicastService

Constructor Summary

Constructors

Constructor	Description
DefaultClusterCommunicationService(ClusterMembershipService membershipService, MessagingService messagingService, UnicastService unicastService)

Method Summary

Modifier and Type	Method	Description
<M> void	broadcast(String subject, M message, Function<M,byte[]> encoder, boolean reliable)	Broadcasts a message to all members.
boolean	isRunning()
<M> void	multicast(String subject, M message, Function<M,byte[]> encoder, Set<MemberId> nodes, boolean reliable)	Multicasts a message to a set of members.
<M, R> CompletableFuture<R>	send(String subject, M message, Function<M,byte[]> encoder, Function<byte[],R> decoder, MemberId toMemberId, Duration timeout)	Sends a message and expects a reply.
CompletableFuture<ClusterCommunicationService>	start()
CompletableFuture<Void>	stop()
<M> CompletableFuture<Void>	subscribe(String subject, Function<byte[],M> decoder, BiConsumer<MemberId,M> handler, Executor executor)	Adds a new subscriber for the specified message subject.
<M> CompletableFuture<Void>	subscribe(String subject, Function<byte[],M> decoder, Consumer<M> handler, Executor executor)	Adds a new subscriber for the specified message subject.
<M, R> CompletableFuture<Void>	subscribe(String subject, Function<byte[],M> decoder, Function<M,CompletableFuture<R>> handler, Function<R,byte[]> encoder)	Adds a new subscriber for the specified message subject.
<M, R> CompletableFuture<Void>	subscribe(String subject, Function<byte[],M> decoder, Function<M,R> handler, Function<R,byte[]> encoder, Executor executor)	Adds a new subscriber for the specified message subject.
<M> void	unicast(String subject, M message, Function<M,byte[]> encoder, MemberId memberId, boolean reliable)	Sends a message to a member.
void	unsubscribe(String subject)	Removes a subscriber for the specified message subject.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.atomix.cluster.messaging.ClusterCommunicationService

broadcast, broadcast, broadcast, multicast, send, subscribe, subscribe, subscribe, subscribe, unicast

Field Details

membershipService

protected final ClusterMembershipService membershipService

messagingService

protected final MessagingService messagingService

unicastService

protected final UnicastService unicastService

Constructor Details

DefaultClusterCommunicationService

public DefaultClusterCommunicationService(ClusterMembershipService membershipService,
 MessagingService messagingService,
 UnicastService unicastService)

Method Details

broadcast

public <M> void broadcast(String subject,
 M message,
 Function<M,byte[]> encoder,
 boolean reliable)

Description copied from interface: ClusterCommunicationService

Broadcasts a message to all members.

Specified by:

broadcast in interface ClusterCommunicationService

Type Parameters:

M - message type

Parameters:

subject - message subject

message - message to send

encoder - function for encoding message to byte[]

reliable - whether to perform a reliable (TCP) unicast

multicast

public <M> void multicast(String subject,
 M message,
 Function<M,byte[]> encoder,
 Set<MemberId> nodes,
 boolean reliable)

Description copied from interface: ClusterCommunicationService

Multicasts a message to a set of members.

Specified by:

multicast in interface ClusterCommunicationService

Type Parameters:

M - message type

Parameters:

subject - message subject

message - message to send

encoder - function for encoding message to byte[]

nodes - recipient node identifiers

reliable - whether to perform a reliable (TCP) unicast

unicast

public <M> void unicast(String subject,
 M message,
 Function<M,byte[]> encoder,
 MemberId memberId,
 boolean reliable)

Description copied from interface: ClusterCommunicationService

Sends a message to a member.

Specified by:

unicast in interface ClusterCommunicationService

Type Parameters:

M - message type

Parameters:

subject - message subject

message - message to send

encoder - function for encoding message to byte[]

memberId - recipient node identifier

reliable - whether to perform a reliable (TCP) unicast

send

public <M,
R> CompletableFuture<R> send(String subject,
 M message,
 Function<M,byte[]> encoder,
 Function<byte[],R> decoder,
 MemberId toMemberId,
 Duration timeout)

Description copied from interface: ClusterCommunicationService

Sends a message and expects a reply.

Specified by:

send in interface ClusterCommunicationService

Type Parameters:

M - request type

R - reply type

Parameters:

subject - message subject

message - message to send

encoder - function for encoding request to byte[]

decoder - function for decoding response from byte[]

toMemberId - recipient node identifier

timeout - response timeout

Returns:

reply future

subscribe

public <M,
R> CompletableFuture<Void> subscribe(String subject,
 Function<byte[],M> decoder,
 Function<M,R> handler,
 Function<R,byte[]> encoder,
 Executor executor)

Description copied from interface: ClusterCommunicationService

Adds a new subscriber for the specified message subject.

Specified by:

subscribe in interface ClusterCommunicationService

Type Parameters:

M - incoming message type

R - reply message type

Parameters:

subject - message subject

decoder - decoder for resurrecting incoming message

handler - handler function that processes the incoming message and produces a reply

encoder - encoder for serializing reply

executor - executor to run this handler on

Returns:

future to be completed once the subscription has been propagated

subscribe

public <M,
R> CompletableFuture<Void> subscribe(String subject,
 Function<byte[],M> decoder,
 Function<M,CompletableFuture<R>> handler,
 Function<R,byte[]> encoder)

Description copied from interface: ClusterCommunicationService

Adds a new subscriber for the specified message subject.

Specified by:

subscribe in interface ClusterCommunicationService

Type Parameters:

M - incoming message type

R - reply message type

Parameters:

subject - message subject

decoder - decoder for resurrecting incoming message

handler - handler function that processes the incoming message and produces a reply

encoder - encoder for serializing reply

Returns:

future to be completed once the subscription has been propagated

subscribe

public <M> CompletableFuture<Void> subscribe(String subject,
 Function<byte[],M> decoder,
 Consumer<M> handler,
 Executor executor)

Description copied from interface: ClusterCommunicationService

Adds a new subscriber for the specified message subject.

Specified by:

subscribe in interface ClusterCommunicationService

Type Parameters:

M - incoming message type

Parameters:

subject - message subject

decoder - decoder to resurrecting incoming message

handler - handler for handling message

executor - executor to run this handler on

Returns:

future to be completed once the subscription has been propagated

subscribe

public <M> CompletableFuture<Void> subscribe(String subject,
 Function<byte[],M> decoder,
 BiConsumer<MemberId,M> handler,
 Executor executor)

Description copied from interface: ClusterCommunicationService

Adds a new subscriber for the specified message subject.

Specified by:

subscribe in interface ClusterCommunicationService

Type Parameters:

M - incoming message type

Parameters:

subject - message subject

decoder - decoder to resurrecting incoming message

handler - handler for handling message

executor - executor to run this handler on

Returns:

future to be completed once the subscription has been propagated

unsubscribe

public void unsubscribe(String subject)

Description copied from interface: ClusterCommunicationService

Removes a subscriber for the specified message subject.

Specified by:

unsubscribe in interface ClusterCommunicationService

Parameters:

subject - message subject

start

public CompletableFuture<ClusterCommunicationService> start()

Specified by:

start in interface Managed<ClusterCommunicationService>

isRunning

public boolean isRunning()

Specified by:

isRunning in interface Managed<ClusterCommunicationService>

stop

public CompletableFuture<Void> stop()

Specified by:

stop in interface Managed<ClusterCommunicationService>