com.softslate.commerce.businessobjects.core
Interface User

All Superinterfaces:

BusinessObject

All Known Implementing Classes:

UserBean

public interface User
extends BusinessObject

Interface representing an end user accessing the system. In particular, either a customer using the user interface to shop for and purchase products or an administrator configuring the store's administrative settings.

An instance implementing User is created on the first request of a user's session and is stored along with that session for as long as the user continues to access the application. It is stored as a session attribute named "user".

When the application needs to create an instance that implements User, BusinessObjectFactory finds the name of the Java class to instantiate from the "userImplementer" setting in the appComponents.properties file.

The default "userImplementer" is UserBean.

Author:

David Tobey

getLocale

java.util.Locale getLocale()

Retrieves the Locale in effect for this User. Useful to assist with the formatting of currencies and other localizations.

Returns:

The Locale in effect for this User.

setLocale

void setLocale(java.util.Locale locale)

Sets the Locale in effect for this User. This Locale is set in the Struts layer directly after a User object is created in each user's session.

getOrder

Order getOrder()

Retrieves the Order this User is currently placing. This Order object is created when the user adds the first item to his or her cart. It is destroyed either when the user completes the order, or when his or her session ends.

Returns:

The Order this User is currently placing.

setOrder

void setOrder(Order order)

Sets the Order this User is currently placing. This Order object is created when the user adds the first item to his or her cart. It is destroyed either when the user completes the order, or when his or her session ends.

Parameters:

order - The Order this User is currently placing.

getCustomer

Customer getCustomer()

Retrieves the Customer object associated with this User. When a user logs in as a customer, this Customer object is created to store his or her account settings and other information.

Returns:

The Customer object associated with this User, or null, if the user has not logged in.

setCustomer

void setCustomer(Customer customer)

Sets the Customer object associated with this User. When a user logs in as a customer, this Customer object is created to store his or her account settings and other information.

Parameters:

customer - The Customer object associated with this User.

getEnteredCouponCodes

java.util.Collection getEnteredCouponCodes()

Retrieves a Collection of Strings representing coupon codes entered by this User. When a user enters a coupon code at any point in the session, the code gets stored here for retrieval during discount processing.

Returns:

A Collection of Strings representing coupon codes entered by this User.

setEnteredCouponCodes

void setEnteredCouponCodes(java.util.Collection enteredCouponCodes)

Sets the Collection of coupon codes entered by this User. When a user enters a valid coupon code, the code gets stored here for later retrieval during discount processing.

Parameters:

enteredCouponCodes - A Collection of Strings representing coupon codes entered by this User.

getAdministrator

Administrator getAdministrator()

Retrieves the Administrator object associated with this User. When a user logs in as an administrator, this Administrator object is created to store his or her account settings and other information.

Returns:

The Administrator object associated with this User, or null, if the user has not logged in.

setAdministrator

void setAdministrator(Administrator administrator)

Sets the Administrator object associated with this User. When a user logs in as an administrator, this Administrator object is created to store his or her account settings and other information.

Parameters:

administrator - The Administrator object associated with this User.

getCustomMap

java.util.Map getCustomMap()

Returns a Map of any custom objects saved for this User. Custom developers may place objects in the map which need to be stored with the user throughout his session.

Returns:

A Map of custom objects saved for this User.

setCustomMap

void setCustomMap(java.util.Map data)

Sets the Map of custom objects for this User. Custom developers may place objects in the map which need to be stored with the user throughout his session.

Parameters:

data - A Map of custom objects saved for this User