Building Portals with the Java Portlet API

90 Pages·2004·0.44 MB·English

Building Portals with
the Java Portlet API
JEFF LINWOOD, DAVE MINTER
Building Portals with the Java Portlet API
Copyright © 2004 by Jeff Linwood, Dave Minter
All rights reserved. No part of this work may be reproduced or transmitted in any form or by any
means, electronic or mechanical, including photocopying, recording, or by any information
storage or retrieval system, without the prior written permission of the copyright owner and the
publisher.
ISBN (pbk): 1-59059-284-0
Printed and bound in the United States of America 9 8 7 6 5 4 3 2 1
Trademarked names may appear in this book. Rather than use a trademark symbol with every
occurrence of a trademarked name, we use the names only in an editorial fashion and to the
benefit of the trademark owner, with no intention of infringement of the trademark.
Lead Editor: Steve Anglin
Technical Reviewer: Carsten Ziegeler
Editorial Board: Steve Anglin, Dan Appleman, Ewan Buckingham, Gary Cornell, Tony Davis,
John Franklin, Jason Gilmore, Chris Mills, Steve Rycroft, Dominic Shakeshaft, Jim Sumser,
KarenWatterson, Gavin Wray, John Zukowski
Project Manager: Kylie Johnston
Copy Edit Manager: Nicole LeClerc
Copy Editor: Liz Welch
Production Manager: Kari Brooks
Production Editor: Ellie Fountain
Compositor: Kinetic Publishing Services, LLC
Proofreader: Nancy Sixsmith
Indexer: James Minkin
Artist: Kinetic Publishing Services, LLC
Cover Designer: Kurt Krames
Manufacturing Manager: Tom Debolski
Distributed to the book trade in the United States by Springer-Verlag New York, Inc., 175 Fifth
Avenue, New York, NY 10010 and outside the United States by Springer-Verlag GmbH & Co. KG,
Tiergartenstr. 17, 69112 Heidelberg, Germany.
In the United States: phone 1-800-SPRINGER, e-mail [email protected], or visit
http://www.springer-ny.com. Outside the United States: fax [phone], e-mail
[email protected], or visit http://www.springer.de.
For information on translations, please contact Apress directly at 2560 Ninth Street, Suite 219,
Berkeley, CA 94710. Phone [phone], fax [phone], e-mail [email protected], or visit
http://www.apress.com.
The information in this book is distributed on an “as is” basis, without warranty. Although every
precaution has been taken in the preparation of this work, neither the author(s) nor Apress shall
have any liability to any person or entity with respect to any loss or damage caused or alleged to
be caused directly or indirectly by the information contained in this work.
The source code for this book is available to readers at http://www.apress.comin the Downloads
section.
Contents at a Glance
Foreword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xi
About the Authors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiii
About the Technical Reviewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiv
Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xv
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xvii
Chapter 1 Introduction to Portals and Portlets . . . . . . . . . . . . . .1
Chapter 2 Portlet Basics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
Chapter 3 The Portlet Life Cycle . . . . . . . . . . . . . . . . . . . . . . . . . . . .41
Chapter 4 Portlet Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73
Chapter 5 Using Servlets and JavaServer Pages
with Portlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .119
Chapter 6 Packaging and Deployment Descriptors . . . . . . . . . . . .159
Chapter 7 Portal and Portlet Configuration . . . . . . . . . . . . . . . .185
Chapter 8 Security and Single Sign-On . . . . . . . . . . . . . . . . . . . . . .209
Chapter 9 RSS and Syndication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239
Chapter 10 Integrating the Lucene Search Engine . . . . . . . . . . .255
Chapter 11 Personalization and User Attributes . . . . . . . . . . . . .281
Chapter 12 Web Services for Remote Portlets (WSRP)
and Application Syndication . . . . . . . . . . . . . . . . . . . . . .295
Chapter 13 Exposing an Existing Application As
a Portlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .307
Chapter 14 Charting with JFreeChart . . . . . . . . . . . . . . . . . . . . . . . . .339
Chapter 15 Content Management Systems . . . . . . . . . . . . . . . . . . . . . . .359
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .381
iii

Contents
Foreword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xi
About the Authors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiii
About the Technical Reviewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiv
Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xv
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xvii
Chapter 1 Introduction to Portals and Portlets
. . . . . 1
Providing a Solution with Portals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
Designing the Portal’s Information Architecture . . . . . . . . . . . . . . . .2
Portal Application Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5
Building Portlets with the Portlet API . . . . . . . . . . . . . . . . . . . . . . . . . .6
Providing Technical Solutions with Portals . . . . . . . . . . . . . . . . . . . . . .7
Security and Single Sign-On . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
Content Syndication and RSS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
Searching Content from the Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
Portals and Web Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
Integrating Existing Applications into the Portal . . . . . . . . . . . . . .9
Using Charts in the Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10
Content Management and Portlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10
Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10
Chapter 2 Portlet Basics
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
First Portlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12
Building the Portlet Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
Packaging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
Deploying . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
Running . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
Portlet Programming 101 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
GenericPortlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
Portlet Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
Portlet Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
Enhancing the Portlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
Web.xml Deployment Descriptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
v
Contents
Packaging and Deploying . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38
Running . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39
Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
Chapter 3 The Portlet Life Cycle
. . . . . . . . . . . . . . . . . . . . . . . 41
The Portlet Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44
Creation of the Portlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44
Request Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47
Destroying the Portlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51
Threading Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51
Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
Chapter 4 Portlet Concepts
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Portlet Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73
Render Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78
Action Request and File Uploading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78
Portlet Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85
Render Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
Action Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89
Portlet Context . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .92
Sessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98
Sessions and Interportlet Communication . . . . . . . . . . . . . . . . . . . . . . .102
Content Markup Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105
Portlet Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107
Window States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113
Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116
Style Sheets and the User Experience . . . . . . . . . . . . . . . . . . . . . . . . . .116
Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117
Chapter 5 Using Servlets and JavaServer Pages
with Portlets
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Portlets, Servlets, and JSP Design Goals . . . . . . . . . . . . . . . . . . . . . .119
Portlet Request Dispatcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120
Request and Response Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126
Session Management Between a Portlet and a Servlet
or JSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131
Creating a Form in JSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132
Using the Portlet JSP Tag Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132
To-Do List Portlet Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .137
vi
Contents
The web.xml Deployment Descriptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .153
Directory Structure of the Application . . . . . . . . . . . . . . . . . . . . . . . .153
Complete Code Listing for the To-Do List Portlet . . . . . . . . . . . .154
Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .158
Chapter 6 Packaging and Deployment
Descriptors
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Portlet Application Packaging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .159
Versioning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .159
Portlet Application Deployment Descriptor Structure . . . . . . . . .160
Web Application Deployment Descriptor . . . . . . . . . . . . . . . . . . . . . . . . .170
XDoclet Portlet Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .171
Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .184
Chapter 7 Portal and Portlet Configuration
. . . . . . . . . 185
Using the PortalContext to Retrieve Information
About the Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .185
Using the PortletConfig Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .190
Using Portlet Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .195
Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208
Chapter 8 Security and Single Sign-On
. . . . . . . . . . . . . . . 209
Portlet Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .210
Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .238
Chapter 9 RSS and Syndication
. . . . . . . . . . . . . . . . . . . . . . . . . . 239
Overview of RSS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239
Walking Through an Example RSS File . . . . . . . . . . . . . . . . . . . . . . . . . .240
RSS Browsers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .246
Displaying Syndicated Information in Portlets . . . . . . . . . . . . . . . .247
Syndicating Out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .249
Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .253
Chapter 10 Integrating the Lucene
Search Engine
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
Overview of Lucene . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .255
Downloading and Installing Lucene . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .256
vii
Contents
Lucene Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .256
Building an Index with Lucene . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .263
Designing a Portlet to Search the Index . . . . . . . . . . . . . . . . . . . . . . .270
Developing a Portlet for Lucene . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .271
Indexing Other Types of Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .277
Lucene and Different Types of Content . . . . . . . . . . . . . . . . . . . . . . . . .279
Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .280
Chapter 11 Personalization and User
Attributes
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
Making a Good Impression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .281
Making Choices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .289
Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .294
Chapter 12 Web Services for Remote Portlets
(WSRP) and Application Syndication
. . . . . . 295
WSRP Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .295
WSRP and the Java Portlet API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .298
WSRP Markup in Content Fragments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .299
Using WSRP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .304
Common Problems with Application Syndication . . . . . . . . . . . . . . . . .304
Future Directions of WSRP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .306
Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .306
Chapter 13 Exposing an Existing Application
As a Portlet
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
Overview of the YAZD Forum Software . . . . . . . . . . . . . . . . . . . . . . . . . . .307
Deciding What to Change . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .309
Displaying Screens in a Portlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .312
Getting Configuration Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .332
Issues Encountered in Our Example . . . . . . . . . . . . . . . . . . . . . . . . . . . .338
Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .338
Chapter 14 Charting with JFreeChart
. . . . . . . . . . . . . . . . . . . . 339
Building Charts and Graphs with JFreeChart . . . . . . . . . . . . . . . . . . .339
Chart Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .340
Basic JFreeChart Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .343
Providing Data to the Chart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347
viii
Contents
Displaying Charts from a Portlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .350
Portlet Extensions to JFreeChart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .354
Portlet Example with a 3D Pie Chart . . . . . . . . . . . . . . . . . . . . . . . . . . .354
Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .357
Chapter 15 Content Management Systems
. . . . . . . . . . . . . . . . . 359
Overview of Content Management Systems . . . . . . . . . . . . . . . . . . . . . . . .359
Integration with a Content Management System . . . . . . . . . . . . . . . . .361
Common Problems with CMS and Portals . . . . . . . . . . . . . . . . . . . . . . . . . .361
Java Content Repository API (JSR 170) . . . . . . . . . . . . . . . . . . . . . . . . .362
WebDAV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .368
WebDAV Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .368
Slide WebDAV Client Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .370
WebDAV Portlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .371
Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .380
Index
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381
ix