All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class semper.commerce.StatementTransaction

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

public class StatementTransaction
extends Transaction
This class represents all commerce transactions based on the core SEMPER statement service. It provides non-repudiation of the transaction data.

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

Constructor Index

 o StatementTransaction(ActiveDeal, Transaction, Statement)
Creates a statement transaction that can later be requested.

Method Index

 o getStatement()
Returns information about the statement.
 o makeDescription()
Returns a generic statement transaction description.
 o request(AccessControlHandle)
Requests a statement transaction.

Constructors

 o StatementTransaction
 public StatementTransaction(ActiveDeal deal,
                             Transaction ref,
                             Statement statement) throws AssociationException, TransactionException
Creates a statement transaction that can later be requested. A statement transaction contains information about a statement in addition to the attributes common to all transactions.

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.
statement - Information about the statement.
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 statement transaction description. This description will be displayed and authorised or acknowledged by the user. Business applications should provide a specialised version of this method to provide more detailed information about the transaction.

This method is invoked by the commerce layer when it needs to get a description of the transaction.

Returns:
A description of the transaction.
Overrides:
makeDescription in class Transaction
 o getStatement
 public Statement getStatement()
Returns information about the statement.

Returns:
Statement information for this transaction.
 o request
 public synchronized void request(AccessControlHandle ach) throws AssociationException, TransactionException
Requests a statement 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.

Statement transactions must be authorised by the user unless the application requesting the statement possesses a suitable access control capability. A null access control handle can be specified by untrusted applications.

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 an error occurs while handling the transaction object. 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