1 /*
2 * $Source: /usr/cvsroot/MelatiShopping/src/main/java/org/paneris/melati/shopping/DefaultShoppingTrolley.java,v $
3 * $Revision: 1.12 $
4 *
5 * Copyright (C) 2000 Tim Joyce
6 *
7 * Part of Melati (http://melati.org/ ), a framework for the rapid
8 * development of clean, maintainable web applications.
9 *
10 * Melati is free software; Permission is granted to copy, distribute
11 * and/or modify this software under the terms either:
12 *
13 * a) the GNU General Public License as published by the Free Software
14 * Foundation; either version 2 of the License, or (at your option)
15 * any later version,
16 *
17 * or
18 *
19 * b) any version of the Melati Software License, as published
20 * at http://melati.org
21 *
22 * You should have received a copy of the GNU General Public License and
23 * the Melati Software License along with this program;
24 * if not, write to the Free Software Foundation, Inc.,
25 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA to obtain the
26 * GNU General Public License and visit http://melati.org to obtain the
27 * Melati Software License.
28 *
29 * Feel free to contact the Developers of Melati if you would like
30 * to work out a different arrangement than the options
31 * outlined here. It is our intention to allow Melati to be used by as
32 * wide an audience as possible.
33 *
34 * This program is distributed in the hope that it will be useful,
35 * but WITHOUT ANY WARRANTY; without even the implied warranty of
36 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
37 * GNU General Public License for more details.
38 *
39 * Contact details for copyright holder:
40 *
41 * Tim Joyce <timj@paneris.org>
42 * http://paneris.org/~timj/
43 * 68 Sandbanks Rd, Poole, Dorset. BH14 8BY. UK
44 */
45
46 package org.paneris.melati.shopping;
47
48 import org.melati.Melati;
49 import java.util.Locale;
50
51 /**
52 * <p> A Shopping Trolley stores information in the user's Shopping Trolley.<p>
53 * <p> It does this by storing itself in the session.</p>
54 * <p> For this reason, the constructors are private, and you will be expected
55 * always to get the Shopping Trolley using getInstance();</p>
56 *
57 * usage example:
58 *
59 * ShoppingTrolley trolley = ShoppingTrolley.getInstance(Melati melati);
60 * context.put("trolley", trolley);
61 *
62 **/
63
64 public class DefaultShoppingTrolley extends ShoppingTrolley {
65
66 /**
67 * Set the Locale for this trolley.
68 */
69 public Locale getLocale(){
70 return Locale.UK;
71 }
72
73 /**
74 * Load a trolley from something persistent.
75 */
76 public void load(Integer id) {
77 }
78
79 /**
80 * Save a trolley to something persistent.
81 */
82 public void save() {
83 }
84
85 /**
86 * Set the user's detault details into this trolley.
87 * This is useful if users have already logged in,
88 * and we don't want them to reenter their details.
89 */
90 public void setDefaultDetails(Melati melati) {
91 }
92
93 /**
94 * Do something to force users to login.
95 * You should throw an access poem exception in order to
96 * generate the login page.
97 */
98 public void assertLogin(Melati melatiIn) {
99 }
100
101 /**
102 * Provide a mechanism for working out if
103 * this order should include a delivery charge.
104 */
105 public boolean hasDelivery(){
106 return false;
107 }
108
109 /**
110 * You need to provide some mechanism for calculating the delivery
111 * value for the order (item delivery values are calculated individually.
112 */
113 public double getDeliveryValue() {
114 return 0;
115 }
116
117
118 /**
119 * Provide a mechanism for working out if
120 * this order should include a discount.
121 */
122 public boolean hasDiscount() {
123 return false;
124 }
125
126 /**
127 * If you want to apply a discount to this order, do it here.
128 */
129 public double getDiscountRate() {
130 return 0;
131 }
132
133 /**
134 * Provide a mechanism for working out whether
135 * this order should include VAT (default should be true).
136 */
137 public boolean hasVAT() {
138 return true;
139 }
140
141 /**
142 * A call back point for the payment server.
143 */
144 public void confirmPayment(Melati melatiIn) {
145 }
146
147 }
148