All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class semper.payment.generic.genericPurse

java.lang.Object
   |
   +----semper.payment.Purse
           |
           +----semper.payment.AccountBasedPurse
                   |
                   +----semper.payment.generic.genericPurse

public class genericPurse

extends AccountBasedPurse

implements Streamable

Version:

$Revision: 1.36 $ $Date: 1997/04/14 12:45:33 $

Author:

N. Asokan ([email protected]), Jose-Luis Abad-Peiro ([email protected])

See Also:

genericTransaction

genericPurse()

Constructor

genericPurse(String, PaymentEntity, PaymentEntity)

Constructor

getAccountNumber()

Get the account number

getAmount()

Get the current amount in the purse Implemented from abstract method defined in Purse

getAmountFromBank()

Get the amount (balance) in our bank account.

getPaymentSystemName()

Get the Payment System Name which is represented by this purse Access to the attribute _paymentSystemName.

getPrintableStatusInfo()

Return a hash table containing "attribute-value" pairs describing the status of the purse.

getPurseAddress()

We override getPurseAddress() so that it always contains the current host address.

getUnlockedAmount()

Get the unlocked amount Implemented from abstract method defined in Purse

init()

Initialise.

isCurrencySupported(Currency)

Check if a given currency is supported Implemented from abstract method defined in Purse

isEnabled()

This adapter is always available for use.

isRegistered()

Has this purse been registered with its "bank"?

isSecurityServiceOffered(SecurityOption)

Check if a specific security service is offered Implemented from abstract method defined in Purse

myStreamSize()

Implementing the Streamable interface

offeredSecurityServices()

Get the list of security services offered Implemented from abstract method defined in Purse

readObject(StreamInputInterface)

Implementing the Streamable interface

registerWithBank()

Register or re-register a purse _with_the_bank_.

setUnlockedAmount(Amount)

Set the unlocked amount Implemented from abstract method defined in Purse

setup(TinguinDisplay)

Setup the purse.

setupChoices()

set up choices vector

startTransaction()

Starts a new Transaction.

startTransaction(PaymentTransactionRecord)

Resume an existing transaction

supportedCurrency()

Return the list of supported currencies Implemented from abstract method defined in Purse

writeObject(StreamOutputInterface)

Implementing the Streamable interface

  public genericPurse()

Constructor

  public genericPurse(String purse_name,
                      PaymentEntity bank,
                      PaymentEntity address)

Constructor

  public PaymentTransaction startTransaction() throws PaymentServiceException

Starts a new Transaction. The invoker of this method should explicitly cast the returned object to genericTransaction

Throws: PaymentServiceException

if a transaction cannot be started.

Overrides:

startTransaction in class Purse

See Also:

startTransaction

  public PaymentTransaction startTransaction(PaymentTransactionRecord pr) throws PaymentServiceException

Resume an existing transaction

Parameters:

pr - Existing payment transaction record

Returns:

a new PaymentTransaction object

Throws: PaymentServiceException

in case of exceptions

Overrides:

startTransaction in class Purse

  public String getPaymentSystemName()

Get the Payment System Name which is represented by this purse Access to the attribute _paymentSystemName. Overriding default method defined in Purse.java The first part of the payment system name is a static class-wide constant that is unique to a payment system (GENERIC). The second part is the brand name (e.g. EuroCard).

Overrides:

getPaymentSystemName in class Purse

See Also:

getPaymentSystemName

  public void registerWithBank() throws PaymentServiceException

Register or re-register a purse _with_the_bank_. Implemented from abstract method defined in Purse

Throws: PaymentServiceException

if registration failed

Overrides:

registerWithBank in class Purse

See Also:

registerWithBank

  protected String getAccountNumber()

Get the account number

Returns:

string containing the account number for this purse

See Also:

registerWithBank

  public Vector supportedCurrency()

Return the list of supported currencies Implemented from abstract method defined in Purse

Overrides:

supportedCurrency in class Purse

See Also:

supportedCurrency

  public boolean isCurrencySupported(Currency currency)

Check if a given currency is supported Implemented from abstract method defined in Purse

Overrides:

isCurrencySupported in class Purse

See Also:

isCurrencySupported

  public Vector offeredSecurityServices()

Get the list of security services offered Implemented from abstract method defined in Purse

Overrides:

offeredSecurityServices in class Purse

See Also:

offeredSecurityServices

  public boolean isSecurityServiceOffered(SecurityOption service)

Check if a specific security service is offered Implemented from abstract method defined in Purse

Overrides:

isSecurityServiceOffered in class Purse

See Also:

isSecurityServiceOffered

  public Amount getAmount() throws AmountNotApplicable

Get the current amount in the purse Implemented from abstract method defined in Purse

Throws: AmountNotApplicable

always because current amount does not make sense in this system

Overrides:

getAmount in class Purse

See Also:

getAmount

  public Amount getAmountFromBank() throws AmountNotApplicable, PaymentServiceException

Get the amount (balance) in our bank account. The value of the amount can be positive or negative, the latter indicating money owed. This makes sense only for account-based payment systems.

Returns:

amount according to the bank account

Throws: AmountNotApplicable

in those systems where it is not possible to check the bank balance

Throws: PaymentServiceException

for other miscellaneous errors

Overrides:

getAmountFromBank in class AccountBasedPurse

  public synchronized void setUnlockedAmount(Amount amount)

Set the unlocked amount Implemented from abstract method defined in Purse

Overrides:

setUnlockedAmount in class Purse

See Also:

setUnlockedAmount

  public Amount getUnlockedAmount()

Get the unlocked amount Implemented from abstract method defined in Purse

Overrides:

getUnlockedAmount in class Purse

See Also:

getUnlockedAmount

  public PaymentEntity getPurseAddress()

We override getPurseAddress() so that it always contains the current host address. TODO: Check if this is a reasonable thing to do

Returns:

PaymentEntity object indicating the address

Overrides:

getPurseAddress in class Purse

  public boolean isEnabled()

This adapter is always available for use. Indicate it by always returning true.

Returns:

s true

Overrides:

isEnabled in class Purse

  public boolean isRegistered()

Has this purse been registered with its "bank"?

Returns:

s true if registered, false otherwise

Overrides:

isRegistered in class Purse

  public Hashtable getPrintableStatusInfo()

Return a hash table containing "attribute-value" pairs describing the status of the purse. Overrides the default implementation in the parent class.

• Used-by: PurseManagementApp during purse configuration

Returns:

Hashtable containing attr-value pairs

Overrides:

getPrintableStatusInfo in class Purse

See Also:

getPrintableStatusInfo

  public synchronized void init() throws PaymentServiceException

Initialise. The following actions are currently taken:

Register a place to receive payments

[tbd] read in preferences (initialise with defaults if needed)

Throws: PaymentServiceException

on init failure

Overrides:

init in class Purse

  public static void setupChoices()

set up choices vector

  public void setup(TinguinDisplay dis) throws PaymentServiceException

Setup the purse. We have the option of entirely re-writing setup() or trying to provide additional services to those provided by the base class. We'll do the latter.

Parameters:

dis - an active Tinguin session

Returns:

nothing

Throws: PaymentServiceException

on misc. errors

Overrides:

setup in class Purse

See Also:

setup

  public void writeObject(StreamOutputInterface s) throws StreamIOException

Implementing the Streamable interface

Throws: StreamIOException

as usual

Overrides:

writeObject in class Purse

  public void readObject(StreamInputInterface s) throws StreamIOException

Implementing the Streamable interface

Throws: StreamIOException

as usual

Overrides:

readObject in class Purse

  public int myStreamSize() throws StreamIOException

Implementing the Streamable interface

Overrides:

myStreamSize in class Purse

All Packages  Class Hierarchy  This Package  Previous  Next  Index