software.chronicle.datagrid.internal.pubsub

Class MapReference<E>

java.lang.Object

software.chronicle.datagrid.internal.pubsub.MapReference<E>

All Implemented Interfaces:

Supplier<E>, Visitable<E>, Publisher<E>, Reference<E>

public final class MapReference<E>
extends Object
implements Reference<E>

Constructor Summary

Constructors

Constructor and Description
MapReference(@NotNull RequestContext context, @NotNull Asset asset, MapView<String,E> underlying)
MapReference(String name, Class<E> type, @NotNull Asset asset, MapView<String,E> mapView)

Method Summary

Modifier and Type	Method and Description
E	get() Returns the current value for this Reference.
Class<E>	getType() Returns the type of the underlying reference.
void	registerSubscriber(boolean bootstrap, int throttlePeriodMs, @NotNull Subscriber<? super E> subscriber, boolean endSubscriptionAfterBootstrap) Registers the provided subscriber as a subscription to this specific topic.
void	remove() Removes the underlying topic/key for this Reference.
long	set(E event) Sets a new value for this Reference.
int	subscriberCount()
@NotNull String	toString()
void	unregisterSubscriber(@NotNull Subscriber<? super E> subscriber) Unregisters the provided subscriber.

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.chronicle.datagrid.pubsub.Reference

getAndRemove, getAndSet, publish

Methods inherited from interface software.chronicle.datagrid.collection.Visitable

applyTo, applyTo, asyncUpdate, asyncUpdate, syncUpdate, syncUpdate

Constructor Detail

MapReference

public MapReference(@NotNull
                    @NotNull RequestContext context,
                    @NotNull
                    @NotNull Asset asset,
                    MapView<String,E> underlying)

MapReference

public MapReference(String name,
                    Class<E> type,
                    @NotNull
                    @NotNull Asset asset,
                    MapView<String,E> mapView)

Method Detail

set

public long set(E event)

Description copied from interface: Reference

Sets a new value for this Reference.

Specified by:

set in interface Visitable<E>

Specified by:

set in interface Reference<E>

Parameters:

event - replace value

Returns:

the index if this is a reference to a Queue topic or else 0.

get

@Nullable
public E get()

Description copied from interface: Reference

Returns the current value for this Reference.

Specified by:

get in interface Supplier<E>

Specified by:

get in interface Visitable<E>

Specified by:

get in interface Reference<E>

Returns:

the current value.

remove

public void remove()

Description copied from interface: Reference

Removes the underlying topic/key for this Reference. Remove the topic/key

Specified by:

remove in interface Reference<E>

registerSubscriber

public void registerSubscriber(boolean bootstrap,
                               int throttlePeriodMs,
                               @NotNull
                               @NotNull Subscriber<? super E> subscriber,
                               boolean endSubscriptionAfterBootstrap)

Description copied from interface: Publisher

Registers the provided subscriber as a subscription to this specific topic.

Any given instance of a subscriber must at most be registered once with a DataGrid instance at any given time.

Specified by:

registerSubscriber in interface Publisher<E>

Parameters:

bootstrap - to bootstrap

throttlePeriodMs - 0 for no throttling, otherwise the period of throttling in milliseconds

subscriber - to register

endSubscriptionAfterBootstrap - if the subscriptions should be ended automatically after bootstrap

unregisterSubscriber

public void unregisterSubscriber(@NotNull
                                 @NotNull Subscriber<? super E> subscriber)

Description copied from interface: Publisher

Unregisters the provided subscriber.

Specified by:

unregisterSubscriber in interface Publisher<E>

Parameters:

subscriber - to remove

subscriberCount

public int subscriberCount()

Specified by:

subscriberCount in interface Publisher<E>

Returns:

the number of subscriptions.

getType

public Class<E> getType()

Description copied from interface: Reference

Returns the type of the underlying reference.

Specified by:

getType in interface Reference<E>

Returns:

the type of the underlying reference.

toString

@NotNull
public @NotNull String toString()

Overrides:

toString in class Object