com.broadleafcommerce.rest.api.exception

Class BroadleafWebServicesException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.broadleafcommerce.rest.api.exception.BroadleafWebServicesException

All Implemented Interfaces:

Serializable

public class BroadleafWebServicesException
extends RuntimeException

The purpose of this is to allow REST endpoints to build an exception with

Author:

Kelly Tisdell

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static String	CART_CUSTOMER_MISMATCH
static String	CART_ITEM_NOT_FOUND
static String	CART_NOT_FOUND
static String	CART_PRICING_ERROR
static String	CATEGORY_NOT_FOUND
static String	CHECKOUT_PROCESSING_ERROR
static String	CONTENT_TYPE_NOT_SUPPORTED
static String	CUSTOMER_ADDRESS_NOT_FOUND
static String	CUSTOMER_EMAIL_NOT_FOUND
static String	CUSTOMER_NOT_FOUND
static String	CUSTOMER_PAYMENT_NOT_FOUND
static String	CUSTOMER_PAYMENT_ORDER_MISMATCH
static String	FULFILLMENT_GROUP_NOT_FOUND
static String	FULFILLMENT_OPTION_NOT_FOUND
protected int	httpStatusCode
static String	INVALID_ADD_TO_CART_REQUEST
static String	INVALID_CATEGORY_ID
static String	INVALID_CUSTOMER_FOR_PAYMENT
static String	INVALID_FULFILLMENT_GROUP_FOR_ORDER
static String	INVALID_ORDER_PAYMENT_FOR_ORDER
protected Locale	locale
protected Map<String,Object[]>	messages
static String	METHOD_NOT_SUPPORTED
static String	MISSING_ITEM_NAME
static String	NOT_FOUND
static String	ORDER_PAYMENT_NOT_FOUND
static String	PRODUCT_NOT_FOUND
static String	PROMO_CODE_ALREADY_ADDED
static String	PROMO_CODE_EXPIRED
static String	PROMO_CODE_INVALID
static String	PROMO_CODE_MAX_USAGES
static String	QUERY_PARAMETER_NOT_PRESENT
static String	SEARCH_ERROR
static String	SEARCH_QUERY_EMPTY
static String	SEARCH_QUERY_MALFORMED
static String	SKU_NOT_FOUND
protected Map<String,String>	translatedMessages
static String	UNKNOWN_ERROR
static String	UPDATE_CART_ERROR

Constructor Summary

Constructors

Constructor and Description
BroadleafWebServicesException(int httpStatusCode, Locale locale, Map<String,Object[]> messages, Throwable cause)

Method Summary

Modifier and Type	Method and Description
BroadleafWebServicesException	addMessage(String key) Convenience method for adding a message with no parameters
BroadleafWebServicesException	addMessage(String key, Object param) Convenience method for adding a message with a single parameter
BroadleafWebServicesException	addMessage(String key, Object[] params) Convenience mentod for adding a message with multiple parameters
BroadleafWebServicesException	addTranslatedMessage(String key, String message) Adds a translated message.
static BroadleafWebServicesException	build(int httpStatusCode)
static BroadleafWebServicesException	build(int httpStatusCode, Locale locale)
static BroadleafWebServicesException	build(int httpStatusCode, Locale locale, Map<String,Object[]> messages)
static BroadleafWebServicesException	build(int httpStatusCode, Locale locale, Map<String,Object[]> messages, Throwable cause)
static BroadleafWebServicesException	build(int httpStatusCode, Locale locale, Throwable t)
static BroadleafWebServicesException	build(int httpStatusCode, Throwable t)
int	getHttpStatusCode() Returns the intended HTTP status code (e.g.
Locale	getLocale() Returns the java.util.Locale that messages should be formatted in.
Map<String,Object[]>	getMessages() Gets a map of message keys and object arrays.
Map<String,String>	getTranslatedMessages() Gets a map of messages that have already been translated.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Field Detail

UNKNOWN_ERROR

public static final String UNKNOWN_ERROR

See Also:

Constant Field Values

NOT_FOUND

public static final String NOT_FOUND

See Also:

Constant Field Values

PRODUCT_NOT_FOUND

public static final String PRODUCT_NOT_FOUND

See Also:

Constant Field Values

CATEGORY_NOT_FOUND

public static final String CATEGORY_NOT_FOUND

See Also:

Constant Field Values

SKU_NOT_FOUND

public static final String SKU_NOT_FOUND

See Also:

Constant Field Values

SEARCH_ERROR

public static final String SEARCH_ERROR

See Also:

Constant Field Values

SEARCH_QUERY_EMPTY

public static final String SEARCH_QUERY_EMPTY

See Also:

Constant Field Values

SEARCH_QUERY_MALFORMED

public static final String SEARCH_QUERY_MALFORMED

See Also:

Constant Field Values

INVALID_CATEGORY_ID

public static final String INVALID_CATEGORY_ID

See Also:

Constant Field Values

CART_NOT_FOUND

public static final String CART_NOT_FOUND

See Also:

Constant Field Values

CART_CUSTOMER_MISMATCH

public static final String CART_CUSTOMER_MISMATCH

See Also:

Constant Field Values

CART_ITEM_NOT_FOUND

public static final String CART_ITEM_NOT_FOUND

See Also:

Constant Field Values

CART_PRICING_ERROR

public static final String CART_PRICING_ERROR

See Also:

Constant Field Values

UPDATE_CART_ERROR

public static final String UPDATE_CART_ERROR

See Also:

Constant Field Values

PROMO_CODE_MAX_USAGES

public static final String PROMO_CODE_MAX_USAGES

See Also:

Constant Field Values

PROMO_CODE_INVALID

public static final String PROMO_CODE_INVALID

See Also:

Constant Field Values

PROMO_CODE_EXPIRED

public static final String PROMO_CODE_EXPIRED

See Also:

Constant Field Values

PROMO_CODE_ALREADY_ADDED

public static final String PROMO_CODE_ALREADY_ADDED

See Also:

Constant Field Values

FULFILLMENT_GROUP_NOT_FOUND

public static final String FULFILLMENT_GROUP_NOT_FOUND

See Also:

Constant Field Values

FULFILLMENT_OPTION_NOT_FOUND

public static final String FULFILLMENT_OPTION_NOT_FOUND

See Also:

Constant Field Values

CUSTOMER_NOT_FOUND

public static final String CUSTOMER_NOT_FOUND

See Also:

Constant Field Values

CUSTOMER_EMAIL_NOT_FOUND

public static final String CUSTOMER_EMAIL_NOT_FOUND

See Also:

Constant Field Values

CUSTOMER_ADDRESS_NOT_FOUND

public static final String CUSTOMER_ADDRESS_NOT_FOUND

See Also:

Constant Field Values

CHECKOUT_PROCESSING_ERROR

public static final String CHECKOUT_PROCESSING_ERROR

See Also:

Constant Field Values

CONTENT_TYPE_NOT_SUPPORTED

public static final String CONTENT_TYPE_NOT_SUPPORTED

See Also:

Constant Field Values

METHOD_NOT_SUPPORTED

public static final String METHOD_NOT_SUPPORTED

See Also:

Constant Field Values

QUERY_PARAMETER_NOT_PRESENT

public static final String QUERY_PARAMETER_NOT_PRESENT

See Also:

Constant Field Values

CUSTOMER_PAYMENT_NOT_FOUND

public static final String CUSTOMER_PAYMENT_NOT_FOUND

See Also:

Constant Field Values

INVALID_CUSTOMER_FOR_PAYMENT

public static final String INVALID_CUSTOMER_FOR_PAYMENT

See Also:

Constant Field Values

INVALID_ADD_TO_CART_REQUEST

public static final String INVALID_ADD_TO_CART_REQUEST

See Also:

Constant Field Values

MISSING_ITEM_NAME

public static final String MISSING_ITEM_NAME

See Also:

Constant Field Values

CUSTOMER_PAYMENT_ORDER_MISMATCH

public static final String CUSTOMER_PAYMENT_ORDER_MISMATCH

See Also:

Constant Field Values

ORDER_PAYMENT_NOT_FOUND

public static final String ORDER_PAYMENT_NOT_FOUND

See Also:

Constant Field Values

INVALID_ORDER_PAYMENT_FOR_ORDER

public static final String INVALID_ORDER_PAYMENT_FOR_ORDER

See Also:

Constant Field Values

INVALID_FULFILLMENT_GROUP_FOR_ORDER

public static final String INVALID_FULFILLMENT_GROUP_FOR_ORDER

See Also:

Constant Field Values

httpStatusCode

protected int httpStatusCode

messages

protected Map<String,Object[]> messages

translatedMessages

protected Map<String,String> translatedMessages

locale

protected Locale locale

Constructor Detail

BroadleafWebServicesException

public BroadleafWebServicesException(int httpStatusCode,
                                     Locale locale,
                                     Map<String,Object[]> messages,
                                     Throwable cause)

Method Detail

build

public static BroadleafWebServicesException build(int httpStatusCode)

build

public static BroadleafWebServicesException build(int httpStatusCode,
                                                  Throwable t)

build

public static BroadleafWebServicesException build(int httpStatusCode,
                                                  Locale locale)

build

public static BroadleafWebServicesException build(int httpStatusCode,
                                                  Locale locale,
                                                  Throwable t)

build

public static BroadleafWebServicesException build(int httpStatusCode,
                                                  Locale locale,
                                                  Map<String,Object[]> messages)

build

public static BroadleafWebServicesException build(int httpStatusCode,
                                                  Locale locale,
                                                  Map<String,Object[]> messages,
                                                  Throwable cause)

getHttpStatusCode

public int getHttpStatusCode()

Returns the intended HTTP status code (e.g. 400, 403, 404, 500, etc...). Default is 500.

Returns:

getMessages

public Map<String,Object[]> getMessages()

Gets a map of message keys and object arrays. These will generally be used to build a an internationalized message in the response. The map key is typically going to be a message bundle key, and the object array provides parameters for the message. For more information, see Spring's org.springframework.context.MessageSource.

Returns:

getTranslatedMessages

public Map<String,String> getTranslatedMessages()

Gets a map of messages that have already been translated. BLC provides a number of translation mechanisms for entities in the DB.

Returns:

addTranslatedMessage

public BroadleafWebServicesException addTranslatedMessage(String key,
                                                          String message)

Adds a translated message. The assumption is that the message added to this map does not need to be translated or internationalized any further. It is already translated according to the user's Locale.

Parameters:

key -

message -

Returns:

addMessage

public BroadleafWebServicesException addMessage(String key)

Convenience method for adding a message with no parameters

Parameters:

key -

Returns:

addMessage

public BroadleafWebServicesException addMessage(String key,
                                                Object param)

Convenience method for adding a message with a single parameter

Parameters:

key -

param -

Returns:

addMessage

public BroadleafWebServicesException addMessage(String key,
                                                Object[] params)

Convenience mentod for adding a message with multiple parameters

Parameters:

key -

params -

Returns:

getLocale

public Locale getLocale()

Returns the java.util.Locale that messages should be formatted in.

Returns: