There are a number of login options that can be customized. Before you begin to customize these options, it is best to understand
the login process:
|
1. |
The web browser makes a call to http://[tomcat-url]/BlueZone/. |
|
2. |
The servlet container (Tomcat) checks the web.xml file to check the <welcome-file-list> node. By default, the <welcome-file-list> node lists redirect.jsp as the top welcome file. |
|
3. |
The servlet container then sends to call to the file at [tomcat]/webapps/BlueZone/redirect.jsp for processing. |
|
4. |
By default, redirect.jsp redirects the browser to call signon.bz. |
|
5. |
signon.bz is a virtual file. All calls to *.bz are handled by the Spring UrlFilenameViewController named urlToFileController. This controller is defined in dispatcher-servlet.xml and it maps calls from *.bz to *.jsp within the [tomcat]/webapps/BlueZone/WEB-INF/jsp/ folder. Thus, the call to http://[tomcat-url]/BlueZone/signon.bz is processed by the physical file [tomcat]/webapps/BlueZone/WEB-INF/jsp/signon.jsp. |
|
6. |
signon.jsp displays the sign on screen back to the browser. |
|
7. |
The user enters a user ID and password and submits the form to login.html. |
|
8. |
login.html is a virtual file. All calls to login.html are handled by the LoginController defined in dispatcher-servlet.xml. |
|
9. |
The LoginController processes the user ID and password. If the authentication succeeds, then by default it sends the call to splitter.bz. If the authentication fails, is sends the call to msg-loginFailed.html. Refer to LoginController for more information. |
|
10. |
splitter.bz is a virtual file, backed by the physical file splitter.jsp. By default, the splitter checks the users session object for the BzW2hUserDataRow object. It calls BzW2hUserDataRow.getUserSite() and BzW2hUserDataRow.getUserPage(), builds the URL to the BlueZone launch page, and then forwards the user to that page, from which the BlueZone emulator is
actually launched. |
The purpose of this complete description of the login process is to make you aware of all the points in the process where
the process can be modified to customize the log in. These points are:
|
|
<welcome-file-list> node |
The three primary points to modify are: