Package org.infinispan.client.hotrod

Interface RemoteCacheManagerAdmin

All Superinterfaces:

CacheContainerAdmin<RemoteCacheManagerAdmin,BasicConfiguration>

All Known Implementing Classes:

RemoteCacheManagerAdminImpl

public interface RemoteCacheManagerAdmin
extends CacheContainerAdmin<RemoteCacheManagerAdmin,BasicConfiguration>

Remote Administration operations

Since:

9.1

Author:

Tristan Tarrant

Nested Class Summary

Nested classes/interfaces inherited from interface org.infinispan.commons.api.CacheContainerAdmin

CacheContainerAdmin.AdminFlag

Method Summary

Modifier and Type	Method	Description
<K, V> RemoteCache<K,V>	createCache(String name, String template)	Creates a cache on the remote server cluster using the specified template name.
<K, V> RemoteCache<K,V>	createCache(String name, DefaultTemplate template)	Deprecated, for removal: This API element is subject to removal in a future version. use createCache(String, String) instead
<K, V> RemoteCache<K,V>	createCache(String name, BasicConfiguration configuration)	Creates a cache on the remote server cluster using the specified configuration
<K, V> RemoteCache<K,V>	getOrCreateCache(String name, String template)	Retrieves an existing cache on the remote server cluster.
<K, V> RemoteCache<K,V>	getOrCreateCache(String name, DefaultTemplate template)	Deprecated, for removal: This API element is subject to removal in a future version. use getOrCreateCache(String, String) instead
<K, V> RemoteCache<K,V>	getOrCreateCache(String name, BasicConfiguration configuration)	Retrieves an existing cache on the remote server cluster.
void	reindexCache(String name)	Performs a mass reindexing of the specified cache.
void	removeCache(String name)	Removes a cache from the remote server cluster.
void	updateConfigurationAttribute(String cacheName, String attribute, String value)	Updates a mutable configuration attribute for the given cache.
void	updateIndexSchema(String cacheName)	Updates the index schema state for the given cache, the cache engine is hot restarted so that index persisted or not persisted state will be preserved.

Methods inherited from interface org.infinispan.commons.api.CacheContainerAdmin

createTemplate, removeTemplate, withFlags, withFlags

Method Details

createCache

<K,
V> RemoteCache<K,V> createCache(String name,
 String template)
                             throws HotRodClientException

Creates a cache on the remote server cluster using the specified template name.

Specified by:

createCache in interface CacheContainerAdmin<RemoteCacheManagerAdmin,BasicConfiguration>

Parameters:

name - the name of the cache to create

template - the template to use for the cache. If null, the configuration marked as default on the server will be used

Returns:

the cache

Throws:

HotRodClientException

createCache

@Deprecated(forRemoval=true)
<K,
V> RemoteCache<K,V> createCache(String name,
 DefaultTemplate template)
                             throws HotRodClientException

Deprecated, for removal: This API element is subject to removal in a future version.

use createCache(String, String) instead

Creates a cache on the remote server cluster using the specified default configuration template present in the server.

Parameters:

name - the name of the cache to create

template - DefaultTemplate enum

Returns:

the cache

Throws:

HotRodClientException

createCache

<K,
V> RemoteCache<K,V> createCache(String name,
 BasicConfiguration configuration)
                             throws HotRodClientException

Creates a cache on the remote server cluster using the specified configuration

Specified by:

createCache in interface CacheContainerAdmin<RemoteCacheManagerAdmin,BasicConfiguration>

Parameters:

name - the name of the cache to create

configuration - a concrete cache configuration that will be sent to the server in one of the supported formats: XML, JSON, and YAML. The server detects the format automatically. The configuration must conform to the Infinispan embedded configuration schema version that is supported by the server.

Returns:

the cache

Throws:

HotRodClientException

getOrCreateCache

<K,
V> RemoteCache<K,V> getOrCreateCache(String name,
 String template)
                                  throws HotRodClientException

Retrieves an existing cache on the remote server cluster. If it doesn't exist, it will be created using the specified template name.

Specified by:

getOrCreateCache in interface CacheContainerAdmin<RemoteCacheManagerAdmin,BasicConfiguration>

Parameters:

name - the name of the cache to create

template - the template to use for the cache. If null, the configuration marked as default on the server will be used

Returns:

the cache

Throws:

HotRodClientException

getOrCreateCache

@Deprecated(forRemoval=true)
<K,
V> RemoteCache<K,V> getOrCreateCache(String name,
 DefaultTemplate template)
                                  throws HotRodClientException

Deprecated, for removal: This API element is subject to removal in a future version.

use getOrCreateCache(String, String) instead

Retrieves an existing cache on the remote server cluster. If it doesn't exist, it will be created using the specified default template that is present in the server.

Parameters:

name - the name of the cache to create

template - DefaultTemplate enum

Returns:

the cache

Throws:

HotRodClientException

getOrCreateCache

<K,
V> RemoteCache<K,V> getOrCreateCache(String name,
 BasicConfiguration configuration)
                                  throws HotRodClientException

Retrieves an existing cache on the remote server cluster. If it doesn't exist, it will be created using the specified configuration.

Specified by:

getOrCreateCache in interface CacheContainerAdmin<RemoteCacheManagerAdmin,BasicConfiguration>

Parameters:

name - the name of the cache to create

configuration - a concrete cache configuration of that will be sent to the server in one of the supported formats: XML, JSON and YAML. The format will be detected automatically. The configuration must use the Infinispan embedded configuration schema in a version supported by the server.

Returns:

the cache

Throws:

HotRodClientException

removeCache

void removeCache(String name)
          throws HotRodClientException

Removes a cache from the remote server cluster.

Specified by:

removeCache in interface CacheContainerAdmin<RemoteCacheManagerAdmin,BasicConfiguration>

Parameters:

name - the name of the cache to remove

Throws:

HotRodClientException

reindexCache

void reindexCache(String name)
           throws HotRodClientException

Performs a mass reindexing of the specified cache. The command will return immediately and the reindexing will be performed asynchronously

Parameters:

name - the name of the cache to reindex

Throws:

HotRodClientException

updateIndexSchema

void updateIndexSchema(String cacheName)
                throws HotRodClientException

Updates the index schema state for the given cache, the cache engine is hot restarted so that index persisted or not persisted state will be preserved.

Parameters:

cacheName - the name of the cache on which the index schema will be updated

Throws:

HotRodClientException

updateConfigurationAttribute

void updateConfigurationAttribute(String cacheName,
 String attribute,
 String value)
                           throws HotRodClientException

Updates a mutable configuration attribute for the given cache.

Parameters:

cacheName - the name of the cache on which the attribute will be updated

attribute - the path of the attribute we want to change

value - the new value to apply to the attribute

Throws:

HotRodClientException