Class DefaultCheckoutWorkflow
java.lang.Object
com.broadleafcommerce.cartoperation.service.checkout.workflow.DefaultCheckoutWorkflow
- All Implemented Interfaces:
CheckoutWorkflow
- Author:
- Chris Kittrell (ckittrell)
-
Field Summary
Fields -
Constructor Summary
ConstructorsConstructorDescriptionDefaultCheckoutWorkflow(List<CheckoutWorkflowActivity> workflowActivities, CheckoutRollbackEventProducer checkoutRollbackEventProducer, CartProvider cartProvider, com.broadleafcommerce.common.extension.TypeFactory typeFactory, org.springframework.context.MessageSource messageSource) -
Method Summary
Modifier and TypeMethodDescriptionexecute(@NonNull CheckoutProcessDto processDto, @NonNull Map<String, String> securityCodes, com.broadleafcommerce.data.tracking.core.context.ContextInfo contextInfo) Method used to coordinate the execution ofCheckoutWorkflowActivities.protected CheckoutProcessDtoexecuteActivity(@NonNull CheckoutWorkflowActivity activity, @NonNull CheckoutProcessDto processDto, @NonNull Map<String, String> securityCodes, com.broadleafcommerce.data.tracking.core.context.ContextInfo contextInfo) protected CartProviderprotected CheckoutRollbackEventProducerprotected org.springframework.retry.support.RetryTemplateprotected org.springframework.context.MessageSourceprotected PaymentProvider<PaymentSummary>protected com.broadleafcommerce.common.extension.TypeFactoryprotected List<CheckoutWorkflowActivity>protected voidlogErrorInitiatingWorkflowRollback(@NonNull com.broadleafcommerce.cart.client.domain.Cart cart, @NonNull String requestId, @NonNull CheckoutWorkflowActivityException e) protected voidlogErrorInitiatingWorkflowRollback(@NonNull com.broadleafcommerce.cart.client.domain.Cart cart, @NonNull String requestId, Exception e) Log a message to record the initiation of the workflow rollbackprotected CheckoutProcessDtorecordRollbackError(@NonNull CheckoutProcessDto processDto, @NonNull Exception e, com.broadleafcommerce.data.tracking.core.context.ContextInfo contextInfo) Method responsible for recording the error that was encountered during the activity's rollback.protected CheckoutProcessDtorecordWorkflowError(@NonNull CheckoutProcessDto processDto, @NonNull CheckoutWorkflowActivityException e, com.broadleafcommerce.data.tracking.core.context.ContextInfo contextInfo) Method responsible for recording the error that was encountered during the activity's execution.rollback(@NonNull CheckoutProcessDto processDto, com.broadleafcommerce.data.tracking.core.context.ContextInfo contextInfo) Method used to coordinate the rollback of work that has been done by theCheckoutWorkflowActivitiesup to that point.voidsendCheckoutRollbackEvent(@NonNull com.broadleafcommerce.cart.client.domain.Cart cart, @NonNull String requestId, com.broadleafcommerce.data.tracking.core.context.ContextInfo contextInfo) Send a message to notify external services (and internal listeners) of the checkout workflow rollback, so that they can react accordingly.voidsetMessageRetryTemplate(org.springframework.retry.support.RetryTemplate messageRetryTemplate) voidsetPaymentProvider(PaymentProvider<PaymentSummary> paymentProvider) protected voidunlockPayments(@NonNull CheckoutProcessDto processDto, com.broadleafcommerce.data.tracking.core.context.ContextInfo contextInfo)
-
Field Details
-
CHECKOUT_WORKFLOW_ERRORS
- See Also:
-
CHECKOUT_WORKFLOW_ROLLBACK_ERRORS
- See Also:
-
-
Constructor Details
-
DefaultCheckoutWorkflow
public DefaultCheckoutWorkflow(List<CheckoutWorkflowActivity> workflowActivities, CheckoutRollbackEventProducer checkoutRollbackEventProducer, CartProvider cartProvider, com.broadleafcommerce.common.extension.TypeFactory typeFactory, org.springframework.context.MessageSource messageSource)
-
-
Method Details
-
execute
public CheckoutProcessDto execute(@NonNull @NonNull CheckoutProcessDto processDto, @NonNull @NonNull Map<String, String> securityCodes, @Nullable com.broadleafcommerce.data.tracking.core.context.ContextInfo contextInfo) Description copied from interface:CheckoutWorkflowMethod used to coordinate the execution ofCheckoutWorkflowActivities. If there is an exception/error during the execution of those activities, thenCheckoutWorkflow.rollback(CheckoutProcessDto, ContextInfo)should be called to un-do the work that had been done up to the point of the exception/error.- Specified by:
executein interfaceCheckoutWorkflow- Parameters:
processDto- TheCheckoutProcessDtothat we're attempting to checkout with.securityCodes- Secure codes that are passed to the gateway for verification during authorization or capture transactions.contextInfo- Context information around sandbox and multitenant state.- Returns:
- The final state of the
CheckoutProcessDtofollowing the execution of the workflow.
-
unlockPayments
protected void unlockPayments(@NonNull @NonNull CheckoutProcessDto processDto, @Nullable com.broadleafcommerce.data.tracking.core.context.ContextInfo contextInfo) -
rollback
public CheckoutProcessDto rollback(@NonNull @NonNull CheckoutProcessDto processDto, @Nullable com.broadleafcommerce.data.tracking.core.context.ContextInfo contextInfo) Description copied from interface:CheckoutWorkflowMethod used to coordinate the rollback of work that has been done by theCheckoutWorkflowActivitiesup to that point.- Specified by:
rollbackin interfaceCheckoutWorkflow- Parameters:
processDto- TheCheckoutProcessDtothat we were attempting to checkout with, but ran into an exception/error.contextInfo- Context information around sandbox and multitenant state.- Returns:
- The final state of the
CheckoutProcessDtofollowing the execution of the workflow rollback.
-
sendCheckoutRollbackEvent
public void sendCheckoutRollbackEvent(@NonNull @NonNull com.broadleafcommerce.cart.client.domain.Cart cart, @NonNull @NonNull String requestId, @Nullable com.broadleafcommerce.data.tracking.core.context.ContextInfo contextInfo) Description copied from interface:CheckoutWorkflowSend a message to notify external services (and internal listeners) of the checkout workflow rollback, so that they can react accordingly.- Specified by:
sendCheckoutRollbackEventin interfaceCheckoutWorkflow- Parameters:
cart- The cart that is being rolled back.requestId- The checkout request idcontextInfo- Context information around sandbox and multitenant state.
-
logErrorInitiatingWorkflowRollback
protected void logErrorInitiatingWorkflowRollback(@NonNull @NonNull com.broadleafcommerce.cart.client.domain.Cart cart, @NonNull @NonNull String requestId, Exception e) Log a message to record the initiation of the workflow rollback- Parameters:
cart- The cart that is being acted upon in this workflowrequestId- The id used to identify changes tied to the specific execution requeste- The exception thrown by theCheckoutWorkflowActivity
-
executeActivity
protected CheckoutProcessDto executeActivity(@NonNull @NonNull CheckoutWorkflowActivity activity, @NonNull @NonNull CheckoutProcessDto processDto, @NonNull @NonNull Map<String, String> securityCodes, @Nullable com.broadleafcommerce.data.tracking.core.context.ContextInfo contextInfo) -
logErrorInitiatingWorkflowRollback
protected void logErrorInitiatingWorkflowRollback(@NonNull @NonNull com.broadleafcommerce.cart.client.domain.Cart cart, @NonNull @NonNull String requestId, @NonNull @NonNull CheckoutWorkflowActivityException e) -
recordWorkflowError
protected CheckoutProcessDto recordWorkflowError(@NonNull @NonNull CheckoutProcessDto processDto, @NonNull @NonNull CheckoutWorkflowActivityException e, @Nullable com.broadleafcommerce.data.tracking.core.context.ContextInfo contextInfo) Method responsible for recording the error that was encountered during the activity's execution.- Parameters:
processDto- TheCheckoutProcessDtothat is being acted upon in this workflowe- The exception thrown by theCheckoutWorkflowActivitycontextInfo- Context information around sandbox and multitenant state.- Returns:
- The cart including the recorded activity execution state
-
recordRollbackError
protected CheckoutProcessDto recordRollbackError(@NonNull @NonNull CheckoutProcessDto processDto, @NonNull @NonNull Exception e, @Nullable com.broadleafcommerce.data.tracking.core.context.ContextInfo contextInfo) Method responsible for recording the error that was encountered during the activity's rollback.- Parameters:
processDto- TheCheckoutProcessDtothat encountered an error during the execution of this activitye- The exception that was encounteredcontextInfo- Context information around sandbox and multitenant state.- Returns:
- The
CheckoutProcessDtoincluding the recorded activity rollback state
-
getWorkflowActivities
-
getCheckoutRollbackEventProducer
-
getCartProvider
-
getTypeFactory
protected com.broadleafcommerce.common.extension.TypeFactory getTypeFactory() -
getMessageSource
protected org.springframework.context.MessageSource getMessageSource() -
setPaymentProvider
-
getPaymentProvider
-
setMessageRetryTemplate
@Autowired @Qualifier("checkoutWorkflowRollbackMessageRetryTemplate") public void setMessageRetryTemplate(org.springframework.retry.support.RetryTemplate messageRetryTemplate) -
getMessageRetryTemplate
protected org.springframework.retry.support.RetryTemplate getMessageRetryTemplate()
-