Martin Donnelly is a software architect and tech lead for the XPages runtime team in IBM Ireland and has worked on all three XPages releases from Notes/Domino 8.5 through 8.5.2. Prior to this, Martin also worked on XFaces for Lotus Component Designer and on JSF tooling for Rational Application Developer. In the 1990s while living and working in Massachusetts, he was a lead developer on Domino Designer. Now once again based in Ireland, Martin lives in Cork with his wife Aileen, daughters Alison, Aisling, and Maeve, and retired greyhounds Evie and Chelsea. Outside of work, he confesses to playing soccer on a weekly basis and salmon angling during the summer when the opportunity presents itself.

Mark Wallace is a software architect working in the IBM Ireland software lab. In the past, he worked on the XSP runtime, which was developed for Lotus Component Designer and subsequently evolved into the XPages runtime. He has a keen interest in programming models and improving developer productivity. Mark has worked in Lotus and IBM for more than 15 years on various products and is currently working on Sametime Unified Telephony. Mark lives in Dublin with his wife and two children and spends as much time as possible in the Ireland’s sunny south east enjoying fishing and kayaking with his family.

Tony McGuckin is a senior software engineer in the IBM Ireland software lab. Having studied software engineering at the University of Ulster, he began his career with IBM in 2006 working in software product development on the component designer runtime before moving into the XPages core runtime team. When not directly contributing to the core runtime, Tony is busy with software research and development for the next generation of application development tooling, and also engaging directly with IBM customers as an XPages consultant. Tony enjoys spending time with his wife and daughter, and getting out into the great outdoors for hill walking and the occasional chance to do some hunting in the surrounding hillsides of his native County Derry.

Preface xxiv

Part I: Getting Started with XPages 1

Chapter 1 An Introduction to XPages 3

XPages Fundamentals 3

Brand New Technology? 4

A Different Development Paradigm 5

The More Things Change, the More Things Stay the Same 7

New Horizons 7

Conclusion 8

Chapter 2 Getting Everything You Need 9

Downloads, Versions, and Locations 9

Installing Domino Designer 10

Installing Client Fix Packs 11

Client Configuration 11

Quick Tour of Domino Designer 12

Conclusion 22

Chapter 3 Building Your First XPages Application 23

Laying the Foundations 24

Forms and Views 26

Building an XPages View 31

Completing the CRUD 36

Conclusion 42

Part II: XPages Development: First Principles 43

Chapter 4 Anatomy of an XPage 45

What Exactly Is an XPage? 46

Understanding XSP Tag Markup 47

Data Sources 61

Controls 64

Containers 87

XPage Resources 101

Dojo Module 105

Converters 107

Validators 110

Simple Actions 118

Client-Side Scripting 125

HTML Tags 127

Conclusion 128

Chapter 5 XPages and JavaServer Faces 129

What Is JavaServer Faces? 130

JSF Primer 131

How Does XPages Extend JSF? 138

Conclusion 156

Chapter 6 Building XPages Business Logic 157

Adding Business Logic 157

Simple Actions 167

Using JavaScript with XPages 186

Conclusion 211

Part III: Data Binding 213

Chapter 7 Working with Domino Documents 215

Domino Document Data Source 216

Working with Domino Documents–Programmatically! 235

Rich Documents 238

Conclusion 242

Chapter 8 Working with Domino Views 243

databaseName Property 245

View Data Source Filters 246

Other View Content Modifiers 256

A Page with Two Views 259

When Is a View Not a View? 261

Go Fetch! Or Maybe Not... 262

Caching View Data 265

Sorting Columns 270

Conclusion 271

Chapter 9 Beyond the View Basics 273

Pick a View Control, Any View Control 273

The View Control: Up Close and Personal 276

Data Table 305

Repeat Control 316

Some Fun with the Pager 321

Conclusion 324

Part IV: Programmability 325

Chapter 10 Custom Controls 327

Divide and Conquer 328

Getting Started with Custom Controls 329

Using Property Definitions 337

Using the compositeData Object 346

Send and You Shall Receive 352

Custom Control Design Patterns 357

Conclusion 365

Chapter 11 Advanced Scripting 367

Application Frameworks 367

AJAX and Partial Refresh 369

Event Parameters 384

Dojo Integration 386

Working with Traditional Notes/Domino Building Blocks 401

Managed Beans 412

Conclusion 419

Chapter 12 XPages Extensibility 421

How to Create a New User Interface Control 422

Example Component 423

Let’s Get Started 424

Building a Component 428

Working with Component Properties 438

Create the Initial xsp-config Definitions 446

Specifying Complex Properties 453

Complete the xsp-config for the UISpinner Component 464

Complete the UI Component Extension, UISpinner 473

Complete the Renderer UISpinnerRenderer 477

Create a Sample Application Using the UISpinner Component 483

Where to Go From Here 491

Conclusion 493

Chapter 13 XPages in the Notes Client 495

Think Inside the Box 496

Getting Started with XPages in the Notes Client 498

3, 2, 1...Lift Off 499

Bookmarks 501

Working Offline 503

One of These Things Is Not Like the Other 507

Other Subtle Differences 508

XPages: A Good Notes Citizen 511

Introducing enableModifiedFlag and disableModifiedFlag 513

Keeping Tabs on Your Client Apps 516

Notes Links Versus Domino Links 520

Some Debugging Tips 525

XPages and Composite Applications 528

Further Adventures with Composite Applications 540

Part V: Application User Experience 541

Chapter 14 XPages Theming 543

It Used to Be Like That...But Not Anymore! 543

Styling with Style! 545

Styling with Class! 552

Theming on Steroids! 567

Conclusion 620

Chapter 15 Internationalization 621

Using Localization Options 622

Localizing Computed Expressions and JavaScript 636

Localizing Script Libraries 640

International Enablement 643

Locales in XPages 644

Deprecated Locale Codes 648

Conclusion 650

Part VI: Performance, Scalability, and Security 651

Chapter 16 Application Performance and Scalability 653

Golden Rules 654

Understanding the Request Processing Lifecycle 655

Reducing CPU Utilization 658

Reducing Memory Utilization 668

Conclusion 672

Chapter 17 Security 673

Notes/Domino Security and XPages 673

Workstation ECL Layer of Security 686

Let’s Get Started 687

Programmability Restrictions 691

Restricted Operation 693

XPages Security Checking 695

XPages Security in the Notes Client 696

Active Content Filtering 699

Public Access 702

SessionAsSigner 704

Troubleshooting XPages Java Security Exceptions 706

Conclusion 707

Part VII: Appendixes 709

Appendix A XSP Programming Reference 711

XSP Tag Reference 711

XSP Java Classes 712

Notes/Domino Java API Classes 714

XSP JavaScript Pseudo Classes 715

Appendix B XSP Style Class Reference 719

XSP CSS Files 719

XSP Style Classes 720

Appendix C Useful XPages Sites on the Net 727

Index 729

The New copy of this book will include any supplemental materials advertised. Please check the title of the book to determine if it should include any access cards, study guides, lab manuals, CDs, etc.

The Used, Rental and eBook copies of this book are not guaranteed to include any supplemental materials. Typically, only the book itself is included. This is true even if the title states it includes any access cards, study guides, lab manuals, CDs, etc.