Nortel Symposium Web Center Portal, Installation And Administration Manual, Page: 569 / 710

Installation and Administration Guide 569
July 2004 Customizing the Customer Interface
The JSP file login.jsp is an example of the usage of the Symposium Web Center
Portal business objects within the Customer Interface. This page manages the
logic for handling a user who is initiating a session by logging on to the
login.html web page. If a new user completes the details in the New User form
on login.html, the form is submitted to the server for processing by the login.jsp
with a query string parameter of “command=2” (indicating that this user is not
known to the system and must be registered).
The code begins by inspecting the “command” parameter within the HTTP
request. If it indicates a new user, then it gathers the values of the fields
submitted on the form on login.html. It starts with the user’s chosen username,
password, and e-mail address. Since the username and password must be unique
identifiers within the database, it validates them first. This is done with an
instance of the Customer business object; that instance is created in the code by
the line
Customer objCust = new Customer();
where objCust is the identifier by which it accesses the object. To be able to refer
to the Customer class in this way, the JSP page must import the Customer class
in the line of code:
<%@ page
import=”com.nortelnetworks.swcp.businessobjects.Customer"
%>
This line usually appears near the beginning of the file. In the example above,
the fully specified package name of the class within its .jar file is used.
The Customer object provides you with methods to read a customer record from
the Symposium Web Center Portal database based on a username or e-mail
address. For example, if the variable strCustEmail contains the user’s preferred
e-mail address, obtained as a parameter in the HTTP request, then you can read
the database customer record using
objCust.readByEmail(strCustEmail)
The Javadoc for this method reads as follows:
readByEmail
public boolean readByEmail (java.lang.String anEmail)