Package com.couchbase.lite
Class MultipeerReplicator
java.lang.Object
com.couchbase.lite.MultipeerReplicator
The MultipeerReplicator replicates database collections between devices using
the Multipeer Connectivity framework. It provides peer discovery, connection management,
and data replication.
-
Constructor Summary
ConstructorsConstructorDescriptionInitializes the MultipeerReplicator with the given configuration. -
Method Summary
Modifier and TypeMethodDescriptionAdds a listener to receive updates on the peer discovery status.addPeerDiscoveryStatusListener
(Executor executor, PeerDiscoveryStatus.Listener listener) Adds a listener to receive updates on the peer discovery status.Adds a listener to receive updates on the document replication status for each connected peer.addPeerDocumentReplicationListener
(Executor executor, PeerDocumentReplication.Listener listener) Adds a listener to receive updates on the document replication status for each connected peer.Adds a listener to receive updates on the replicator status for each connected peer.addPeerReplicatorStatusListener
(Executor executor, PeerReplicatorStatus.Listener listener) Adds a listener to receive updates on the replicator status for each connected peer.Adds a listener to receive updates on the multipeer replicator status.addStatusListener
(Executor executor, MultipeerReplicatorStatus.Listener listener) Adds a listener to receive updates on the multipeer replicator status.The configuration.Returns the set of necessary permissions required by the application.getPeerInfo
(PeerInfo.PeerId peerId) void
start()
Starts peer discovery and initiates replication with connected peers.void
stop()
Stops peer discovery and all replicators.
-
Constructor Details
-
MultipeerReplicator
public MultipeerReplicator(@NonNull MultipeerReplicatorConfiguration config) throws CouchbaseLiteException Initializes the MultipeerReplicator with the given configuration.- Parameters:
config
- The configuration for the replicator.- Throws:
CouchbaseLiteException
- on error creating the replicator.
-
-
Method Details
-
getConfig
The configuration.- Returns:
- The configuration.
-
getPeerId
-
getNeighborPeers
-
start
public void start()Starts peer discovery and initiates replication with connected peers. -
stop
public void stop()Stops peer discovery and all replicators. -
getPeerInfo
-
getNecessaryPermissions
Returns the set of necessary permissions required by the application.- Returns:
- A set of necessary permissions (Strings).
-
addStatusListener
@NonNull public ListenerToken addStatusListener(@NonNull MultipeerReplicatorStatus.Listener listener) Adds a listener to receive updates on the multipeer replicator status.- Parameters:
listener
- The listener to be added.- Returns:
- A ListenerToken that can be used to remove the listener.
-
addStatusListener
@NonNull public ListenerToken addStatusListener(@Nullable Executor executor, @NonNull MultipeerReplicatorStatus.Listener listener) Adds a listener to receive updates on the multipeer replicator status.- Parameters:
executor
- The executor to run the listener on.listener
- The listener to be added.- Returns:
- A ListenerToken that can be used to remove the listener.
-
addPeerDiscoveryStatusListener
@NonNull public ListenerToken addPeerDiscoveryStatusListener(@NonNull PeerDiscoveryStatus.Listener listener) Adds a listener to receive updates on the peer discovery status.- Parameters:
listener
- The listener to be added.- Returns:
- A ListenerToken that can be used to remove the listener.
-
addPeerDiscoveryStatusListener
@NonNull public ListenerToken addPeerDiscoveryStatusListener(@Nullable Executor executor, @NonNull PeerDiscoveryStatus.Listener listener) Adds a listener to receive updates on the peer discovery status.- Parameters:
executor
- The executor to run the listener on.listener
- The listener to be added.- Returns:
- A ListenerToken that can be used to remove the listener.
-
addPeerReplicatorStatusListener
@NonNull public ListenerToken addPeerReplicatorStatusListener(@NonNull PeerReplicatorStatus.Listener listener) Adds a listener to receive updates on the replicator status for each connected peer.- Parameters:
listener
- The listener to be added.- Returns:
- A ListenerToken that can be used to remove the listener.
-
addPeerReplicatorStatusListener
@NonNull public ListenerToken addPeerReplicatorStatusListener(@Nullable Executor executor, @NonNull PeerReplicatorStatus.Listener listener) Adds a listener to receive updates on the replicator status for each connected peer.- Parameters:
executor
- The executor to run the listener on.listener
- The listener to be added.- Returns:
- A ListenerToken that can be used to remove the listener.
-
addPeerDocumentReplicationListener
@NonNull public ListenerToken addPeerDocumentReplicationListener(@NonNull PeerDocumentReplication.Listener listener) Adds a listener to receive updates on the document replication status for each connected peer.- Parameters:
listener
- The listener to be added.- Returns:
- A ListenerToken that can be used to remove the listener.
-
addPeerDocumentReplicationListener
@NonNull public ListenerToken addPeerDocumentReplicationListener(@Nullable Executor executor, @NonNull PeerDocumentReplication.Listener listener) Adds a listener to receive updates on the document replication status for each connected peer.- Parameters:
executor
- The executor to run the listener on.listener
- The listener to be added.- Returns:
- A ListenerToken that can be used to remove the listener.
-