org.broadleafcommerce.common.web.payment.controller

Class PaymentGatewayAbstractController

java.lang.Object

org.broadleafcommerce.common.web.controller.BroadleafAbstractController

org.broadleafcommerce.common.web.payment.controller.PaymentGatewayAbstractController

public abstract class PaymentGatewayAbstractController
extends BroadleafAbstractController

Abstract controller that provides convenience methods and resource declarations for Payment Gateway Operations that are shared between all gateway controllers belong here.

The Core Framework should have an implementation of a "blPaymentGatewayCheckoutService" bean defined. If you are using the common jars without the framework dependency, you will either have to implement the blPaymentGatewayCheckoutService yourself, or override the applyPaymentToOrder and the markPaymentAsInvalid methods accordingly.

Author:

Elbert Bautista (elbertbautista)

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	baseCartRedirect
protected static String	baseConfirmationRedirect
protected static String	baseErrorView
protected static String	baseOrderReviewRedirect
protected static String	baseRedirect
protected static org.apache.commons.logging.Log	LOG
static String	PAYMENT_PROCESSING_ERROR
protected PaymentGatewayCheckoutService	paymentGatewayCheckoutService
protected static String	processingErrorMessage
protected PaymentGatewayWebResponsePrintService	webResponsePrintService

Constructor Summary

Constructors

Constructor and Description
PaymentGatewayAbstractController()

Method Summary

Modifier and Type	Method and Description
Long	applyPaymentToOrder(PaymentResponseDTO responseDTO)
abstract String	errorEndpoint(org.springframework.ui.Model model, javax.servlet.http.HttpServletRequest request, org.springframework.web.servlet.mvc.support.RedirectAttributes redirectAttributes, Map<String,String> pathVars)
String	getBaseConfirmationRedirect()
protected String	getCartViewRedirect()
abstract PaymentGatewayConfiguration	getConfiguration()
protected String	getConfirmationViewRedirect(String orderNumber)
protected String	getErrorViewRedirect()
abstract String	getGatewayContextKey()
String	getOrderReviewRedirect()
static String	getProcessingErrorMessage()
abstract PaymentGatewayWebResponseService	getWebResponseService()
abstract void	handleProcessingException(Exception e, org.springframework.web.servlet.mvc.support.RedirectAttributes redirectAttributes)
abstract void	handleUnsuccessfulTransaction(org.springframework.ui.Model model, org.springframework.web.servlet.mvc.support.RedirectAttributes redirectAttributes, PaymentResponseDTO responseDTO)
String	initiateCheckout(Long orderId)
String	lookupOrderNumberFromOrderId(PaymentResponseDTO responseDTO)
String	process(org.springframework.ui.Model model, javax.servlet.http.HttpServletRequest request, org.springframework.web.servlet.mvc.support.RedirectAttributes redirectAttributes) try { translate http request to DTO apply payment to order check success and validity of response if (complete checkout on callback == true) initiateCheckout(order id); else show review page; } catch (Exception e) { notify admin user of failure handle processing exception }
abstract String	returnEndpoint(org.springframework.ui.Model model, javax.servlet.http.HttpServletRequest request, org.springframework.web.servlet.mvc.support.RedirectAttributes redirectAttributes, Map<String,String> pathVars)

Methods inherited from class org.broadleafcommerce.common.web.controller.BroadleafAbstractController

addDeepLink, getContextPath, isAjaxRequest, jsonResponse

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LOG

protected static final org.apache.commons.logging.Log LOG

PAYMENT_PROCESSING_ERROR

public static final String PAYMENT_PROCESSING_ERROR

See Also:

Constant Field Values

baseRedirect

protected static String baseRedirect

baseErrorView

protected static String baseErrorView

baseOrderReviewRedirect

protected static String baseOrderReviewRedirect

baseConfirmationRedirect

protected static String baseConfirmationRedirect

baseCartRedirect

protected static String baseCartRedirect

processingErrorMessage

protected static String processingErrorMessage

paymentGatewayCheckoutService

@Autowired(required=false)
 @Qualifier(value="blPaymentGatewayCheckoutService")
protected PaymentGatewayCheckoutService paymentGatewayCheckoutService

webResponsePrintService

protected PaymentGatewayWebResponsePrintService webResponsePrintService

Constructor Detail

PaymentGatewayAbstractController

public PaymentGatewayAbstractController()

Method Detail

applyPaymentToOrder

public Long applyPaymentToOrder(PaymentResponseDTO responseDTO)
                         throws IllegalArgumentException

Throws:

IllegalArgumentException

initiateCheckout

public String initiateCheckout(Long orderId)
                        throws Exception

Throws:

Exception

lookupOrderNumberFromOrderId

public String lookupOrderNumberFromOrderId(PaymentResponseDTO responseDTO)

process

public String process(org.springframework.ui.Model model,
                      javax.servlet.http.HttpServletRequest request,
                      org.springframework.web.servlet.mvc.support.RedirectAttributes redirectAttributes)
               throws PaymentException

try { translate http request to DTO apply payment to order check success and validity of response if (complete checkout on callback == true) initiateCheckout(order id); else show review page; } catch (Exception e) { notify admin user of failure handle processing exception }

Throws:

PaymentException

handleProcessingException

public abstract void handleProcessingException(Exception e,
                                               org.springframework.web.servlet.mvc.support.RedirectAttributes redirectAttributes)
                                        throws PaymentException

Throws:

PaymentException

handleUnsuccessfulTransaction

public abstract void handleUnsuccessfulTransaction(org.springframework.ui.Model model,
                                                   org.springframework.web.servlet.mvc.support.RedirectAttributes redirectAttributes,
                                                   PaymentResponseDTO responseDTO)
                                            throws PaymentException

Throws:

PaymentException

getGatewayContextKey

public abstract String getGatewayContextKey()

getWebResponseService

public abstract PaymentGatewayWebResponseService getWebResponseService()

getConfiguration

public abstract PaymentGatewayConfiguration getConfiguration()

returnEndpoint

public abstract String returnEndpoint(org.springframework.ui.Model model,
                                      javax.servlet.http.HttpServletRequest request,
                                      org.springframework.web.servlet.mvc.support.RedirectAttributes redirectAttributes,
                                      Map<String,String> pathVars)
                               throws PaymentException

Throws:

PaymentException

errorEndpoint

public abstract String errorEndpoint(org.springframework.ui.Model model,
                                     javax.servlet.http.HttpServletRequest request,
                                     org.springframework.web.servlet.mvc.support.RedirectAttributes redirectAttributes,
                                     Map<String,String> pathVars)
                              throws PaymentException

Throws:

PaymentException

getErrorViewRedirect

protected String getErrorViewRedirect()

getCartViewRedirect

protected String getCartViewRedirect()

getOrderReviewRedirect

public String getOrderReviewRedirect()

getBaseConfirmationRedirect

public String getBaseConfirmationRedirect()

getConfirmationViewRedirect

protected String getConfirmationViewRedirect(String orderNumber)

getProcessingErrorMessage

public static String getProcessingErrorMessage()