Package org.infinispan.api.async

Interface AsyncStreamingCache<K>

public interface AsyncStreamingCache<K>

AsyncStreamingCache implements streaming versions of put and get methods

Since:

14.0

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	AsyncStreamingCache.CacheEntryPublisher
static interface	AsyncStreamingCache.CacheEntrySubscriber

Method Summary

Modifier and Type	Method	Description
default AsyncStreamingCache.CacheEntrySubscriber	get(K key)	Retrieves the value of the specified key as a AsyncStreamingCache.CacheEntrySubscriber.
AsyncStreamingCache.CacheEntrySubscriber	get(K key, CacheOptions metadata)	Retrieves the value of the specified key as a AsyncStreamingCache.CacheEntrySubscriber.
default AsyncStreamingCache.CacheEntryPublisher	put(K key)	Initiates a streaming put operation.
AsyncStreamingCache.CacheEntryPublisher	put(K key, CacheWriteOptions metadata)	Initiates a streaming put operation.
default AsyncStreamingCache.CacheEntryPublisher	putIfAbsent(K key)	A conditional form of put which inserts an entry into the cache only if no mapping for the key is already present.
AsyncStreamingCache.CacheEntryPublisher	putIfAbsent(K key, CacheWriteOptions metadata)	A conditional form of put which inserts an entry into the cache only if no mapping for the key is already present.

Method Details

get

default AsyncStreamingCache.CacheEntrySubscriber get(K key)

Retrieves the value of the specified key as a AsyncStreamingCache.CacheEntrySubscriber. It is up to the application to ensure that the data is consumed and closed. The marshaller is ignored, i.e. all data will be read in its raw binary form.

Parameters:

key - key to use

get

AsyncStreamingCache.CacheEntrySubscriber get(K key,
 CacheOptions metadata)

Retrieves the value of the specified key as a AsyncStreamingCache.CacheEntrySubscriber. It is up to the application to ensure that the data is consumed and closed. The marshaller is ignored, i.e. all data will be read in its raw binary form.

Parameters:

key - key to use

metadata -

put

default AsyncStreamingCache.CacheEntryPublisher put(K key)

Initiates a streaming put operation. It is up to the application to write to the returned AsyncStreamingCache.CacheEntryPublisher and close it when there is no more data to write. The marshaller is ignored, i.e. all data will be written in its raw binary form. The returned output stream is not thread-safe.

Parameters:

key - key to use

put

AsyncStreamingCache.CacheEntryPublisher put(K key,
 CacheWriteOptions metadata)

Initiates a streaming put operation. It is up to the application to write to the returned AsyncStreamingCache.CacheEntryPublisher and close it when there is no more data to write. The marshaller is ignored, i.e. all data will be written in its raw binary form. The returned output stream is not thread-safe.

Parameters:

key - key to use

metadata - metadata

putIfAbsent

default AsyncStreamingCache.CacheEntryPublisher putIfAbsent(K key)

A conditional form of put which inserts an entry into the cache only if no mapping for the key is already present. The operation is atomic. The server only performs the operation once the data is complete.

Parameters:

key - key to use

putIfAbsent

AsyncStreamingCache.CacheEntryPublisher putIfAbsent(K key,
 CacheWriteOptions metadata)

A conditional form of put which inserts an entry into the cache only if no mapping for the key is already present. The operation is atomic. The server only performs the operation once the data is complete.

Parameters:

key - key to use

metadata - metadata