org.apache.ignite.internal.client.thin

Class TcpIgniteClient

java.lang.Object

org.apache.ignite.internal.client.thin.TcpIgniteClient

All Implemented Interfaces:

AutoCloseable, IgniteClient

public class TcpIgniteClient
extends Object
implements IgniteClient

Implementation of IgniteClient over TCP protocol.

Method Summary

Modifier and Type	Method and Description
IgniteBinary	binary()
<K,V> ClientCache<K,V>	cache(String name) Get existing cache.
Collection<String>	cacheNames()
void	close()
ClientCluster	cluster() Gets client cluster facade.
ClientCompute	compute() Gets compute facade over all cluster nodes started in server mode.
ClientCompute	compute(ClientClusterGroup grp) Gets compute facade over the specified cluster group.
<K,V> ClientCache<K,V>	createCache(ClientCacheConfiguration cfg) Create cache.
<K,V> ClientCache<K,V>	createCache(String name) Create cache.
void	destroyCache(String name) Destroy cache.
<K,V> ClientCache<K,V>	getOrCreateCache(ClientCacheConfiguration cfg) Get existing cache or create the cache if it does not exist.
<K,V> ClientCache<K,V>	getOrCreateCache(String name) Get existing cache or create the cache if it does not exist.
FieldsQueryCursor<List<?>>	query(SqlFieldsQuery qry) Execute SQL query and get cursor to iterate over results.
ClientServices	services() Gets services facade over all cluster nodes started in server mode.
ClientServices	services(ClientClusterGroup grp) Gets services facade over nodes within the cluster group.
static IgniteClient	start(ClientConfiguration cfg) Initializes new instance of IgniteClient.
ClientTransactions	transactions() Gets client transactions facade.

Methods inherited from class java.lang.Object

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

Method Detail

close

public void close()
           throws Exception

Specified by:

close in interface AutoCloseable

Throws:

Exception

getOrCreateCache

public <K,V> ClientCache<K,V> getOrCreateCache(String name)
                                        throws ClientException

Get existing cache or create the cache if it does not exist.

Specified by:

getOrCreateCache in interface IgniteClient

Parameters:

name - Cache name.

Throws:

ClientException

getOrCreateCache

public <K,V> ClientCache<K,V> getOrCreateCache(ClientCacheConfiguration cfg)
                                        throws ClientException

Get existing cache or create the cache if it does not exist.

Specified by:

getOrCreateCache in interface IgniteClient

Parameters:

cfg - Cache configuration.

Throws:

ClientException

cache

public <K,V> ClientCache<K,V> cache(String name)

Get existing cache.

Specified by:

cache in interface IgniteClient

Parameters:

name - Cache name.

cacheNames

public Collection<String> cacheNames()
                              throws ClientException

Specified by:

cacheNames in interface IgniteClient

Returns:

Collection of names of currently available caches or an empty collection if no caches are available.

Throws:

ClientException

destroyCache

public void destroyCache(String name)
                  throws ClientException

Destroy cache.

Specified by:

destroyCache in interface IgniteClient

Throws:

ClientException

createCache

public <K,V> ClientCache<K,V> createCache(String name)
                                   throws ClientException

Create cache.

Specified by:

createCache in interface IgniteClient

Parameters:

name - Cache name.

Throws:

ClientException

createCache

public <K,V> ClientCache<K,V> createCache(ClientCacheConfiguration cfg)
                                   throws ClientException

Create cache.

Specified by:

createCache in interface IgniteClient

Parameters:

cfg - Cache configuration.

Throws:

ClientException

binary

public IgniteBinary binary()

Specified by:

binary in interface IgniteClient

Returns:

Instance of IgniteBinary interface.

query

public FieldsQueryCursor<List<?>> query(SqlFieldsQuery qry)

Execute SQL query and get cursor to iterate over results.

Specified by:

query in interface IgniteClient

Parameters:

qry - SQL query.

Returns:

Cursor.

transactions

public ClientTransactions transactions()

Gets client transactions facade.

Specified by:

transactions in interface IgniteClient

Returns:

Client transactions facade.

compute

public ClientCompute compute()

Gets compute facade over all cluster nodes started in server mode.

Specified by:

compute in interface IgniteClient

Returns:

Compute instance over all cluster nodes started in server mode.

compute

public ClientCompute compute(ClientClusterGroup grp)

Gets compute facade over the specified cluster group. All operations on the returned ClientCompute instance will only include nodes from this cluster group.

Specified by:

compute in interface IgniteClient

Parameters:

grp - Cluster group.

Returns:

Compute instance over given cluster group.

cluster

public ClientCluster cluster()

Gets client cluster facade.

Specified by:

cluster in interface IgniteClient

Returns:

Client cluster facade.

services

public ClientServices services()

Gets services facade over all cluster nodes started in server mode.

Specified by:

services in interface IgniteClient

Returns:

Services facade over all cluster nodes started in server mode.

services

public ClientServices services(ClientClusterGroup grp)

Gets services facade over nodes within the cluster group. All operations on the returned ClientServices instance will only include nodes from the specified cluster group. Note: In some cases there will be additional requests for each service invocation from client to server to resolve cluster group.

Specified by:

services in interface IgniteClient

Parameters:

grp - Cluster group.

Returns:

Services functionality over given cluster group.

start

public static IgniteClient start(ClientConfiguration cfg)
                          throws ClientException

Initializes new instance of IgniteClient.

Parameters:

cfg - Thin client configuration.

Returns:

Client with successfully opened thin client connection.

Throws:

ClientException