One of the most important lessons for an Internet retailer is to ensure that the online buying experience is as easy and as enjoyable for the customer as possible. It is essential that the customer feels in control of the situation and is informed and reassured every step of way. A customer who cannot easily retrace his or her steps, change or cancel their order, or is confused or uncertain as to what is happening before, during and after a transaction, is unlikely to return, or to recommend the site to their friends and colleagues.
A frequent feature of on-line ordering is an acknowledgement e-mail sent to the customer to reassure them that the order has been successfully placed, and is being dealt with; this technique is used to good effect on such sites as Amazon, with its instant order acknowledgement.
We will now look at an example of such a situation, and the code needed to ensure that a customer receives an e-mail thanking them for their order, and confirming both the goods ordered and the price ordered at, within minutes (if not seconds) of placing their order.
This example uses a Java servlet to send an automatic e-mail, acknowledging an order placed from a WAP device. But first we will take a look at the WML deck from which the order is made.
The card resulting from the code below is displayed just prior to an order being placed on our imaginary system. The customer is asked to enter his or her e-mail address and can then click to place the order:
<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
<card id="OrderConfirmation" title="Place Order">
<p>
E-mail:<input name="email" maxlength="100" />
<br/>
<anchor>Place Order!
<go href=" http://localhost/servlet/WAPOrderConfirmationEmail"
method="post">
<postfield name="email" value="$email"/>
</go>
</anchor>
</p>
</card>
</wml>
|
Using the emulator supplied by Phone.com, the WML page above is displayed in quite a primitive way. Input of information is via the phone's keypad, and the input box and "Place Order!" link are displayed on separate screens: |
|
|
We first type in the e-mail address to which the acknowledgement is to be sent. Pressing the OK button enables us to then proceed to the next screen, where we can confirm the order by selecting the Place Order! option: |
|
The Java servlet, WAPOrderConfirmation, which is invoked by the WML page above, takes the user's e-mail address and sends a simple response. In the real world Wireless Transaction Layer Security (WTLS) would be used to secure this order – especially if details such as credit card numbers were being transmitted – however, for the purposes of the example, we will ignore security requirements here. (Note that security is covered in detail in Chapter 16.)
Let's plunge straight into the code; the relevant lines will be explained afterwards.
import java.io.IOException;
import java.util.Properties;
import javax.mail.*;
import javax.mail.internet.*;
import javax.servlet.*;
import javax.servlet.http.*;
import com.wrox.util.WML;
public class WAPOrderConfirmation extends HttpServlet {
public void doPost (HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
String host = "smtp.yourISP.net";
String from = "orders@machincorp.co.uk";
String to = request.getParameter("email");
String subject = "Your order with Machin Corp International";
StringBuffer text = new StringBuffer();
text.append("Thank you for ordering from MachinCorp International");
text.append("\n\n");
text.append("If you need to get in touch with us about your order ");
text.append("please send an e-mail message to orders@machincorp.co.uk ");
text.append("(or just reply to this message)");
text.append("\n\n");
text.append("Please note that you can view the status of your account and ");
text.append("orders, cancel undispatched orders, and change the ");
text.append("delivery or invoice information for undispatched orders at ");
text.append("any time through the \"My Account\" link in the side ");
text.append("panel of our Web site.");
text.append("\n\n");
text.append("MachinCorp.co.uk Customer Service");
text.append("\n\n");
text.append("orders@machincorp.co.uk \t http://www.machincorp.co.uk");
try {
//Get system properties
Properties props = System.getProperties();
//Setup mail server
props.put("mail.smtp.host", host);
//Get session
Session session = Session.getInstance(props, null);
session.setDebug(false);
//Define message
MimeMessage message = new MimeMessage(session);
message.setFrom(new InternetAddress(from));
message.addRecipient(Message.RecipientType.TO, new InternetAddress(to));
message.setSubject(subject);
message.setText(text.toString());
//send message
Transport.send(message);
WML wml = new WML();
wml.addCard("OrderSent", "Order Sent");
wml.println("<p align=\"center\">" +
"Thank you for your order! " +
"</p>");
wml.endCard();
wml.outputWML(response, false);
}catch (Exception e) {
e.printStackTrace();
}
}
}
The first part of the above code is simply involved in setting up all the text for the e-mail to be sent. The important JavaMail section of this code occupies less than a dozen lines of code. Considering what this code is actually doing, this is really quite remarkable!
Essentially there are three steps to the process of composing and sending an email using JavaMail:
1. Create a valid mail session
2. Create a message object
3. Send the message object
java.lang.Properties are used throughout the JavaMail API to provide a mechanism to control the behavior of many methods:
//Get system properties
Properties props = System.getProperties();
//Setup mail server
props.put("mail.smtp.host", host);
The first step in sending an e-mail is to instantiate a Session object.
//Get session
Session session = Session.getInstance(props, null);
session.setDebug(false);
At the core of sending mail is the creation of a MIME message object:
//Define message
MimeMessage message = new MimeMessage(session);
message.setFrom(new InternetAddress(from));
message.addRecipient(Message.RecipientType.TO, new InternetAddress(to));
message.setSubject(subject);
message.setText(text.toString());
We may then use the send() method of the Transport class, passing in this message object. This brevity in the send() is possible because we have specified the SMTP host in the session using the Properties object as shown above:
//send message
Transport.send(message);
|
Once the order confirmation e-mail is sent to the specified address, a quick WML response is sent back to the device. The final part of the code simply uses the WML class we saw earlier to generate the WML, which is shown here: |
|
In the example given above, we have seen how to use JavaMail to send e-mail messages. We will now outline the other core operations of a mail system:
q Viewing lists of mail messages
q Reading specific messages
q Dealing with the capabilities of the device, and MIME types
q Deleting mail from a mail folder
Once we have discussed how to incorporate this essential functionality of e-mail within WAP applications, we can move on to our second WAP example, WAPMail, which will incorporate all of these features into a primitive, but functional e-mail system.
Unlike the more advanced IMAP4 protocol, POP3 only
