All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class semper.commerce.GenericTransaction

java.lang.Object
   |
   +----semper.commerce.Transaction
           |
           +----semper.commerce.GenericTransaction

public class GenericTransaction
extends Transaction
This class defines a generic transaction class for exchanging business application specific data between peer business applications. This type of transaction does not correspond to any of the core services of SEMPER and is only intended to exchange data between peer business applications. These transactions are not signed or authorised/acknowledged by the user.

Version:
$Id: GenericTransaction.java,v 1.7 1998/08/27 09:47:51 semper Exp $
Author:
Rolf Michelsen, Stig Mj°lsnes
See Also:
PaymentTransaction, StatementTransaction

Constructor Index

 o GenericTransaction(ActiveDeal, Transaction)
Creates a generic transaction object that can later be requested.

Method Index

 o makeDescription()
Returns a generic description for this type of transactions.
 o request(AccessControlHandle)
Requests a generic transaction.

Constructors

 o GenericTransaction
 public GenericTransaction(ActiveDeal deal,
                           Transaction ref) throws AssociationException, TransactionException
Creates a generic transaction object that can later be requested. A transaction can only exist in the context of a deal and this deal must be specified as a parameter to the constructor.

A transaction can reference another transaction in the same deal. A transaction that does not reference another transaction is considered a top level transaction in the deal.

Parameters:
deal - The deal containing this transaction.
ref - The transaction referenced by this transaction or null for a top level transaction.
Throws: AssociationException
Thrown if the transaction cannot be created because of problems with the association with the peer.
Throws: TransactionException
Thrown if the transaction cannot be created for some other reason.

Methods

 o makeDescription
 public Description makeDescription()
Returns a generic description for this type of transactions. Generic transactions are intended for exchanging business application data between peer business applications and will not be authorised or acknowledged by the user. A very detailed description is thus not necessary, but classes extending this class might provide their own description.

Returns:
A generic description for this type of transaction.
Overrides:
makeDescription in class Transaction
 o request
 public synchronized void request(AccessControlHandle ach) throws AssociationException, TransactionException
Requests a generic transaction. This transaction request will result in a corresponding transaction indication to the peer. This is an unconfirmed service, and successful invocation of this method does not confirm that the transaction is successfull or even that it has taken place. Use the method requestStatus to inquire about the status of a transaction.

Generally, transactions must be authorised by the user but this does not apply to the generic transaction type. Thus, a null access control handle can be specified as a parameter to this method.

Note that this method can be overloaded by subclasses. An application must not pass access control capabilities to this method if an untrusted subclass might have overloaded this method.

Parameters:
ach - Any access control handle or null.
Throws: AssociationException
Thrown if something wrong with the assication prevents the transaction request.
Throws: TransactionException
Thrown if there is a problem with handling the transaction object itself. This method throws this exception if the transaction has already been requested.
Overrides:
request in class Transaction

All Packages  Class Hierarchy  This Package  Previous  Next  Index