You are on page 1of 42

The Definitive Guide to JSF in Java EE

8: Building Web Applications with


JavaServer Faces Bauke Scholtz
Visit to download the full and correct content document:
https://textbookfull.com/product/the-definitive-guide-to-jsf-in-java-ee-8-building-web-a
pplications-with-javaserver-faces-bauke-scholtz/
More products digital (pdf, epub, mobi) instant
download maybe you interests ...

Building RESTful Web Services with Java EE 8 Create


modern RESTful web services with the Java EE 8 API
Mario-Leander Reimer

https://textbookfull.com/product/building-restful-web-services-
with-java-ee-8-create-modern-restful-web-services-with-the-java-
ee-8-api-mario-leander-reimer/

Practical JSF in Java EE 8 Michael Müller

https://textbookfull.com/product/practical-jsf-in-java-
ee-8-michael-muller/

Beginning EJB in Java EE 8: Building Applications with


Enterprise JavaBeans Jonathan Wetherbee

https://textbookfull.com/product/beginning-ejb-in-java-
ee-8-building-applications-with-enterprise-javabeans-jonathan-
wetherbee/

The Definitive Guide to AdonisJs: Building Node.js


Applications with JavaScript Christopher Pitt

https://textbookfull.com/product/the-definitive-guide-to-
adonisjs-building-node-js-applications-with-javascript-
christopher-pitt/
Pro JPA 2 in Java EE 8: An In-Depth Guide to Java
Persistence APIs - Third Edition Mike Keith

https://textbookfull.com/product/pro-jpa-2-in-java-ee-8-an-in-
depth-guide-to-java-persistence-apis-third-edition-mike-keith/

Full-Stack Web Development with Jakarta EE and Vue.js:


Your One-Stop Guide to Building Modern Full-Stack
Applications with Jakarta EE and Vue.js Daniel Andres
Pelaez Lopez
https://textbookfull.com/product/full-stack-web-development-with-
jakarta-ee-and-vue-js-your-one-stop-guide-to-building-modern-
full-stack-applications-with-jakarta-ee-and-vue-js-daniel-andres-
pelaez-lopez/

Java EE 7 Development with NetBeans 8 1st Edition


Heffelfinger David R

https://textbookfull.com/product/java-ee-7-development-with-
netbeans-8-1st-edition-heffelfinger-david-r/

Full Stack Web Development with Jakarta EE and Vue js


Your One Stop Guide to Building Modern Full Stack
Applications with Jakarta EE and Vue js 1st Edition
Daniel Andres Pelaez Lopez
https://textbookfull.com/product/full-stack-web-development-with-
jakarta-ee-and-vue-js-your-one-stop-guide-to-building-modern-
full-stack-applications-with-jakarta-ee-and-vue-js-1st-edition-
daniel-andres-pelaez-lopez/

JavaServer Faces Introduction by Example Juneau Josh

https://textbookfull.com/product/javaserver-faces-introduction-
by-example-juneau-josh/
The Definitive
Guide to JSF in
Java EE 8
Building Web Applications with
JavaServer Faces

Bauke Scholtz
Arjan Tijms
The Definitive Guide to
JSF in Java EE 8
Building Web Applications with
JavaServer Faces

Bauke Scholtz
Arjan Tijms
The Definitive Guide to JSF in Java EE 8: Building Web Applications with
JavaServer Faces
Bauke Scholtz Arjan Tijms
Willemstad, Curaçao Amsterdam, Noord-Holland, The Netherlands

ISBN-13 (pbk): 978-1-4842-3386-3 ISBN-13 (electronic): 978-1-4842-3387-0


https://doi.org/10.1007/978-1-4842-3387-0
Library of Congress Control Number: 2018942178

Copyright © 2018 by Bauke Scholtz, Arjan Tijms


This work is subject to copyright. All rights are reserved by the Publisher, whether the whole or part of the
material is concerned, specifically the rights of translation, reprinting, reuse of illustrations, recitation,
broadcasting, reproduction on microfilms or in any other physical way, and transmission or information
storage and retrieval, electronic adaptation, computer software, or by similar or dissimilar methodology now
known or hereafter developed.
Trademarked names, logos, and images may appear in this book. Rather than use a trademark symbol with
every occurrence of a trademarked name, logo, or image we use the names, logos, and images only in an
editorial fashion and to the benefit of the trademark owner, with no intention of infringement of the
trademark.
The use in this publication of trade names, trademarks, service marks, and similar terms, even if they are not
identified as such, is not to be taken as an expression of opinion as to whether or not they are subject to
proprietary rights.
While the advice and information in this book are believed to be true and accurate at the date of publication,
neither the authors nor the editors nor the publisher can accept any legal responsibility for any errors or
omissions that may be made. The publisher makes no warranty, express or implied, with respect to the
material contained herein.
Managing Director, Apress Media LLC: Welmoed Spahr
Acquisitions Editor: Steve Anglin
Development Editor: Matthew Moodie
Coordinating Editor: Mark Powers
Cover designed by eStudioCalamar
Cover image designed by Freepik (www.freepik.com)
Distributed to the book trade worldwide by Springer Science+Business Media New York, 233 Spring Street,
6th Floor, New York, NY 10013. Phone 1-800-SPRINGER, fax (201) 348-4505, e-mail orders-ny@springer-
sbm.com, or visit www.springeronline.com. Apress Media, LLC is a California LLC and the sole member
(owner) is Springer Science + Business Media Finance Inc (SSBM Finance Inc). SSBM Finance Inc is a
Delaware corporation.
For information on translations, please e-mail editorial@apress.com; for reprint, paperback, or audio rights,
please email bookpermissions@springernature.com.
Apress titles may be purchased in bulk for academic, corporate, or promotional use. eBook versions and
licenses are also available for most titles. For more information, reference our Print and eBook Bulk Sales
web page at http://www.apress.com/bulk-sales.
Any source code or other supplementary material referenced by the author in this book is available to
readers on GitHub via the book’s product page, located at www.apress.com/9781484233863. For more
detailed information, please visit http://www.apress.com/source-code.
Printed on acid-free paper
To caffeine and our (not so) patient wives.
Table of Contents
About the Authors�������������������������������������������������������������������������������������������������� xiii

About the Technical Reviewer���������������������������������������������������������������������������������xv

Chapter 1: History����������������������������������������������������������������������������������������������������� 1
In the Beginning . . .���������������������������������������������������������������������������������������������������������������������� 1
The Adolescent Years�������������������������������������������������������������������������������������������������������������������� 4
On to Maturity������������������������������������������������������������������������������������������������������������������������������� 7
Rejuvenation������������������������������������������������������������������������������������������������������������������������������� 11

Chapter 2: From Zero to Hello World���������������������������������������������������������������������� 13


Installing Java SE JDK���������������������������������������������������������������������������������������������������������������� 13
What About Java EE?������������������������������������������������������������������������������������������������������������� 13
Installing Payara������������������������������������������������������������������������������������������������������������������������� 14
How About Other Servers?���������������������������������������������������������������������������������������������������� 14
Installing Eclipse������������������������������������������������������������������������������������������������������������������������� 15
Configuring Eclipse���������������������������������������������������������������������������������������������������������������� 16
Installing JBoss Tools Plug-in������������������������������������������������������������������������������������������������ 17
Integrating New Server in Eclipse����������������������������������������������������������������������������������������� 19
Creating New Project in Eclipse�������������������������������������������������������������������������������������������������� 22
Creating the Backing Bean Class������������������������������������������������������������������������������������������ 35
Creating the Facelets File������������������������������������������������������������������������������������������������������ 38
Deploying the Project������������������������������������������������������������������������������������������������������������ 41
Installing H2�������������������������������������������������������������������������������������������������������������������������������� 46
Configuring DataSource�������������������������������������������������������������������������������������������������������� 46
Configuring JPA��������������������������������������������������������������������������������������������������������������������� 47

v
Table of Contents

Creating the JPA Entity���������������������������������������������������������������������������������������������������������� 48


Creating the EJB Service������������������������������������������������������������������������������������������������������� 50
Adjusting the Hello World������������������������������������������������������������������������������������������������������ 52

Chapter 3: Components������������������������������������������������������������������������������������������ 55
Standard HTML Components������������������������������������������������������������������������������������������������������ 58
Standard Core Tags��������������������������������������������������������������������������������������������������������������������� 62
Life Cycle������������������������������������������������������������������������������������������������������������������������������������ 65
Restore View Phase (First Phase)������������������������������������������������������������������������������������������ 66
Apply Request Values Phase (Second Phase)������������������������������������������������������������������������ 66
Process Validations Phase (Third Phase)������������������������������������������������������������������������������� 67
Update Model Values Phase (Fourth Phase)�������������������������������������������������������������������������� 68
Invoke Application Phase (Fifth Phase)���������������������������������������������������������������������������������� 68
Render Response Phase (Sixth Phase)���������������������������������������������������������������������������������� 68
Ajax Life Cycle����������������������������������������������������������������������������������������������������������������������������� 69
View Build Time�������������������������������������������������������������������������������������������������������������������������� 70
View Render Time����������������������������������������������������������������������������������������������������������������������� 71
View State����������������������������������������������������������������������������������������������������������������������������������� 72
View Scope��������������������������������������������������������������������������������������������������������������������������������� 74
Phase Events������������������������������������������������������������������������������������������������������������������������������� 75
Component System Events��������������������������������������������������������������������������������������������������������� 76
Custom Component System Events�������������������������������������������������������������������������������������������� 82
JSTL Core Tags���������������������������������������������������������������������������������������������������������������������������� 83
Manipulating the Component Tree���������������������������������������������������������������������������������������������� 89

Chapter 4: Form Components��������������������������������������������������������������������������������� 95


Input, Select, and Command Components���������������������������������������������������������������������������������� 95
Text-Based Input Components���������������������������������������������������������������������������������������������������� 96
File-Based Input Component����������������������������������������������������������������������������������������������������� 103
Selection Components�������������������������������������������������������������������������������������������������������������� 105
SelectItem Tags������������������������������������������������������������������������������������������������������������������������� 114
SelectItemGroup����������������������������������������������������������������������������������������������������������������������� 118

vi
Table of Contents

Label and Message Components���������������������������������������������������������������������������������������������� 120


Command Components������������������������������������������������������������������������������������������������������������� 123
Navigation��������������������������������������������������������������������������������������������������������������������������������� 133
Ajaxifying Components������������������������������������������������������������������������������������������������������������� 136
Navigation in Ajax��������������������������������������������������������������������������������������������������������������������� 143
GET forms��������������������������������������������������������������������������������������������������������������������������������� 144
Stateless Forms������������������������������������������������������������������������������������������������������������������������ 147

Chapter 5: Conversion and Validation������������������������������������������������������������������ 149


Standard Converters����������������������������������������������������������������������������������������������������������������� 150
<f:convertNumber>������������������������������������������������������������������������������������������������������������� 153
<f:convertDateTime>���������������������������������������������������������������������������������������������������������� 156
Standard Validators������������������������������������������������������������������������������������������������������������������� 160
<f:validateLongRange>/<f:validateDoubleRange>������������������������������������������������������������� 162
<f:validateLength>/<f:validateRegex>������������������������������������������������������������������������������� 163
<f:validateRequired>���������������������������������������������������������������������������������������������������������� 164
<f:validateBean>/<f:validateWholeBean>�������������������������������������������������������������������������� 165
Immediate Attribute������������������������������������������������������������������������������������������������������������������ 171
Custom Converters�������������������������������������������������������������������������������������������������������������������� 172
Custom Validators��������������������������������������������������������������������������������������������������������������������� 183
Custom Constraints������������������������������������������������������������������������������������������������������������������� 186
Custom Messages��������������������������������������������������������������������������������������������������������������������� 187

Chapter 6: Output Components����������������������������������������������������������������������������� 191


Document-Based Output Components�������������������������������������������������������������������������������������� 191
Text-Based Output Components����������������������������������������������������������������������������������������������� 193
Navigation-Based Output Components������������������������������������������������������������������������������������� 198
Panel-Based Output Components��������������������������������������������������������������������������������������������� 199
Data Iteration Component��������������������������������������������������������������������������������������������������������� 204
Editable <h:dataTable>������������������������������������������������������������������������������������������������������� 210
Add/Remove Rows in <h:dataTable>���������������������������������������������������������������������������������� 215

vii
Table of Contents

Select Rows in <h:dataTable>�������������������������������������������������������������������������������������������� 218


Dynamic Columns in <h:dataTable>����������������������������������������������������������������������������������� 220
Resource Components�������������������������������������������������������������������������������������������������������������� 221
Pass-Through Elements������������������������������������������������������������������������������������������������������������ 230

Chapter 7: Facelets Templating���������������������������������������������������������������������������� 235


XHTML��������������������������������������������������������������������������������������������������������������������������������������� 237
Template Compositions������������������������������������������������������������������������������������������������������������� 238
Single Page Application������������������������������������������������������������������������������������������������������������ 242
Template Decorations��������������������������������������������������������������������������������������������������������������� 246
Tag Files������������������������������������������������������������������������������������������������������������������������������������ 248
Composite Components������������������������������������������������������������������������������������������������������������ 256
Recursive Composite Component���������������������������������������������������������������������������������������� 266
Implicit EL Objects�������������������������������������������������������������������������������������������������������������������� 270

Chapter 8: Backing Beans������������������������������������������������������������������������������������ 275


Model, View, or Controller?������������������������������������������������������������������������������������������������������� 275
Managed Beans������������������������������������������������������������������������������������������������������������������������ 279
Scopes�������������������������������������������������������������������������������������������������������������������������������������� 281
@ApplicationScoped����������������������������������������������������������������������������������������������������������� 282
@SessionScoped����������������������������������������������������������������������������������������������������������������� 284
@ConversationScoped�������������������������������������������������������������������������������������������������������� 286
@FlowScoped���������������������������������������������������������������������������������������������������������������������� 289
@ViewScoped��������������������������������������������������������������������������������������������������������������������� 293
@RequestScoped���������������������������������������������������������������������������������������������������������������� 300
@Dependent������������������������������������������������������������������������������������������������������������������������ 303
Which scope to choose?����������������������������������������������������������������������������������������������������������� 304
Where Is @FlashScoped?��������������������������������������������������������������������������������������������������������� 305
Managed bean initialization and destruction���������������������������������������������������������������������������� 308
Injecting JSF vended types������������������������������������������������������������������������������������������������������� 309
Eager Initialization�������������������������������������������������������������������������������������������������������������������� 311

viii
Table of Contents

Layers��������������������������������������������������������������������������������������������������������������������������������������� 314
Naming Conventions����������������������������������������������������������������������������������������������������������������� 316

Chapter 9: Exception Handling����������������������������������������������������������������������������� 319


Custom Error Pages������������������������������������������������������������������������������������������������������������������ 320
Ajax Exception Handling����������������������������������������������������������������������������������������������������������� 322
ViewExpiredException Handling������������������������������������������������������������������������������������������������ 328
IOException Handling���������������������������������������������������������������������������������������������������������������� 332
EJBException Handling������������������������������������������������������������������������������������������������������������� 333

Chapter 10: WebSocket Push�������������������������������������������������������������������������������� 341


Configuration���������������������������������������������������������������������������������������������������������������������������� 341
Usage���������������������������������������������������������������������������������������������������������������������������������������� 343
Scopes and Users��������������������������������������������������������������������������������������������������������������������� 344
Channel Design Hints���������������������������������������������������������������������������������������������������������������� 346
One-Time Push�������������������������������������������������������������������������������������������������������������������������� 347
Stateful UI Updates������������������������������������������������������������������������������������������������������������������� 349
Site-Wide Push Notifications���������������������������������������������������������������������������������������������������� 351
Keeping Track of Active Sockets����������������������������������������������������������������������������������������������� 353
Detecting Session and View Expiration������������������������������������������������������������������������������������� 355
Breaking Down Mojarra’s f:websocket Implementation����������������������������������������������������������� 356

Chapter 11: Custom Components������������������������������������������������������������������������� 359


Component Type, Family, and Renderer Type���������������������������������������������������������������������������� 359
Creating New Component and Renderer����������������������������������������������������������������������������������� 367
Extending Existing Component������������������������������������������������������������������������������������������������� 375
Extending Existing Renderer����������������������������������������������������������������������������������������������������� 381
Custom Tag Handlers���������������������������������������������������������������������������������������������������������������� 385
Packaging in a Distributable JAR���������������������������������������������������������������������������������������������� 389
Resource Dependencies����������������������������������������������������������������������������������������������������������� 392

ix
Table of Contents

Chapter 12: Search Expressions��������������������������������������������������������������������������� 393


Relative Local IDs���������������������������������������������������������������������������������������������������������������������� 394
Absolute Hierarchical IDs���������������������������������������������������������������������������������������������������������� 396
Standard Search Keywords������������������������������������������������������������������������������������������������������� 400
Custom Search Keywords��������������������������������������������������������������������������������������������������������� 403

Chapter 13: Security��������������������������������������������������������������������������������������������� 409


Java EE Security Overview and History������������������������������������������������������������������������������������ 409
Protect Access to Resources���������������������������������������������������������������������������������������������������� 411
Excluded������������������������������������������������������������������������������������������������������������������������������ 412
Unchecked��������������������������������������������������������������������������������������������������������������������������� 413
By Role�������������������������������������������������������������������������������������������������������������������������������� 413
Setting the Authentication Mechanism������������������������������������������������������������������������������������� 415
Setting the Identity Store���������������������������������������������������������������������������������������������������������� 417
Providing Our Custom JSF Code����������������������������������������������������������������������������������������������� 422
Caller-Initiated Authentication��������������������������������������������������������������������������������������������������� 428
Remember Me�������������������������������������������������������������������������������������������������������������������������� 431
Activating Remember-Me Service��������������������������������������������������������������������������������������� 433
Logging Out������������������������������������������������������������������������������������������������������������������������������� 436
Custom Principals��������������������������������������������������������������������������������������������������������������������� 437
Conditionally Rendering Based on Access�������������������������������������������������������������������������������� 439
Cross-Site Request Forgery Protection������������������������������������������������������������������������������������� 444
Web Parameter Tampering Protection�������������������������������������������������������������������������������������� 448
Cross-Site Scripting Protection������������������������������������������������������������������������������������������������� 450
Source Exposure Protection������������������������������������������������������������������������������������������������������ 453

Chapter 14: Localization��������������������������������������������������������������������������������������� 459


Hello World, Olá mundo, नमस्ते दनु िया������������������������������������������������������������������������������������ 459
Configuration���������������������������������������������������������������������������������������������������������������������������� 461
Referencing Bundle in JSF Page����������������������������������������������������������������������������������������������� 461
Changing the Active Locale������������������������������������������������������������������������������������������������������� 463
Organizing Bundle Keys������������������������������������������������������������������������������������������������������������ 467

x
Table of Contents

Localizing Conversion/Validation Messages����������������������������������������������������������������������������� 471


Obtaining Localized Message in a Custom Converter/Validator����������������������������������������������� 472
Localizing Enums���������������������������������������������������������������������������������������������������������������������� 474
Parameterized Resource Bundle Values����������������������������������������������������������������������������������� 475
Database-Based ResourceBundle��������������������������������������������������������������������������������������������� 475
HTML in ResourceBundle���������������������������������������������������������������������������������������������������������� 480

Chapter 15: Extensions����������������������������������������������������������������������������������������� 481


Extension Types������������������������������������������������������������������������������������������������������������������������ 481
Extending CDI Artifacts������������������������������������������������������������������������������������������������������������� 482
Extending Classical Artifacts����������������������������������������������������������������������������������������������������� 485
Plug-ins������������������������������������������������������������������������������������������������������������������������������������� 488
Dynamic Extensions������������������������������������������������������������������������������������������������������������������ 492
Application Configuration Populator������������������������������������������������������������������������������������ 492
The Application Main Class������������������������������������������������������������������������������������������������� 493
Local Extension and Wrapping�������������������������������������������������������������������������������������������������� 496
Introspection����������������������������������������������������������������������������������������������������������������������������� 498

Index��������������������������������������������������������������������������������������������������������������������� 501

xi
About the Authors
Bauke Scholtz is an Oracle Java Champion, a member
of the JSF 2.3 Expert Group, and the main creator of the
JSF helper library OmniFaces. On the Internet, he is more
commonly known as BalusC, who is among the top users
and contributors on Stack Overflow. Bauke has integrated
several OmniFaces solutions into JSF 2.3. He is a web
application specialist and consults or has consulted for
Mercury1 Limited, MyTutor, Nava Finance, LinkPizza, ZEEF,
M4N/Zanox, ITCA, RDC, and more clients from fintech,
affiliate marketing, social media, and more as part of his 17
years of experience. This book offers Bauke the opportunity
to go into depth to answer most frequently asked questions and correctly solve most
commonly encountered problems while using JSF.

Arjan Tijms works for Payara Services Ltd and is a JSF (JSR
372) and Security API (JSR 375) Expert Group member. He
is the co-creator of the popular OmniFaces library for JSF,
which was a 2015 Duke’s Choice Award winner, and is the
main creator of a set of tests for the Java EE authentication SPI
(JASPIC) used by various Java EE vendors. Arjan holds an MSc
degree in Computer Science from the University of Leiden,
The Netherlands. Writing about this topic was a natural
choice for Arjan; He has already written much about it on his
blog and wanted to expand that by contributing to a book.

xiii
About the Technical Reviewer
Chád (“Shod”) Darby is an author, instructor, and speaker
in the Java development world. As a recognized authority
on Java applications and architectures, he has presented
technical sessions at software development conferences
worldwide (in the United States, UK, India, Russia, and
Australia). In his 15 years as a professional software architect,
he’s had the opportunity to work for Blue Cross/Blue Shield,
Merck, Boeing, Red Hat, and a handful of startup companies.
Chád is a contributing author to several Java books,
including Professional Java E-Commerce (Wrox Press),
Beginning Java Networking (Wrox Press), and XML and
Web Services Unleashed (Sams Publishing). Chád has Java certifications from Sun
Microsystems and IBM. He holds a BS in computer science from Carnegie Mellon
University. You can visit Chád’s blog at www.luv2code.com to view his free video tutorials
on Java. You can also follow him on Twitter at ­@darbyluvs2code.

xv
CHAPTER 1

History
This chapter describes the history of JSF, starting from its early conception and ending
where we are today at the moment of writing. We’ll discuss how the JSF API (application
programming interface) itself evolved, which important events took place during that
evolution, and who some of the people were that were involved in all of this.
This is in no way a complete description of the history and the reader should
take notice of the fact that many more events took place and many more people were
involved than we were able to mention here.

In the Beginning . . .


JSF goes back a long time. Its initial JSR, JSR 127, started in 2001. At that time the
Struts web framework was wildly popular, although it wasn’t that long ago that it was
released itself (around 2000). Despite Struts’ popularity, a large number of other web
frameworks were in use in the Java space, and new ones were popping up all the time.
JavaServer Faces (JSF) was conceived as an attempt to bring a standardized MVC
(model-view-controller) web framework base into the overall Java EE platform.
Controversies are quite common in the web framework space, and JSF is no
exception here. Right at the start of its inception there was a big controversy where
Apache opposed the creation of JSF on the bases that Apache Struts already existed and
a closed source alternative would have little value. Apache therefore voted against the
creation of JSF with the following comment:

This JSR conflicts with the Apache open source project Struts. Considering
Sun’s current position that JSRs may not be independently implemented
under an open source license, we see little value in recreating a technology
in a closed environment that is already available in an open environment.

1
© Bauke Scholtz, Arjan Tijms 2018
B. Scholtz and A. Tijms, The Definitive Guide to JSF in Java EE 8, https://doi.org/10.1007/978-1-4842-3387-0_1
Chapter 1 History

To the extent that this JSR extends beyond Struts today, we would encourage
the Sun developers proposing this JSR to join the Sun developers already
leading Struts to create an open solution at Apache, something which when
finished would be assured of being able to be implemented as open source.

Eventually the conflict was resolved when after about a year into the process spec
lead Amy Fowler (from Swing fame) was replaced by Craig McClanahan, the very
father of the Struts project that JSF was said to be competing with. The open source
restriction was lifted as well, and the open source JSF implementation, called MyFaces,
was developed in parallel with the (then nameless) RI and hence the specification itself.
MyFaces initially started as an LGPL licensed project at sourceforge.net in December
2002 and had an initial 0.1 release conforming to what was then called an “Early Access
Specification” in January 2003.
Open source implementations are the most common implementations in Java
EE 8, and there’s barely any EE specification at the time of this writing (2018) that’s still
implemented as closed source. In 2001, however, this was not just uncommon; it was
actually not allowed for new JSRs. Allowing for an open source implementation was
therefore quite a change, and the honor fell to JSF to be the first of its kind for which this
was allowed.
Despite the open source implementation being allowed, the actual development of
the spec was still done in secret and behind closed doors. There was no public mailing
list, and no tracker (e.g., a JIRA instance) for the public to create issues or express wishes.
Occasionally interviews were being done, and in the fall of 2002 by then former spec lead
Amy Fowler did reveal quite a few details about JSF, but largely the project was shrouded
in mystery for the general public.
The team behind JSF was, however, hard at work. The first e-mail to the internal
JSR-127 list was sent on August 17, 2001. As with most projects, the team spent the initial
months on gathering requirements and looking at the existing competing products. A
package name was chosen as well. The initial placeholder package, which was "javax.
servlet.ui", now "javax.faces", was chosen as the package to use. The very first
technical architecture to be considered was the component model. For a component-­
based MVC framework this is obviously one of the most important aspects. During the
last month of 2001 and the first two months of 2002 the team looked at what is now known
as the Managed Bean (called “Object Manager” then). Managed beans with their scopes,
names, and dependency injection are clearly another cornerstone of the JSF framework.
Events and the model behind it were being looked at as well during that time frame.

2
Chapter 1 History

In the second quarter of 2002 two other cornerstones of JSF were discussed: the
Expression Language (inspired by JSTL), which is instrumental for the so-called bindings
of beans from a template to backing code, and the factory finder, which allowed key
parts of JSF to be replaced and although perhaps not fully realized at the time may have
contributed greatly to JSF still being relevant some 16 years later.
It was in this same quarter that Craig McClanahan took over as spec lead, father of
Struts and architect of Tomcat’s Servlet container, took over. Not long after the discussion
about using JSP started, a discussion, perhaps unbeknownst to the team at the time, that
would, unfortunately, have a rather negative impact on JSF later on. Around the end
of the year 2002, Ed Burns, who like McClanahan had also worked on Tomcat before,
joined the team as co-spec lead. Burns is the person who would eventually become the
main spec lead of JSF for well over a decade.
While the team continued to work on things like the aforementioned managed
beans and the so-called value binding, which is the Java representation of the also
aforementioned expression language binding, the first dark cloud appeared when in the
spring of 2003 team member Hans Bergsten realized that there were very real and major
issues with using JSP as the templating language for JSF. He brought these concerns to
the team, but ultimately they weren’t addressed and instead the following months were
spent, among other things, on a variant of the value binding; it later on became clear that
the method binding and the state saving mechanism were another of JSF’s less than ideal
implementations.
JSF 1.0 and its still nameless RI were eventually released on March 11, 2004—
coincidentally, a mere two weeks before the release of another framework that’s still
strong today, Spring 1.0. MyFaces released its 1.0.0 alpha version only days later, on
March 19. It’s perhaps an interesting observation that JSF went final with a full-fledged
XML-based dependency injection (DI) framework just before Spring, which is largely
known for its DI, went final.
JSF 1.0 was generally well received; despite a rather crowded market with
competitors such as Tapestry, WebObjects, Velocity, and Cocoon operating, not less than
three books from writers such as Horst Caymann and Hans Bergsten appeared in the
months after, and the eXo platform (a Digital Collaboration Platform) started using JSF
right away.
Hans Bergsten’s earlier concerns, however, become painfully clear almost just
as quickly; the JSP technology is based on processing a template from start to end,
immediately writing to the response as tags are encountered. JSF, however, requires
a phased approach where components need to be able to inspect and act on the
3
Chapter 1 History

component tree, which is built from the tags on the page, before starting to write
anything to the response. This mismatch led to many strange issues, such as content
disappearing or being rendered out of order.
Only three months after the introduction of JSF, Hans Bergsten made a strong case
of dropping JSP in his legendary article “Improving JSF by Dumping JSP.” There Bergsten
explains how ill-suited JSP is for use a template language in JSF, but he also presents
a glimmer of hope; because of JSF’s great support for extendibility, it’s relatively easy
to introduce alternative templating simply by replacing the so-called view handler,
something which JSF explicitly allows. It would, however, take five long years until JSF
would indeed ship with a more suitable view templating language, and even though JSP
had been essentially deprecated at that point it’s still present in JSF at the time of writing.

The Adolescent Years


Back in 2004 another first befell JSF; on June 28 Ed Burns announced that the source
of the RI was released by Sun. This represented a major milestone as before that date
most technology in active use by Sun was closed source. Initially the source was licensed
under the somewhat exotic JRL, but later this would be changed to dual licenses, GPL
with classpath exception and CDDL. At the same time as this announcement, the
tradition was established that every new feature or bug fix should be accompanied by a
test, and that all existing tests should be executed before committing the change. Some
14 years later there’s a largely different set of people working on the RI source, and
the project structure and code conventions have changed as well, but the test-driven
tradition is still being uphold in its original form.
At that point Ed Burns decided to focus more on the specification aspects of JSF as
the JSF 1.2 spec work had started right away, and Jayashri Visvanathan, one of the early
team members, took on the lead role concerning the implementation aspects, with Ryan
Lubke, working as the TCK (testing) engineer.
Still only a few months old, a variety of component libraries for JSF had already
started to pop up, although all of them commercial. Among those was the one from
Oracle, ADF Faces. ADF Faces was put on Oracle’s roadmap well before JSF 1.0 went final,
and the first early access release was presented on August 17, 2004. Its lead was Adam
Winer, who represented Oracle in the team that created JSF 1.0. ADF Faces primarily
contained a set of rich components, but also a dialog framework, and remarkably
already featured partial page rendering (PPR), quite a bit ahead of the later crop of AJAX

4
Chapter 2 From Zero to Hello World

• General ➤ Workspace ➤ Text file encoding must be set to UTF-­8.


Particularly in Windows this might otherwise default to the proprietary
encoding CP-1252 which does not support any characters beyond the
Latin range. When reading and saving Unicode files with CP-1252, you
risk seeing unintelligible sequences of characters. This is also called
“mojibake.”.1
• General ➤ Workspace ➤ New text file line delimiter must be set to
Unix. It works just fine on Windows as well. This will particularly
keep version control systems happy. Otherwise, developers pulling
code on different operating systems might face confusing conflicts or
diffs caused by different line endings.

• General ➤ Editors ➤ Text editors ➤ Spelling should preferably


be disabled. This will save you from a potentially big annoyance,
because it unnecessarily also spellchecks XML configuration files
such as faces-config.xml and web.xml, causing confusing errors and
warnings in those files.

• Java ➤ Compiler ➤ Compiler compliance level must be set to 1.8. This


is the minimum required Java version for Java EE 8.

• Java ➤ Installed JREs must be set to the JDK, not to the JRE. This
setting will normally also be used to execute the integrated
application server which usually requires the JDK.

Installing JBoss Tools Plug-in


Standard Eclipse for Java EE in its current version does not support any CDI tools. It
has no wizards to create CDI managed beans, or autocompletion and hyperlinking for
CDI managed beans in JSF pages. The JBoss Tools plug-in is an extensive plug-in which
offers among others the CDI tools.2 This is very useful when developing a Java EE web
application.

1
h ttps://en.wikipedia.org/wiki/Mojibake.
2
http://tools.jboss.org/features/cdi.html.

17
Another random document with
no related content on Scribd:
The Project Gutenberg eBook of Divots
This ebook is for the use of anyone anywhere in the United
States and most other parts of the world at no cost and with
almost no restrictions whatsoever. You may copy it, give it away
or re-use it under the terms of the Project Gutenberg License
included with this ebook or online at www.gutenberg.org. If you
are not located in the United States, you will have to check the
laws of the country where you are located before using this
eBook.

Title: Divots

Author: P. G. Wodehouse

Release date: November 25, 2023 [eBook #72227]

Language: English

Original publication: United States: George H. Doran Company,


1927

Credits: Aaron Adrignola, Tim Lindell and the Online Distributed


Proofreading Team at https://www.pgdp.net (This book
was produced from images made available by the
HathiTrust Digital Library.)

*** START OF THE PROJECT GUTENBERG EBOOK DIVOTS ***


DIVOTS
P. G. WODEHOUSE
By P. G. WODEHOUSE

CARRY ON, JEEVES!


HE RATHER ENJOYED IT
BILL THE CONQUEROR
GOLF WITHOUT TEARS
JEEVES
LEAVE IT TO PSMITH
MOSTLY SALLY
THREE MEN AND A MAID
INDISCRETIONS OF ARCHIE
THE LITTLE WARRIOR
A DAMSEL IN DISTRESS
DIVOTS
BY
P. G. WODEHOUSE

NEW YORK
GEORGE H. DORAN
COMPANY
COPYRIGHT, 1923, 1924, 1925, 1926 AND 1927,
BY P. G. WODEHOUSE

DIVOTS
—B—
PRINTED IN THE UNITED STATES OF AMERICA
TO
My Daughter
LEONORA
WITHOUT WHOSE NEVER-FAILING
SYMPATHY AND ENCOURAGEMENT
THIS BOOK
WOULD HAVE BEEN FINISHED
IN
HALF THE TIME
PREFACE
Before leading the reader out on to this little nine-hole course, I
should like to say a few words on the club-house steps with regard to
the criticisms of my earlier book of Golf stories, The Clicking of
Cuthbert. In the first place, I noticed with regret a disposition on the
part of certain writers to speak of Golf as a trivial theme, unworthy of
the pen of a thinker. In connection with this, I can only say that right
through the ages the mightiest brains have occupied themselves
with this noble sport, and that I err, therefore, if I do err, in excellent
company.
Apart from the works of such men as James Braid, John Henry
Taylor and Horace Hutchinson, we find Publius Syrius not disdaining
to give advice on the back-swing (“He gets through too late who
goes too fast”); Diogenes describing the emotions of a cheery player
at the water-hole (“Be of good cheer. I see land”); and Doctor Watts,
who, watching one of his drives from the tee, jotted down the
following couplet on the back of his score-card:

Fly, like a youthful hart or roe,


Over the hills where spices grow.

And, when we consider that Chaucer, the father of English poetry,


inserted in his Squiere’s Tale the line

Therefore behoveth him a ful long spoone

(though, of course, with the modern rubber-cored ball an iron would


have got the same distance) and that Shakespeare himself,
speaking querulously in the character of a weak player who held up
an impatient foursome, said:

Four rogues in buckram let drive at me

we may, I think, consider these objections answered.


A far more serious grievance which I have against my critics is that
many of them confessed to the possession of but the slightest
knowledge of the game, and one actually stated in cold print that he
did not know what a niblick was. A writer on golf is certainly entitled
to be judged by his peers—which, in my own case, means men who
do one good drive in six, four reasonable approaches in an eighteen-
hole round, and average three putts per green: and I think I am
justified in asking of editors that they instruct critics of this book to
append their handicaps in brackets at the end of their remarks. By
this means the public will be enabled to form a fair estimate of the
worth of the volume, and the sting in such critiques as “We laughed
heartily while reading these stories—once—at a misprint” will be
sensibly diminished by the figures (36) at the bottom of the
paragraph. While my elation will be all the greater should the words
“A genuine masterpiece” be followed by a simple (scr.).

One final word. The thoughtful reader, comparing this book with
The Clicking of Cuthbert, will, no doubt, be struck by the poignant
depth of feeling which pervades the present volume like the scent of
muddy shoes in a locker-room: and it may be that he will conclude
that, like so many English writers, I have fallen under the spell of the
great Russians.
This is not the case. While it is, of course, true that my style owes
much to Dostoievsky, the heart-wringing qualities of such stories as
“The Awakening of Rollo Podmarsh” and “Keeping in with Vosper” is
due entirely to the fact that I have spent much time recently playing
on the National Links at Southampton, Long Island, U.S.A. These
links were constructed by an exiled Scot who conceived the dreadful
idea of assembling on one course all the really foul holes in Great
Britain. It cannot but leave its mark on a man when, after struggling
through the Sahara at Sandwich and the Alps at Prestwick, he finds
himself faced by the Station-Master’s Garden hole at St. Andrew’s
and knows that the Redan and the Eden are just round the corner.
When you turn in a medal score of a hundred and eight on two
successive days, you get to know something about Life.

And yet it may be that there are a few gleams of sunshine in the
book. If so, it is attributable to the fact that some of it was written
before I went to Southampton and immediately after I had won my
first and only trophy—an umbrella in a hotel tournament at Aiken,
South Carolina, where, playing to a handicap of sixteen, I went
through a field consisting of some of the fattest retired businessmen
in America like a devouring flame. If we lose the Walker Cup this
year, let England remember that.
P. G. WODEHOUSE
The Sixth Bunker
Addington
CONTENTS
CHAPTER PAGE
I THE HEART OF A GOOF 15
II HIGH STAKES 51
III KEEPING IN WITH VOSPER 85
IV CHESTER FORGETS HIMSELF 116
V THE MAGIC PLUS FOURS 153
VI THE AWAKENING OF ROLLO PODMARSH 183
VII RODNEY FAILS TO QUALIFY 210
VIII JANE GETS OFF THE FAIRWAY 246
IX THE PURIFICATION OF RODNEY SPELVIN 283
DIVOTS
CHAPTER I
THE HEART OF A GOOF

It was a morning when all nature shouted “Fore!” The breeze, as it


blew gently up from the valley, seemed to bring a message of hope
and cheer, whispering of chip-shots holed and brassies landing
squarely on the meat. The fairway, as yet unscarred by the irons of a
hundred dubs, smiled greenly up at the azure sky; and the sun,
peeping above the trees, looked like a giant golf-ball perfectly lofted
by the mashie of some unseen god and about to drop dead by the
pin of the eighteenth. It was the day of the opening of the course
after the long winter, and a crowd of considerable dimensions had
collected at the first tee. Plus fours gleamed in the sunshine, and the
air was charged with happy anticipation.
In all that gay throng there was but one sad face. It belonged to
the man who was waggling his driver over the new ball perched on
its little hill of sand. This man seemed careworn, hopeless. He gazed
down the fairway, shifted his feet, waggled, gazed down the fairway
again, shifted the dogs once more, and waggled afresh. He waggled
as Hamlet might have waggled, moodily, irresolutely. Then, at last,
he swung, and, taking from his caddie the niblick which the intelligent
lad had been holding in readiness from the moment when he had
walked on to the tee, trudged wearily off to play his second.
The Oldest Member, who had been observing the scene with a
benevolent eye from his favourite chair on the terrace, sighed.
“Poor Jenkinson,” he said, “does not improve.”
“No,” agreed his companion, a young man with open features and
a handicap of six. “And yet I happen to know that he has been taking
lessons all the winter at one of those indoor places.”
“Futile, quite futile,” said the Sage with a shake of his snowy head.
“There is no wizard living who could make that man go round in an
average of sevens. I keep advising him to give up the game.”
“You!” cried the young man, raising a shocked and startled face
from the driver with which he was toying. “You told him to give up
golf! Why I thought—”
“I understand and approve of your horror,” said the Oldest
Member, gently. “But you must bear in mind that Jenkinson’s is not
an ordinary case. You know and I know scores of men who have
never broken a hundred and twenty in their lives, and yet contrive to
be happy, useful members of society. However badly they may play,
they are able to forget. But with Jenkinson it is different. He is not
one of those who can take it or leave it alone. His only chance of
happiness lies in complete abstinence. Jenkinson is a goof.”
“A what?”
“A goof,” repeated the Sage. “One of those unfortunate beings
who have allowed this noblest of sports to get too great a grip upon
them, who have permitted it to eat into their souls, like some
malignant growth. The goof, you must understand, is not like you
and me. He broods. He becomes morbid. His goofery unfits him for
the battles of life. Jenkinson, for example, was once a man with a
glowing future in the hay, corn, and feed business, but a constant
stream of hooks, tops, and slices gradually made him so diffident
and mistrustful of himself, that he let opportunity after opportunity
slip, with the result that other, sterner, hay, corn, and feed merchants
passed him in the race. Every time he had the chance to carry
through some big deal in hay, or to execute some flashing coup in
corn and feed, the fatal diffidence generated by a hundred rotten
rounds would undo him. I understand his bankruptcy may be
expected at any moment.”
“My golly!” said the young man, deeply impressed. “I hope I never
become a goof. Do you mean to say there is really no cure except
giving up the game?”
The Oldest Member was silent for a while.
“It is curious that you should have asked that question,” he said at
last, “for only this morning I was thinking of the one case in my
experience where a goof was enabled to overcome his deplorable
malady. It was owing to a girl, of course. The longer I live, the more I
come to see that most things are. But you will, no doubt, wish to hear
the story from the beginning.”
The young man rose with the startled haste of some wild creature,
which, wandering through the undergrowth, perceives the trap in his
path.
“I should love to,” he mumbled, “only I shall be losing my place at
the tee.”
“The goof in question,” said the Sage, attaching himself with quiet
firmness to the youth’s coat-button, “was a man of about your age,
by name Ferdinand Dibble. I knew him well. In fact, it was to me—”
“Some other time, eh?”
“It was to me,” proceeded the Sage, placidly, “that he came for
sympathy in the great crisis of his life, and I am not ashamed to say
that when he had finished laying bare his soul to me there were tears
in my eyes. My heart bled for the boy.”
“I bet it did. But—”
The Oldest Member pushed him gently back into his seat.
“Golf,” he said, “is the Great Mystery. Like some capricious
goddess—”
The young man, who had been exhibiting symptoms of
feverishness, appeared to become resigned. He sighed softly.
“Did you ever read ‘The Ancient Mariner’?” he said.
“Many years ago,” said the Oldest Member. “Why do you ask?”
“Oh, I don’t know,” said the young man. “It just occurred to me.”

Golf (resumed the Oldest Member) is the Great Mystery. Like


some capricious goddess, it bestows its favours with what would
appear an almost fat-headed lack of method and discrimination. On
every side we see big two-fisted he-men floundering round in three
figures, stopping every few minutes to let through little shrimps with
knock knees and hollow cheeks, who are tearing off snappy seventy-
fours. Giants of finance have to accept a stroke per from their junior
clerks. Men capable of governing empires fail to control a small,
white ball, which presents no difficulties whatever to others with one
ounce more brain than a cuckoo-clock. Mysterious, but there it is.
There was no apparent reason why Ferdinand Dibble should not
have been a competent golfer. He had strong wrists and a good eye.
Nevertheless, the fact remains that he was a dub. And on a certain
evening in June I realised that he was also a goof. I found it out quite
suddenly as the result of a conversation which we had on this very
terrace.
I was sitting here that evening thinking of this and that, when by
the corner of the clubhouse I observed young Dibble in conversation
with a girl in white. I could not see who she was, for her back was
turned. Presently they parted and Ferdinand came slowly across to
where I sat. His air was dejected. He had had the boots licked off
him earlier in the afternoon by Jimmy Fothergill, and it was to this
that I attributed his gloom. I was to find out in a few moments that I
was partly but not entirely correct in this surmise. He took the next
chair to mine, and for several minutes sat staring moodily down into
the valley.
“I’ve just been talking to Barbara Medway,” he said, suddenly
breaking the silence.
“Indeed?” I said. “A delightful girl.”
“She’s going away for the summer to Marvis Bay.”
“She will take the sunshine with her.”
“You bet she will!” said Ferdinand Dibble, with extraordinary
warmth, and there was another long silence.
Presently Ferdinand uttered a hollow groan.
“I love her, dammit!” he muttered brokenly. “Oh, golly, how I love
her!”
I was not surprised at his making me the recipient of his
confidences like this. Most of the young folk in the place brought
their troubles to me sooner or later.
“And does she return your love?”
“I don’t know. I haven’t asked her.”
“Why not? I should have thought the point not without its interest
for you.”
Ferdinand gnawed the handle of his putter distractedly.
“I haven’t the nerve,” he burst out at length. “I simply can’t
summon up the cold gall to ask a girl, least of all an angel like her, to
marry me. You see, it’s like this. Every time I work myself up to the
point of having a dash at it, I go out and get trimmed by some one
giving me a stroke a hole. Every time I feel I’ve mustered up enough
pep to propose, I take ten on a bogey three. Every time I think I’m in
good mid-season form for putting my fate to the test, to win or lose it
all, something goes all blooey with my swing, and I slice into the
rough at every tee. And then my self-confidence leaves me. I
become nervous, tongue-tied, diffident. I wish to goodness I knew
the man who invented this infernal game. I’d strangle him. But I
suppose he’s been dead for ages. Still, I could go and jump on his
grave.”
It was at this point that I understood all, and the heart within me
sank like lead. The truth was out. Ferdinand Dibble was a goof.
“Come, come, my boy,” I said, though feeling the uselessness of
any words. “Master this weakness.”
“I can’t.”
“Try!”
“I have tried.”
He gnawed his putter again.
“She was asking me just now if I couldn’t manage to come to
Marvis Bay, too,” he said.
“That surely is encouraging? It suggests that she is not entirely
indifferent to your society.”
“Yes, but what’s the use? Do you know,” a gleam coming into his
eyes for a moment, “I have a feeling that if I could ever beat some
really fairly good player—just once—I could bring the thing off.” The
gleam faded. “But what chance is there of that?”
It was a question which I did not care to answer. I merely patted
his shoulder sympathetically, and after a little while he left me and
walked away. I was still sitting there, thinking over his hard case,
when Barbara Medway came out of the club-house.
She, too, seemed grave and pre-occupied, as if there was
something on her mind. She took the chair which Ferdinand had
vacated, and sighed wearily.
“Have you ever felt,” she asked, “that you would like to bang a
man on the head with something hard and heavy? With knobs on?”
I said I had sometimes experienced such a desire, and asked if
she had any particular man in mind. She seemed to hesitate for a
moment before replying, then, apparently, made up her mind to
confide in me. My advanced years carry with them certain pleasant
compensations, one of which is that nice girls often confide in me. I
frequently find myself enrolled as a father-confessor on the most
intimate matters by beautiful creatures from whom many a younger
man would give his eye-teeth to get a friendly word. Besides, I had
known Barbara since she was a child. Frequently—though not
recently—I had given her her evening bath. These things form a
bond.
“Why are men such chumps?” she exclaimed.
“You still have not told me who it is that has caused these harsh
words. Do I know him?”
“Of course you do. You’ve just been talking to him.”
“Ferdinand Dibble? But why should you wish to bang Ferdinand
Dibble on the head with something hard and heavy with knobs on?”
“Because he’s such a goop.”

You might also like