Contents

Contents

About This Guide

Audience For This Guide
Organization of This Guide
Documentation Conventions

General Conventions

Other Documentation Resources

The Sun ONE Web Services Platform Developer Edition Documentation Set

Using the Documentation
Technical Support

Logistics Sample Application: Overview

Overview
Components of the Logistics Sample Application

Cargo Line Co.
Insurance Agency
Transport Agency

Sun ONE in the Logistics Sample Application

Logistics Sample Application: Design

Design Philosophy
Architecture Overview
Detailed Design of Logistics

Cargo Line Administration Module

Overview

Cargo Line Order Center Module

Overview
Design

Cargo Line Web Services Module
Insurance Agency

Insurance Agency Client
Message Queue

Database Schema

Cargo Line Database Schema

Packaging and Deployment

EJB Module
Web Modules
Deploy Application

Directory Structure

Cargo Line Co.
Insurance Co

User Profile and Access Control Management

Authentication and Authorization
User Profile Management

Internationalization
Screen Flow Diagrams

Logistics Sample Application: Deploy and Run

Overview
Setting Up the Environment

Set Environment Variables
Start the Servers
Configure the Sun ONE Studio Software
Start the Database Instance

Setting Up the Logistics Configuration Files

common.properties File
ia.properties File
config.xml File
dtd.properties File
Other Web Properties Files

Creating Resources for Logistics

Using Ant Build Scripts
Creating Resources Manually

Set Up the Databases
Create LDAP Data
Configure DSAME
Copy the DTD File in the Sun ONE Application Server
Edit the AMAgent.properties File
Create the JDBC Connection Pool (cargoline-pool, ordercenter-pool)
Create JDBC Resources (jdbc/cargoline, jdbc/ordercenter)
Create a Persistent Manager
Set Up the Message Queue

Quick Install - The Install Scripts and the Ant Targets

Install Scripts
Build Files and Ant Targets
Using Ant Through the Command Line

Sun ONE Studio Experience: Compiling, Assembling, and Deploying the Logistics Sample Application

Mounting the File Systems

Additional JAR Files

Compiling, Packaging, and Deploying via the Sun ONE Studio Software

Core Backend EJB Module
Packaging Common Components
Cargo Line Administration Web Module
Cargo Line Customer Ordering System or Order Center
Cargo Line Web Services
Insurance Client

Running Logistics

Run the Cargo Line Administrator Interface
Run the Cargo Line Consumer Interface
Run Insurance Client

Start the JMS Listener From the Command Line
Start the JMS Listener Via the Sun ONE Studio Software
Start the Insurance Client

Uninstalling
Setting Up the Logistics Sample Application in a Multi-Machine Environment

Using the Install Scripts

Server Side
Client Side

Setting Up Manually

Exception

Logistics Sample Application: Customize

Overview
Customizing the Cargo Line Administration Module

Add a New JSP Page
Modify the mapping.properties File
Modify shipmentList.jsp
Modify ShipmentHandler.java
Modify ShipmentFacade.java and ShipmentFacadeBean.java
Build and Deploy

Customizing the Order Center Module

Create Register Customer Page
Build and Deploy

Logistics Sample Application: Sample Data

Sample Data in Logistics

Ports

Routes
Ships
Voyages
Users

Routing Algorithm

Logistics Sample Application: Internationalization

Getting the User Locale
Displaying Locale Specific Pages on the Browser
Handling Error/Information Messages
Date Formatting, Number Formatting, and Currency Formatting

My Sun ONE Benefits Portal Sample Application

Overview
Display Profile Design
Channel Design

Employee Tab

Employee Role Channels
Employer Role Channels

401(K) Tab

Employee Role Channels
Employer Role Channels

ESPP Tab

Employee Role Channels
Employer Role Channels

Install Design
Database

Customer Order Tracking System (COTS) Sample Application

Overview
Multi-Tier Application

EIS Tier
Middle Tier
Client Tier

Dining Guide Sample Application

Overview

Parts Supplier Sample Application

Overview

Stock Ticker Sample Application

Sun ONE Portal Server
Sun ONE Portlet Builder
Stock Ticker Sample Application

Other Sample Applications in Point Products

Samples in Point Products
Sun ONE Application Server

Sun ONE Application Server 7: Index of Sample Applications

Sun ONE Identity Server
Sun ONE Portal Server
Sun ONE Studio update 1, Enterprise Edition for Java
Sun ONE Web Services Platform Developer Edition

Troubleshooting

Troubleshooting
Known Issues

High Level Targets

Index