All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class semper.commerce.PaymentTransaction

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

public class PaymentTransaction

extends Transaction

Version:

$Id: PaymentTransaction.java,v 1.12 1998/08/27 09:47:52 semper Exp $

Author:

Rolf Michelsen, Stig Mj�lsnes

See Also:

GenericTransaction, StatementTransaction

PaymentTransaction(ActiveDeal, Transaction, Payment)

Creates a payment transaction that can later be requested.

getPayment()

Returns information about the payment.

makeDescription()

Returns a generic payment transaction description.

request(AccessControlHandle)

Requests a payment transaction.

 public PaymentTransaction(ActiveDeal deal,
                           Transaction ref,
                           Payment payment) throws AssociationException, TransactionException

Creates a payment transaction that can later be requested. A payment transaction contains payment information in addition to the attributes of any transaction.

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.

payment - Information about the payment.

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.

 public Description makeDescription()

Returns a generic payment 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

 public Payment getPayment()

Returns information about the payment.

Returns:

Payment information for this transaction.

 public synchronized void request(AccessControlHandle ach) throws AssociationException, TransactionException

Requests a payment 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.

Payment transactions must be authorised by the user unless the application requesting the payment 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 something is wrong with the transaction object. Will be thrown if the transaction has already been requested.

Overrides:

request in class Transaction

All Packages  Class Hierarchy  This Package  Previous  Next  Index