Sun Java System Portal Server Mobile Access 7.1 Developer's Guide (formerly SunTM ONE Portal Server 7.1, Mobile Access) software is an extension to Sun Java System Portal Server 7.1 (formerly Sun ONE Portal Server 7.1) software that enables users to access portal services from mobile devices such as cellular phones and PDAs.
Mobile Access ships with three mobile applications: Calendar, Address Book, and Mail, all of which can be fully customized by developers.
The three mobile applications are based on JavaServerTM Pages (JSPTM) technology and make extensive use of custom tag libraries that implement their behavior. Each tag library is customizable through a corresponding set of APIs written in the JavaTM programming language.
In addition, Mobile Access software supports voice accessibility, which allows you to write and use applications that respond directly to voice commands.
This preface includes the following sections:
This guide is intended for developers who want to:
Gain a developers perspective of the mobile address book, calendar, and mail applications
Create voice-enabled applications accessible from any telephone
Change the default behavior of the application-specific tag libraries provided in this release
Customize or extend the Portal Desktop for mobile devices
Deploy online help for the mobile Portal Desktop
What you need to know will vary with the characteristics of your site. Knowledge of the following is recommended:
Sun Java Enterprise System 2005Q4
Sun Java System Portal Server 7.1 software
Sun Java System Portal Server SRA 7.1 software (formerly Sun ONE Portal Server 7.1 Secure Remote Access software)
Sun Java System Identity Server 6 2005Q4 software (formerly Sun ONE Identity Server software)
Sun Java System Directory Server 5.2 software (formerly Sun ONE Directory Server software)
Sun Java System Application Server Standard Edition 7 Update 3 software (also known as Sun ONE Application Server 7 Update 3 software)
Sun Java System Web Server 6.1 Service Pack 1 software (Also known as Sun ONE Web Server 6.1 Service Pack 1 software)
Programming and Markup Languages
The Java Programming Language
JavaScriptTM
Markup languages used to create portal content appropriate for users’ mobile and voice environments such as Wireless Markup Language (WML), compact Hypertext Markup Language (cHTML), Handheld Device Markup Language (HDML), Extensible Hypertext Markup Language (XHTML), and Voice Extensible Markup Language (VoiceXML).
Other Technologies
JavaServer PagesTM (JSP)
Java Servlet Technology
LDAP (Lightweight Directory Access Protocol)
Your Operating System
SolarisTM 8 Operating System
Solaris 9 Operating System
Solaris Operating System (x 86 Platform Edition)
In addition, you should have knowledge of basic UNIX® administrative procedures and you should have knowledge of the applications provided to your users; for example, Sun Java System Calendar Server 6 (formerly Sun ONE Calendar Server).
This book contains the following chapters and appendixes:
Chapter 1, Understanding the Mobile Applicationsprovides a developers perspective of each mobile application by illustrating control flow through the various JSP pages.
Chapter 2, Developing Voice Applicationsexplains how to add voice support to the applications that you develop. The chapter describes voice application prerequisites, and instructions for creating new voice-enabled applications.
Chapter 3, Using the Mobile Access Public APIsdescribes how to change the behavior of the application-specific tag libraries by extending the Tag Library API. The chapter also lists the utility classes exposed by the Desktop and Rendered Desktop APIs.
Chapter 4, Deploying Online Help for the Mobile Portal Desktopoutlines the process for deploying online help files to the mobile Portal Desktop.
An index and a glossary are also provided.
The guide uses certain typographical conventions to represent types of information presented.
Monospaced font is used for any text that appears on the computer screen or text that you should type. This font is also used for file names, distinguished names, functions, and examples.
An italicized font is used to represent text that you enter using information that is unique to your installation (for example, variables). This font is used for server paths and names and account IDs.
In addition to this guide, this Mobile Access software release provides supplementary information for administrators as well as documentation for developers.
Use the following URL to view all the Portal Server 7.1 documentation:
http://docs.sun.com/coll/1303.1
Additional documents that are available include:
Sun Java System Portal Server Mobile Access 7.1 Administration Guide
Sun Java System Portal Server Mobile Access 7.1 Deployment Planning Guide
Sun Java System Portal Server Mobile Access 7.1 Developer's Reference
Sun Java System Portal Server Mobile Access 7.1 Tag Library Reference Guide
You can find the Sun Java System Portal Server Mobile Access 7.1 Developer's Guide online in PDF and HTML formats. This book can be found at the following URL:
Sun is interested in improving its documentation and welcomes your comments and suggestions. Use the web-based form to provide feedback to Sun:
http://www.sun.com/hwdocs/feedback
Please provide the full document title and part number in the appropriate fields. The part number of this guide is 820-1050.
The Sun web site provides information about the following additional resources:
The following table describes the typographic conventions that are used in this book.
Table P–1 Typographic Conventions
Typeface |
Meaning |
Example |
---|---|---|
AaBbCc123 |
The names of commands, files, and directories, and onscreen computer output |
Edit your .login file. Use ls -a to list all files. machine_name% you have mail. |
AaBbCc123 |
What you type, contrasted with onscreen computer output |
machine_name% su Password: |
aabbcc123 |
Placeholder: replace with a real name or value |
The command to remove a file is rm filename. |
AaBbCc123 |
Book titles, new terms, and terms to be emphasized |
Read Chapter 6 in the User's Guide. A cache is a copy that is stored locally. Do not save the file. Note: Some emphasized items appear bold online. |
The following table shows the default UNIX system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.
Table P–2 Shell Prompts
Shell |
Prompt |
---|---|
C shell |
machine_name% |
C shell for superuser |
machine_name# |
Bourne shell and Korn shell |
$ |
Bourne shell and Korn shell for superuser |
# |