Documentation Home
> Sun Java System Portal Server 7.2 Developer's Guide
Sun Java System Portal Server 7.2 Developer's Guide
Book Information
Preface
Chapter 1 Introduction to Portal Server
Overview of Portal Server
What Is a Portal?
Portal Server Architecture
Portal Desktop
Sample Desktop and Desktop Hierarchy
Providers and Channels
Portlets and Web Service for Remote Portlets
Portal Server Software Desktop
Search Engine
Access Manager Software Services
Portal Environment
Java Development Kit
Web Container
Directory Server
File System
Overview of APIs
Desktop APIs
Provider API
Portlet API
Building Blocks
Desktop Servlet
How Concepts in the Provider API Map to the Access Manager Software
Search APIs
Search Robot
Search Database
Authentication APIs
Application Development
Display Profile
Chapter 2 Overview of the Provider API (PAPI)
Introduction to the Provider API
The Provider API
Provider Interface
ProviderAdapter Class
ProfileProviderAdapter Class
ProviderContext Interface
ProviderWidths Interface
ProviderEditTypes Interface
PropertiesFilter Class
TypedException
Provider Exceptions
ProviderException Class
AsciiFormInputExpectedException Exception
InvalidEditFormDataException Exception
UnknownEditTypeException Exception
The Provider Life Cycle
Chapter 3 Overview of the Desktop Servlet
Introduction to DesktopServlet
DesktopServlet Actions
Action Content
Action Edit
DesktopServlet Legacy Edit Action
DesktopServlet Edit Action
Action Process
DesktopServlet Legacy process Action
DesktopServlet Process Action
Action logout
Chapter 4 Overview of the Leaf Providers
Introduction to Leaf Providers
JSPProvider
URLScraperProvider
XMLProvider
Chapter 5 Overview of the Container Providers
The ContainerProvider Architecture
Overview of the ContainerProviders
ContainerProvider Interface
ContainerProviderContext Interface
ContainerProviderAdapter Class
JSPContainerProviderAdapter Class
JSPSingleContainerProvider Class
Introduction to JSPSingleContainerProvider
Using the JSPSingleContainerProvider
The JSPSingleContainerProvider Class
JSPTableContainerProvider Class
Introduction to JSPTableContainerProvider
Using the JSPTableContainerProvider
The TabContainer
UnmodifiableTab Interface
ModifiableTab Interface
JSPTabContainerProvider Class
AJAXTableContainerProvider Architecture
Server-side Container Architecture
Client-side Architecture
AJAXTableContainerProvider JavaScript library
AJAXTableContainerProvider CSS
Dojo JavaScript library
AJAXEditContainer Overview
Using the AJAXTableContainerProvider JavaScript API
Utility Methods
Getting a channel Name or ID
Using Dojo
Namespacing Channel Elements
Cross-domain AJAX
AJAXTableContainerProvider Localization
Chapter 6 Overview of Implementing a Custom Provider
Overview of Defining a Custom Provider
Defining Specific Requirements and Functionality
Application Specific Requirements
Presentation Method
Provider-specific Properties
Properties in Display Profile
Properties in Resource bundle
Developing the Provider Class File
Provider Class File Location
Provider Class File
Provider Class Loader
Creating XML Fragments for Display Profile
Editing the Display Profile
Loading the Display Profile at the Appropriate LDAP Nodes
Installing the Provider
Installing Manually
To install the provider manually
Transporting Using the psadmin Utility
Chapter 7 Layouts
Adding New Layouts
To Add New Layouts
To Change the Desktop Column Layout from the Command Line
Adding New Layouts
Deriving More Desktop Layouts
Changing Content Layout to Support Categorizing the Available and Selected Lists
Customizing Existing JSPs
Writing a New Content Channel
Chapter 8 Extending the Base Providers
Implementing the Provider Interface
To Create a Custom Provider by Implementing the Provider Interface
Extending the ProviderAdapter Class
To Create a Custom Provider by Extending the ProviderAdapter Class
Extending the ProfileProviderAdapter Class
To Create a Provider by Extending the ProfileProviderAdapter Class
To Create a Provider by Extending the ProfileProviderAdapter Class
Extending the PropertiesFilter Class
To Create a Custom Filter by Extending the PropertiesFilter Class
Chapter 9 Extending the Leaf Providers
Extending the JSPProvider
Example 1
To Extend the JSPProvider
Example 2
To Develop the SimpleUserInfoProvider
Extending the URLScraperProvider
To Extend the URLScraperProvider
Extending the XMLProvider
To Extend the XMLProvider
Chapter 10 Extending the Container Providers
Extending the JSPSingleContainerProvider
To Develop the CustomSingleContainerProvider
Extending the JSPTableContainerProvider
Example 1: Developing CustomTableContainerProvider
To Develop the CustomTableContainerProvider
Example 2: Developing SpanTableContainerProvider
To Develop the SpanTableContainerProvider
Customizing the Row Layout
To Develop the CustomTCProvider
Customizing the Column Widths
To Develop the CustomJSPTableContainerProvider
Extending the JSPTabContainerProvider
To Develop the CustomTabContainerProvider
Chapter 11 Creating a Custom ContainerProvider
Creating a Custom ContainerProvider
To Develop the RouterContainerProvider
Chapter 12 Overview of the Portlets
What is a Portlet?
Overview of Developing and Deploying Portlets
To develop and deploy portlets
Chapter 13 Deploying Struts Application as a Portlet in Portal Server
Preparing the Struts Application
Introduction
Modify Struts Application
Obtain Portlet Objects in Struts Application
Session Information
Creating and Modifying XML Files
Modifying struts-config.xml File
Creating portlet.xml File
Building and Deploying the Web Application as a Portlet Application
To Deploy the Struts Application as a Portlet
Chapter 14 Deploying JSF Application as a Portlet in Portal Server
Overview
Introduction
State Information and High Availability
Accessing Portlet APIs
Mapping Actions of JSF Application to Portal Application and Vice-Versa
Converting JSF-based Applications to JSF Aware Portlets in Portal Server
To Convert JSF-based Applications to Portlets
Chapter 15 Extending the GenericPortlet Abstract Class
Introduction to Extending the GenericPortlet Abstract Class
Developing the Class File
GenericPortlet Class
Methods to Override
Render Request Processing
Action Request Processing
Portlet Preferences
Example Portlet Class File
Compiling the Portlet
Creating a Portlet Web Application
To create a portlet web application
Deploying the Application
Creating Channels from the Deployed Portlets
Debugging the Portlet
Chapter 16 New Features in Portlet 2.0 (JSR 286)
Events
To Create Portlets That use the event Feature
Sample Application
Public Render Parameters
To Create Portlets That use the Public Render Parameters
Sample Application
Portlet Filters
To Write a Portlet Filter
Sample Application
Resource Serving
Sample Application
Portlet Policy
Chapter 17 Converting Providers to Portlets
Introduction to Converting Providers to Portlets
Mapping ProviderAdapter to GenericPortlet
Sample Code Fragments for Provider to Portlet Conversion
Provider to Portlet Mapping
Dispatching to a JSP
Help Documentation
Title Mapping
editType Property
PortletPreferences Mapping
Chapter 18 WSRP: Validating Registration Data
Overview of WSRP Communication
Registering with the Producer
Validating the Registration Data
The RegistrationValidator Interface
Default Implementation
Chapter 19 WSRP: Defining Custom Registration Validators
Implementing the RegistrationValidator Interface
To Develop the DefaultRegistrationValidator
Installing the Class File
To Install Through the Web Container WAR File
Customizing the Return Codes
To customize the return codes:
Configuring the Producer’s Registration Validator
To administer the producer
Chapter 20 Search Engine Robot Overview
Introduction to the Search Engine Robot
How the Robot Works
Robot Configuration Files
The Filtering Process
Stages in the Filter Process
Chapter 21 Robot Completion Scripts
Introduction to Robot Completion Scripts
Monitoring cmdHook Execution
Preparing Your Completion Script to Appear in the Administration Interface
Chapter 22 Overview of the Robot Application Functions
Introduction to Robot Application Functions
Robot Plug-in API Overview
To Create Custom Plug-In Functions
The Robot Application Function Header Files
Header File Hierarchy
Header File Contents
Chapter 23 Writing New Robot Application Functions
Overview of Writing Robot Application Functions
RAF Prototype
Writing Functions for Specific Directives
Passing Parameters to Robot Application Functions
Working with Parameter Blocks
Getting Information on the Processed Resource
Returning a Response Status Code
Reporting Errors to the Robot Log File
RAF Definition Example
Compiling and Linking your Code
Loading Your Shared Object
Using your New Robot Application Functions
Chapter 24 Overview of the Search API
Introduction to the Search API
What is Search?
Using the Search API
An Introductory Example
Getting Search Server Database Contents as a SearchStream
Chapter 25 Search API
Functions and Objects
Search Structure
Attribute-Value Pair Routines
Multi-valued Attribute Routines
Stream Routines for Parsing and Printing Searchs
Filtering Search Objects
Memory Buffer Management
Chapter 26 Overview of Resource Description Message
Introduction to RDM
RDM Format Syntax
RDM Header
RDM Body
Chapter 27 About the RDM API
Introduction to the RDM API
rdm.h File
API Reference
Finding the RDM Version
Creating and Freeing RDM Structures
An RDMHeader
An RDMQuery
Other RDM Structures
Chapter 28 Example of Submitting a Query
Overview of Submitting a Query
RDMHeader and RDMQuery Object Parameters
Running the Example
To Run the Example
Chapter 29 Overview of the Search Engine Java SDK
Introduction to Search Engine Java SDK
The Search Engine Java SDK
Running the Sample Applications
To Install and Run the Search Demo Command Line Program
To Install and Run the Search Demo Applet
Chapter 30 Using Java To Access the Search Server Database
Creating a Search Object
Executing A Query and Getting the Results
Working Through An Example Search Application
Import the Necessary Classes
Define the SearchDemo Class
Define the SimpleSearch Class
Execute the Search Query
Display the Results
Chapter 31 Using Java To Add Entries to the Search Engine Database
rdmgr Command
Search Object
Constructing and Submitting a Request
Constructing a Request
Submitting a Request
Submit Operations
Submit Types
Chapter 32 Federated Search Samples in Search SDK
Federated Search samples in Search SDK
Chapter 33 Developing a New Database or Search Engine Connector
Developing a New Search Engine Connector
To Develop a New Federated Search Connector
Chapter 34 Localization: Templates and JSPs
Desktop Templates
Template Files
JavaServer Pages
Image Files
File Lookup Mechanism
Developing and Deploying JSP or Template Files
To Create Customized Organization JSP and Template Files
Chapter 35 Localization: Properties
Resource Bundles
Introduction to Resource Bundles
File Naming Convention
File Installation Location
File Entries Format
Resource Bundle Access
Display Profile Properties
To Localize the User Information Channel Display Profile
Chapter 36 Localization Support in PAPI
Localization Support in ProviderContext
Localization Support in ProfileProviderAdapter
Chapter 37 Customizing the Sample Community Templates Theme
Introduction to Sun Java Web User Interface Theme
Customizing the User Interface
To Use Sun Java Web User Interface Theme in a Page
To Modify or Create a New Sun Java Web User Interface Theme
To Change the defaulttheme to Your customtheme
Chapter 38 Customizing the Desktop User Interface
Basic Customization
To Change the Logo
To Add a Background Image
To Change the Background Color
To Modify the Color Gradient Image
To Administer the Enterprise Sample Desktop from the Portal Server Management Console
Branding the Desktop
Changing Desktop Colors
Chapter 39 Simple API for Workflow
Prerequisites
Configuring SAW
To Configure SAW
Sample Scenario
Checking out a Task
Modifying Attributes of a Task
Completing a Task
Getting a Task
Using the Tag Libraries
To Use the Tag Libraries in Your JSP
Appendix A Community Sample Content Filepath
Community Sample Content Filepath
Overview
JSP and HTML Files
JavaScript and Tag Libraries
Container Provider, Channel Provider, and Channel Templates
Properties Files
Stylesheets for the Community Sample
Appendix B Channel Menus
Channel Menu Design
Customizing the Channel Menu
Appendix C Mobile Access Software Schema Reference
Client Data Schema
Address Book Schema
Calendar Schema
Mail Schema
Appendix D Deploying Online Help for the Mobile Portal Desktop
Adding Help Options
Rendered Portal Desktop JSPs
Native Portal Desktop JSPs
Native Portal Desktop Templates
Updating the Channel Display Profile
To Set Up a Custom Channel Property
To Set Up a Custom Channel Property:
To Define a Custom Channel Property
To Define a Custom Channel Property:
Creating a Help File
Installing Help Files in the File System
Deploying Help Files
Appendix E Creating Desktops
Editing the Enterprise Sample Portal Files
Changing the Desktop Type
To Change the Desktop type
Debugging the Enterprise Sample
Restoring the Enterprise Sample Default Settings
To Reload the Global Sample Display Profile
To Restore Enterprise Sample Display Profile
To Define the Login Failed Page
To Define the Logout Page
© 2010, Oracle Corporation and/or its affiliates