Package org.apache.hadoop.hdfs.server.federation.router.security.token

Class DistributedSQLCounter

java.lang.Object

org.apache.hadoop.hdfs.server.federation.router.security.token.DistributedSQLCounter

public class DistributedSQLCounter
extends java.lang.Object

Distributed counter that relies on a SQL database to synchronize between multiple clients. This expects a table with a single int field to exist in the database. One record must exist on the table at all times, representing the last used value reserved by a client.

Constructor Summary

Constructors

Constructor	Description
DistributedSQLCounter(java.lang.String field, java.lang.String table, SQLConnectionFactory connectionFactory)

Method Summary

Modifier and Type	Method	Description
int	incrementCounterValue(int amount)	Increments the counter by the given amount and returns the previous counter value.
int	selectCounterValue()	Obtains the value of the counter.
void	updateCounterValue(int value)	Sets the counter to the given value.
void	updateCounterValue(int value, java.sql.Connection connection)	Sets the counter to the given value.

Methods inherited from class java.lang.Object

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

Constructor Detail

DistributedSQLCounter

public DistributedSQLCounter(java.lang.String field,
                             java.lang.String table,
                             SQLConnectionFactory connectionFactory)

Method Detail

selectCounterValue

public int selectCounterValue()
                       throws java.sql.SQLException

Obtains the value of the counter.

Returns:

counter value.

Throws:

java.sql.SQLException - if querying the database fails.

updateCounterValue

public void updateCounterValue(int value)
                        throws java.sql.SQLException

Sets the counter to the given value.

Parameters:

value - Value to assign to counter.

Throws:

java.sql.SQLException - if querying the database fails.

updateCounterValue

public void updateCounterValue(int value,
                               java.sql.Connection connection)
                        throws java.sql.SQLException

Sets the counter to the given value.

Parameters:

value - Value to assign to counter.

connection - Connection to database hosting the counter table.

Throws:

java.sql.SQLException - if querying the database fails.

incrementCounterValue

public int incrementCounterValue(int amount)
                          throws java.sql.SQLException

Increments the counter by the given amount and returns the previous counter value.

Parameters:

amount - Amount to increase the counter.

Returns:

Previous counter value.

Throws:

java.sql.SQLException - if querying the database fails.