org.eiichiro.acidhouse

Interface Coordinator

public interface Coordinator

Coordinator is a transaction coordinator for "Two-phase commit protocol". Coordinator is instantiated by Session when a transaction is started and every transactional operation is forwarded to the coordinator. If multiple entities are updated (also, inserted and deleted) in a transaction, the coordinator has to make multiple ResourceManagers manage them and commit these operations atomically by Two-phase commit protocol.

Author:

Eiichiro Uchiumi

Method Summary

Methods

Modifier and Type	Method and Description
void	commit() Commits every operation in the current transaction with Two-phase commit protocol.
void	delete(Object entity) Deletes entity instance in the current transaction.
<E> E	get(Class<E> clazz, Object key) Gets entity instance of the specified Class corresponding to the specified id in the current transaction.
void	put(Object entity) Puts entity instance in the current transaction.
void	rollback() Rolls back every operation in the current transaction.
void	update(Object entity) Updates entity instance in the current transaction.

Method Detail

get

<E> E get(Class<E> clazz,
        Object key)

Gets entity instance of the specified Class corresponding to the specified id in the current transaction.

Type Parameters:

E - The type of entity.

Parameters:

clazz - The Class of entity.

key - The key of the entity.

Returns:

Entity instance of the specified Class corresponding to the specified entity id.

put

void put(Object entity)

Puts entity instance in the current transaction.

Parameters:

entity - The entity to be put into datastore.

update

void update(Object entity)

Updates entity instance in the current transaction.

Parameters:

entity - The entity to be updated.

delete

void delete(Object entity)

Deletes entity instance in the current transaction.

Parameters:

entity - The entity to be deleted.

commit

void commit()
            throws IndoubtException

Commits every operation in the current transaction with Two-phase commit protocol.

Throws:

IndoubtException - If the data consistency is broken.

rollback

void rollback()

Rolls back every operation in the current transaction.