Package org.apache.accumulo.core.client

Interface Instance

All Known Implementing Classes:

MiniAccumuloInstance, ZooKeeperInstance

@Deprecated(since="2.0.0")
public interface Instance

Deprecated.

since 2.0.0, use Accumulo.newClient() and Properties instead

This class represents the information a client needs to know to connect to an instance of accumulo.

Method Summary

Modifier and Type	Method	Description
default Connector	getConnector(String user, byte[] pass)	Deprecated. since 1.5, use getConnector(String, AuthenticationToken) with PasswordToken
default Connector	getConnector(String user, CharSequence pass)	Deprecated. since 1.5, use getConnector(String, AuthenticationToken) with PasswordToken
default Connector	getConnector(String user, ByteBuffer pass)	Deprecated. since 1.5, use getConnector(String, AuthenticationToken) with PasswordToken
Connector	getConnector(String principal, AuthenticationToken token)	Deprecated. Returns a connection to this instance of accumulo.
String	getInstanceID()	Deprecated. Returns a unique string that identifies this instance of accumulo.
String	getInstanceName()	Deprecated. Returns the instance name given at system initialization time.
List<String>	getMasterLocations()	Deprecated. Returns the location(s) of the accumulo manager and any redundant servers.
String	getRootTabletLocation()	Deprecated. Returns the location of the tablet server that is serving the root tablet.
String	getZooKeepers()	Deprecated. Returns a comma-separated list of zookeeper servers the instance is using.
int	getZooKeepersSessionTimeOut()	Deprecated. Returns the zookeeper connection timeout.

Method Details

getRootTabletLocation

String getRootTabletLocation()

Deprecated.

Returns the location of the tablet server that is serving the root tablet.

Returns:

location in "hostname:port" form

getMasterLocations

List<String> getMasterLocations()

Deprecated.

Returns the location(s) of the accumulo manager and any redundant servers.

Returns:

a list of locations in "hostname:port" form

getInstanceID

String getInstanceID()

Deprecated.

Returns a unique string that identifies this instance of accumulo.

Returns:

a UUID

getInstanceName

String getInstanceName()

Deprecated.

Returns the instance name given at system initialization time.

Returns:

current instance name

getZooKeepers

String getZooKeepers()

Deprecated.

Returns a comma-separated list of zookeeper servers the instance is using.

Returns:

the zookeeper servers this instance is using in "hostname:port" form

getZooKeepersSessionTimeOut

int getZooKeepersSessionTimeOut()

Deprecated.

Returns the zookeeper connection timeout.

Returns:

the configured timeout to connect to zookeeper

getConnector

@Deprecated(since="1.5.0")
default Connector getConnector(String user,
 byte[] pass)
                        throws AccumuloException,
AccumuloSecurityException

Deprecated.

since 1.5, use getConnector(String, AuthenticationToken) with PasswordToken

Returns a connection to accumulo.

Parameters:

user - a valid accumulo user

pass - A UTF-8 encoded password. The password may be cleared after making this call.

Returns:

the accumulo Connector

Throws:

AccumuloException - when a generic exception occurs

AccumuloSecurityException - when a user's credentials are invalid

getConnector

@Deprecated(since="1.5.0")
default Connector getConnector(String user,
 ByteBuffer pass)
                        throws AccumuloException,
AccumuloSecurityException

Deprecated.

since 1.5, use getConnector(String, AuthenticationToken) with PasswordToken

Returns a connection to accumulo.

Parameters:

user - a valid accumulo user

pass - A UTF-8 encoded password. The password may be cleared after making this call.

Returns:

the accumulo Connector

Throws:

AccumuloException - when a generic exception occurs

AccumuloSecurityException - when a user's credentials are invalid

getConnector

@Deprecated(since="1.5.0")
default Connector getConnector(String user,
 CharSequence pass)
                        throws AccumuloException,
AccumuloSecurityException

Deprecated.

since 1.5, use getConnector(String, AuthenticationToken) with PasswordToken

Returns a connection to this instance of accumulo.

Parameters:

user - a valid accumulo user

pass - If a mutable CharSequence is passed in, it may be cleared after this call.

Returns:

the accumulo Connector

Throws:

AccumuloException - when a generic exception occurs

AccumuloSecurityException - when a user's credentials are invalid

getConnector

Connector getConnector(String principal,
 AuthenticationToken token)
                throws AccumuloException,
AccumuloSecurityException

Deprecated.

Returns a connection to this instance of accumulo.

Parameters:

principal - a valid accumulo user

token - Use the token type configured for the Accumulo instance you are connecting to. An Accumulo instance with default configurations will use PasswordToken

Throws:

AccumuloException

AccumuloSecurityException

Since:

1.5.0