com.neurosys.ecom.orders.service

Interface TransactionRequestHandler<T extends Transaction,O extends Order>

All Superinterfaces:

ChangeGenerator<Object>

All Known Subinterfaces:

OnlinePayment<T,O>

All Known Implementing Classes:

AbstractOnlineTransactionRequestHandler

public interface TransactionRequestHandler<T extends Transaction,O extends Order>
extends ChangeGenerator<Object>

A Service that will realize a Transaction from an Order and also persist the Transaction
The service to implement this often will have to rely on Third party API depending on the Gateway needs and requirements.

Also supports ChangeGenerator

Author:

Arjun Dhar

Method Summary

Modifier and Type	Method and Description
T	transact(O order, PaymentOption paymentOption, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) Perform the Transaction The transaction is not expected to exist prior to this method call.

Methods inherited from interface com.neurosys.events.ChangeGenerator

addChangeListener, getListeners, notifyAllListeners, setListeners

Method Detail

transact

T transact(O order,
           PaymentOption paymentOption,
           javax.servlet.http.HttpServletRequest request,
           javax.servlet.http.HttpServletResponse response)
    throws TransactionException,
           Continue

Perform the Transaction
The transaction is not expected to exist prior to this method call. Each call will generate a new Transaction

Parameters:

order - as Order

paymentOption - as PaymentOption @nullable true; optional and only required by the transaction handler if for the given Payment Method there are furthermultiple options

request - as HttpServletRequest

response - as HttpServletResponse

Returns:

T as Transaction

Throws:

TransactionException - for any genuine problem

{@link - Continue} or an extension of it; if there is successful processing and we need to redirect to a Web Page immediately/directly; while ensuring nothing is written to an Out Stream (response.redirect) scenarios Continue.getPayload() will contain the Object[] {redirectURL, Transaction}

Note: Continue provides a generic payload. To be more specific use a more specific implementation of Continue like WebPageTransactionRequest, WebURLTransactionRequest etc.

Continue