Package com.iizix.txp.impl
Class TXProcessImpl
- java.lang.Object
- com.iizix.txp.impl.TXProcessImpl
 
- All Implemented Interfaces:
- ITimeoutListener,- ITXProcess
 - public class TXProcessImpl extends java.lang.Object implements ITXProcess, ITimeoutListener Basic and crude (for now)- ITXProcessimplementation- Author:
- Freggle
 
- Nested Class Summary- Nested classes/interfaces inherited from interface com.iizix.txp.ITXProcess- ITXProcess.State
 
 - Constructor Summary- Constructors - Modifier - Constructor - Description - protected- TXProcessImpl(ITXPid pid, TXPCoordinatorImpl coordinator)Constructs a process.
 - Method Summary- All Methods Instance Methods Concrete Methods - Modifier and Type - Method - Description - void- addAttribute(java.lang.String name, java.lang.Object value)Adds a named attribute.- void- associate(ITXPNode node)Associate an atomic unit of work (a node) with this process.- void- commit()Called by the process logic/application (not the nodes!)to request that the transactional process gets committed.- java.lang.Object- getAttribute(java.lang.String name)Gets a named attribute.- ITXPPolicy- getLocalPolicy()Return the process local policy- ITXPid- getPid()Gets the pid of his process- long- getRemainingTime()Gets the remaining time before timeout.- ITXProcess.State- getState()Get the state of this process.- long- getTimeout()Returns the nr of milliseconds this process waits for all nodes.- protected ITXProcessLogger- log()- void- onTimeout()Called when timeout is reached.- void- ready(ITXPNode node, ITXPNode.State nodeState)A node will call this method to signal its state after attempting to do the work.- java.lang.Object- removeAttribute(java.lang.String name)Removes a named attribute.- void- rollback()Called by the process logic/application (not the nodes) to request that the transactional process rolls back the work.- void- setStartTimeout(long millisecs)Set the timeout time in milliseconds AND START THE TIMER!.- void- timeout(ITXPNode node)Called by a node indicating it timed out waiting on the process.- void- useLocalPolicy(ITXPPolicy policy)Have the coordinator use the specified local policy for this process.
 
- Constructor Detail- TXProcessImpl- protected TXProcessImpl(ITXPid pid, TXPCoordinatorImpl coordinator) Constructs a process.- Parameters:
- pid- the pid for this process
 
 
 - Method Detail- useLocalPolicy- public void useLocalPolicy(ITXPPolicy policy) Description copied from interface:- ITXProcessHave the coordinator use the specified local policy for this process. To stop using a local policy specify- null.- Specified by:
- useLocalPolicyin interface- ITXProcess
- Parameters:
- policy- the policy
 
 - getLocalPolicy- public ITXPPolicy getLocalPolicy() Description copied from interface:- ITXProcessReturn the process local policy- Specified by:
- getLocalPolicyin interface- ITXProcess
- Returns:
- the process local policy or null if none is used
 
 - getPid- public ITXPid getPid() Description copied from interface:- ITXProcessGets the pid of his process- Specified by:
- getPidin interface- ITXProcess
- Returns:
- the pid
 
 - getTimeout- public long getTimeout() Description copied from interface:- ITXProcessReturns the nr of milliseconds this process waits for all nodes. The timeout is applied when setStartTimeout() is called on the process. It is up to the coordinator (and maybe policy) to decide how to deal with a timeout but the nodes needs to be signalled that the process timed out and the defined behaviour for the node is to stop the work and wait for rollback unless the coordinator decides to CONTINUE or IGNORE the timeout.- Specified by:
- getTimeoutin interface- ITXProcess
- Returns:
- the timeout time in milliseconds
 
 - associate- public void associate(ITXPNode node) Description copied from interface:- ITXProcessAssociate an atomic unit of work (a node) with this process. This will cause a- begin()call in the node.- Specified by:
- associatein interface- ITXProcess
- Parameters:
- node- the node
 
 - getState- public ITXProcess.State getState() Description copied from interface:- ITXProcessGet the state of this process.- Specified by:
- getStatein interface- ITXProcess
- Returns:
- the state
 
 - ready- public void ready(ITXPNode node, ITXPNode.State nodeState) Description copied from interface:- ITXProcessA node will call this method to signal its state after attempting to do the work.- Specified by:
- readyin interface- ITXProcess
- Parameters:
- node- the node
- nodeState- the current state of the node
 
 - timeout- public void timeout(ITXPNode node) Description copied from interface:- ITXProcessCalled by a node indicating it timed out waiting on the process. The process (and coordinator) must assume that the node abandoned the process and rolled back any change they made on behalf of it.- Specified by:
- timeoutin interface- ITXProcess
- Parameters:
- node- the node
 
 - commit- public void commit() throws TXPExceptionDescription copied from interface:- ITXProcessCalled by the process logic/application (not the nodes!)to request that the transactional process gets committed.- Specified by:
- commitin interface- ITXProcess
- Throws:
- TXPException- a coordinator and policy dependent exception (today 1 of 3, more details later)
 
 - rollback- public void rollback() throws TXPExceptionDescription copied from interface:- ITXProcessCalled by the process logic/application (not the nodes) to request that the transactional process rolls back the work.- Specified by:
- rollbackin interface- ITXProcess
- Throws:
- TXPException- a coordinator and policy dependent exception (today 1 of 3, more details later)
 
 - addAttribute- public void addAttribute(java.lang.String name, java.lang.Object value)Description copied from interface:- ITXProcessAdds a named attribute.- Specified by:
- addAttributein interface- ITXProcess
- Parameters:
- name- the attribute name
- value- the attribute value
 
 - getAttribute- public java.lang.Object getAttribute(java.lang.String name) Description copied from interface:- ITXProcessGets a named attribute.- Specified by:
- getAttributein interface- ITXProcess
- Parameters:
- name- the attribute name
- Returns:
- the attribute value
 
 - removeAttribute- public java.lang.Object removeAttribute(java.lang.String name) Description copied from interface:- ITXProcessRemoves a named attribute.- Specified by:
- removeAttributein interface- ITXProcess
- Parameters:
- name- the attribute name
- Returns:
- the attribute value
 
 - setStartTimeout- public void setStartTimeout(long millisecs) Set the timeout time in milliseconds AND START THE TIMER!. -1L for indefinite (the default so you do not have to call it in that case) You should call this method after you associated all the nodes and all other initialization.- Specified by:
- setStartTimeoutin interface- ITXProcess
- Parameters:
- millisecs- the timeout time in milliseconds
 
 - onTimeout- public void onTimeout() Description copied from interface:- ITimeoutListenerCalled when timeout is reached.- Specified by:
- onTimeoutin interface- ITimeoutListener
 
 - log- protected ITXProcessLogger log() 
 - getRemainingTime- public long getRemainingTime() Gets the remaining time before timeout. This value just keeps on counting, even when the timeout has occurred or the task is stopped.- Specified by:
- getRemainingTimein interface- ITXProcess
- Returns:
- A time in milliseconds >= zero indicating the remaining timeout time, or < zero if the task has timed out. The return value is Long.MAX_VALUEif the timeout is indefinite or never set.