All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class semper.txlayer.transfer.TransferTransaction

java.lang.Object
   |
   +----semper.txlayer.transaction.Transaction
           |
           +----semper.txlayer.transfer.TransferTransaction

public abstract class TransferTransaction
extends Transaction
implements Serializable

This class is the baseclass for performing transfers between two semper applications. The class is intended to provide the infrastructure for performing a SEMPER-transfer protocol. This is done by subclasses which then implement a specific transfer protocol. This class itself does not define a transfer protocol; it is an abstract class. Specific protocolls are, e.g., VectorTransfer or PaymentTransfer.

_date
_description: The Description that will be parsed to Subtransactions.
_from: Contains infos about sender, receiver and date after the transfer.
_isSubTransfer: Are we a SubTransfer or are we at the top of the Transaction tree?
_offeredAttributes: The secAttributes that are to be applied to the transfer.
_requestedAttributes
_role: The role of the transfertransaction object.
_to
_transferScheduler: This holds the Scheduler that will monitor all TransferTransactions in a tree.
_txc: The TXSubContext that contains our communication means.
NO_ROLE: These constants define the roles
RECEIVER
SENDER

TransferTransaction(): empty constructor.
TransferTransaction(TransactionID)

getNRView(): This method is needed for supporting non repudiation.
getObject(): After the transaction was committed, this method returns the resulting = received Object.
getRole(): Tells if the transaction acts as a sender or as a receiver.
prepareReceiver(TXSubContext): This method be called before a begin().
prepareReceiver(TXSubContext, AttributeSet, AttributeSet): This method be called before a begin().
prepareReceiver(TXSubContext, AttributeSet, AttributeSet, Description): This method be called before a begin().
prepareReceiver(TXSubContext, Description): This method be called before a begin().
prepareSender(TXSubContext): This method must be called before a begin().
prepareSender(TXSubContext, AttributeSet, AttributeSet): This method must be called before a begin().
prepareSender(TXSubContext, AttributeSet, AttributeSet, Description): This method be called before a begin().
prepareSender(TXSubContext, Description): This method must be called before a begin().
prepareSubReceiver(TXSubContext, AttributeSet, AttributeSet, Description, TransferScheduler): This is a TXLayer private method.
prepareSubSender(TXSubContext, AttributeSet, AttributeSet, Description, TransferScheduler): This is a TXLayer private method.
read(): TransferTransaction read method.
receive(): This method is invoked when the preparation is done and the transaction shall begin.
run(): The Thread's run method.
send(): This method is invoked when the preparation is done and the transaction shall begin.
write(Serializable): TransferTransactions write method.

NO_ROLE

 public static final int NO_ROLE

These constants define the roles

RECEIVER

 public static final int RECEIVER

SENDER

 public static final int SENDER

_role

 protected int _role

The role of the transfertransaction object.

_txc

 protected TXSubContext _txc

The TXSubContext that contains our communication means.

_offeredAttributes

 protected AttributeSet _offeredAttributes

The secAttributes that are to be applied to the transfer.

_requestedAttributes

 protected AttributeSet _requestedAttributes

_description

 protected Description _description

The Description that will be parsed to Subtransactions.

_isSubTransfer

 protected boolean _isSubTransfer

Are we a SubTransfer or are we at the top of the Transaction tree?

_transferScheduler

 protected TransferScheduler _transferScheduler

This holds the Scheduler that will monitor all TransferTransactions in a tree. Not actively used up to now.

_from

 protected String _from

Contains infos about sender, receiver and date after the transfer. Intended for inclusion into an NRView.

_to

 protected String _to

_date

 protected Date _date

TransferTransaction

 public TransferTransaction()

empty constructor.

TransferTransaction

 public TransferTransaction(TransactionID tid)

getNRView

 public abstract NRView getNRView()

This method is needed for supporting non repudiation.

Returns:: The NRView returned must be a presentation of the data items and the transfer protocol parameters that are needed for building a real non repudiation prrof.

run

 public void run()

The Thread's run method. DON'T CALL this method from outside.

Overrides:: run in class Transaction

prepareSender

 public void prepareSender(TXSubContext txc)

This method must be called before a begin(). It is a hook to do some pre-stuff for the sender of a transferable object.

Parameters:: txc - The TXSubContext to send the stuff to... . Please don't use subcontext 99990 to 99999 as they are reserved for internal use.

prepareSender

 public void prepareSender(TXSubContext txc,
                           Description descr)

This method must be called before a begin(). It is a hook to do some pre-stuff for the sender of a transferable object.

Parameters:: txc - The TXSubContext to send the stuff to... . Please don't use subcontext 99990 to 99999 as they are reserved for internal use.; descr - The Description of the transfered objects. Currently ignored.

prepareSender

 public void prepareSender(TXSubContext txc,
                           AttributeSet offeredAttributes,
                           AttributeSet requestedAttributes)

This method must be called before a begin(). It is a hook to do some pre-stuff for the sender of a transferable object.

Parameters:: txc - The TXSubContext to send the stuff to... . Please don't use subcontext 99990 to 99999 as they are reserved for internal use.; offeredAttributes - The security attributes that are offered to the peer in the transfer.; requestedAttributes - The security attributes that are requested from the peer.

prepareSender

 public void prepareSender(TXSubContext txc,
                           AttributeSet offeredAttributes,
                           AttributeSet requestedAttributes,
                           Description descr)

This method be called before a begin(). It is a hook to do some pre-stuff for the sender of a transferable object.

Parameters:: txc - The TXSubContext to send the stuff to... . Please don't use subcontext 99990 to 99999 as they are reserved for internal use.; offeredAttributes - The security attributes that are offered to the peer in the transfer.; requestedAttributes - The security attributes that are requested from the peer.; descr - The Description of the transfered objects. Currently ignored.

prepareSubSender

 public void prepareSubSender(TXSubContext txc,
                              AttributeSet offeredAttributes,
                              AttributeSet requestedAttributes,
                              Description descr,
                              TransferScheduler transferScheduler)

This is a TXLayer private method. It is to be called before a begin(). It is a hook to do some pre-stuff for the sender of a transferable object and is only to be used with Subtransfers in a tree of TransferTransactions.

Parameters:: txc - The TXSubContext to send the stuff to... . Please don't use subcontext 99990 to 99999 as they are reserved for internal use.; offeredAttributes - The security attributes that are offered to the peer in the transfer.; requestedAttributes - The security attributes that are requested from the peer.; descr - The Description of the transfered objects. Currently ignored.; transferScheduler - An instantiated scheduler that monitors all TransferTransactions in a tree. Not used up to now.

prepareReceiver

 public void prepareReceiver(TXSubContext txc)

This method be called before a begin(). It is a hook to do some pre-stuff for the receiver of a transferable object.

Parameters:: txc - The TXSubContext to send the stuff to... . Please don't use subcontext 99990 to 99999 as they are reserved for internal use.

prepareReceiver

 public void prepareReceiver(TXSubContext txc,
                             Description descr)

This method be called before a begin(). It is a hook to do some pre-stuff for the receiver of a transferable object.

Parameters:: txc - The TXSubContext to send the stuff to... . Please don't use subcontext 99990 to 99999 as they are reserved for internal use.; descr - The Description of the transfered objects. Currently ignored.

prepareReceiver

 public void prepareReceiver(TXSubContext txc,
                             AttributeSet offeredAttributes,
                             AttributeSet requestedAttributes)

This method be called before a begin(). It is a hook to do some pre-stuff for the receiver of a transferable object.

Parameters:: txc - The TXSubContext to send the stuff to... . Please don't use subcontext 99990 to 99999 as they are reserved for internal use.; offeredAttributes - The security attributes that are offered to the peer in the transfer.; requestedAttributes - The security attributes that are requested from the peer.

prepareReceiver

 public void prepareReceiver(TXSubContext txc,
                             AttributeSet offeredAttributes,
                             AttributeSet requestedAttributes,
                             Description descr)

This method be called before a begin(). It is a hook to do some pre-stuff for the receiver of a transferable object.

Parameters:: txc - The TXSubContext to send the stuff to... . Please don't use subcontext 99990 to 99999 as they are reserved for internal use.; offeredAttributes - The security attributes that are offered to the peer in the transfer.; requestedAttributes - The security attributes that are requested from the peer.; descr - The Description of the transfered objects. Currently ignored.

prepareSubReceiver

 public void prepareSubReceiver(TXSubContext txc,
                                AttributeSet offeredAttributes,
                                AttributeSet requestedAttributes,
                                Description descr,
                                TransferScheduler transferScheduler)

This is a TXLayer private method. It is to be called before a begin(). It is a hook to do some pre-stuff for the receiver of a transferable object and is only to be used with Subtransfers in a tree of TransferTransactions.

Parameters:: txc - The TXSubContext to send the stuff to... .; offeredAttributes - The security attributes that are offered to the peer in the transfer.; requestedAttributes - The security attributes that are requested from the peer.; descr - The Description of the transfered objects. Currently ignored.; transferScheduler - An instantiated scheduler that monitors all TransferTransactions in a tree. Not used up to now.

getObject

 public abstract Object getObject()

After the transaction was committed, this method returns the resulting = received Object. Here, this method is abstract.

Returns:: The received object.

getRole

 public int getRole()

Tells if the transaction acts as a sender or as a receiver. see also the constants TransferTransaction.NO_ROLE, TransferTransaction.SENDER, TransferTransaction.RECEIVER.

send

 protected abstract void send() throws TXLayerException

This method is invoked when the preparation is done and the transaction shall begin. This is the point to enter the code for the special protocol, the sender's part.

Throws: TXLayerException: When problems occur.

receive

 protected abstract void receive() throws TXLayerException

This method is invoked when the preparation is done and the transaction shall begin. This is the point to enter the code for the special protocol, the receiver's part.

Throws: TXLayerException: When problems occur.

write

 protected void write(Serializable s) throws TXContextCommException

TransferTransactions write method. Can be used in derived transfertransactions.

Parameters:: s - The object to be written.
Throws: TXContextCommException: When comm problems occur.

read

 protected Serializable read() throws TXContextCommException

TransferTransaction read method. Can be used in derived transfertransaction.

Returns:: The read object.
Throws: TXContextCommException: When comm problems occur.

All Packages  Class Hierarchy  This Package  Previous  Next  Index