Mastering XPages：深入指南

需积分: 1 91 浏览量更新于2024-07-23 收藏 3.28MB PDF 举报

"Domino xPage开发指南，包含XSP属性的工作原理，详细解析了xsp.properties中的各项配置，如超时属性、主题属性、资源属性、文件上传属性以及JSF持久化属性。该资源出自《Mastering XPages》一书，由Martin Donnelly, Mark Wallace和Tony McGuckin撰写，提供了深入浅出的XPages应用开发和语言学习的步骤指导。" XPages是IBM Lotus Domino平台上的一个创新技术，用于构建富客户端Web应用程序。在"XPages.Portable.Command.Guide"中，主要介绍了与XPages开发相关的各种配置属性，这些属性可以用来优化和定制应用程序的行为。 1. 工作与XSP属性：这部分讲解了如何定位和更新`xsp.properties`文件，它是控制XPages行为的关键配置文件。 2. 超时属性： - `xsp.application.timeout`定义了应用程序的超时时间，超过这个时间，用户的会话将被终止。 - `xsp.session.timeout`设置用户会话的超时时间。 - `xsp.session.transient`允许指定会话是否为临时的，临时会话在关闭浏览器后不会保存状态。 3. 主题属性： - `xsp.theme`定义应用程序的主题，可控制页面的样式和布局。 - `xsp.theme.web`和`xsp.theme.notes`分别用于Web和Lotus Notes客户端的主题设定。 4. 资源属性： - `xsp.resources.aggregate`控制是否合并资源，如CSS和JavaScript，以提高页面加载性能。 5. 文件上传属性： - `xsp.upload.maximumsize`设定单个文件的最大上传大小。 - `xsp.upload.directory`指定文件上传的存储目录。 6. JSF持久化属性： - `xsp.persistence.discardjs`控制是否丢弃JavaScript状态。 - `xsp.persistence.mode`设定数据的持久化方式，例如内存或文件。 - `xsp.persistence.tree.maxviews`和`xsp.persistence.file.maxviews`分别限制视图树和文件持久化的最大视图数。 - `xsp.persistence.viewstate`管理视图状态的存储。 - `xsp.persistence.file.gzip`启用或禁用文件持久化时的GZIP压缩。 - `xsp.persistence.file.async`允许异步持久化。 - `xsp.persistence.file.threshold`设置文件持久化阈值。 - `xsp.persistence.dir.xspstate`和`xsp.persistence.dir.xspupload`分别指定XSP状态和上传文件的存储目录。《Mastering XPages》这本书提供了深入的实践指南，通过大量的实例帮助开发者逐步掌握XPages技术，无论你是否有Notes/Domino开发经验。作者们分享了他们在IBM XPages团队中的经验和最佳实践，帮助读者理解和掌握整个开发流程，从而成为XPages领域的专家。

Contents xv

XSP.setSubmitValue(submitValue) : void 169

XSP.getSubmitValue() : object 170

XSP.validateAll(formId, valmode, execId) : boolean 171

XSP.getFieldValue(node) : string 172

XSP.getDijitFieldValue(dj) : object 173

XSP.validationError(clientId, message) : void 174

XSP.scrollWindow(x, y) : void 176

XSP.partialRefreshGet(refreshId, options) : void 176

XSP.partialRefreshPost(refreshId, options) : void 177

XSP.attachClientFunction(targetClientId, eventType,

clientScriptName) : void 179

XSP.attachClientScript(targetClientId, eventType,

clientScript) : void 180

XSP.addOnLoad(listener) : void 181

XSP.showSection(sectionId, show) : void 182

XSP.findForm(nodeOrId) : object 183

XSP.findParentByTag(nodeOrId, tag) : object 183

XSP.getElementById(elementId) : object 184

XSP.hasDijit() : boolean 184

XSP.trim(s) : string 185

XSP.startsWith(s, prefix) : boolean 186

XSP.endsWith(s, suffix) : boolean 186

XSP.toJson(o) : string 187

XSP.fromJson(s) : object 187

XSP.log(message) : void 188

XSP.dumpObject(object) : string 189

How XPages Uses the Dojo Framework 189

Dojo Types and Attributes 190

Working with Dojo Dijits 193

IDs in the HTML Source and the Requirement to Use the

“#{id:” Syntax 193

Scripts Accessing Dojo Controls Need to Use dijit.byId 195

Dojo Controls Are Not Available While the HTML Page Is

Loading 196

Bad AJAX Requests to an XPage Can Cause Loss of

Data 197

XPages Input Validation Can Interact with Dojo Layout

Controls 198

Dojo Control Interaction with XPages Partial Update 199

Introduction

Welcome to the XPages Portable Command Guide! This book is designed, for the

most part, as a quick information guide for XPages developers with some real-world

experience under their belts. It focuses on the road less traveled—xsp.properties

parameters, notes.ini settings, XSP JS object functions, and such. In other words,

it covers the little-known magic bullets that are not well documented but invariably

help get you out of a programming bind. In that sense, it is an ideal companion for

more holistic tomes such as Mastering XPages, which is designed to give broad

coverage to the runtime and application development experience in general. Having

said that, this book does dive into detail, when appropriate—after all, the authors are

developers, so we just can’t help ourselves!

XPages is a rich and powerful application development framework for Notes/

Domino, first introduced in version 8.5 at Lotusphere 2009. Since that time, XPages

has gone from strength to strength, with three further release updates, an open source

XPages Extension Library, a dedicated IBM XWork server, a best-selling IBM Press

book, and many other initiatives and innovations. We hope this Portable Command

Guide helps add to the general success of XPages by bringing new information to the

community and making application development a little bit easier for all concerned.

Reading Audience

This book is for XPages developers with some practical experience. Neophytes are

advised to start with a more general book, such as Mastering XPages, or perhaps to

use this book as its companion guide.

Conventions

Any programming code, markup, or XSP keywords are illustrated in numbered list-

ings using a fixed width font.

User interface elements (menus, links, buttons, and so on) of the Notes client,

Domino Designer, or any sample applications are referenced using a bold font.

So too are file system paths, locations, and artifacts, such as the notes.ini and

xsp.properties files.

Important words and phrases are emphasized using an italic font.

Visual representations of the design-time experience or runtime features are typically

captured as screen shots and written up as numbered figures, using super-imposed

callouts where appropriate.

In general, chapters feature a summary table of XPages commands, parameters,

or properties near the beginning and seek to explain these in brief, concise terms.

These items, or important subsets thereof, are typically then given more expansive

Introduction xix

treatment in the rest of the chapter. Most chapters also have an accompanying NSF

sample application containing practical examples that can be perused using Domino

Designer and run in preview mode for the web or Notes client. These samples are

available online for download at the following website: www.ibmpressbooks.com/

title/0132943050

The samples are based on the latest release of XPages available at the time of writing

(version 8.5.3), although many examples work with earlier releases. Visit this website

to download the no-charge version of Domino Designer 8.5.3: www.ibm.com/

developerworks/downloads/ls/dominodesigner/

How This Book Is Organized

This book is divided into six chapters, to separately address the many different

aspects of XPages software development in as logical a manner as possible.

 n

Chapter 1, “Working with XSP Properties,” gives you all the details you

need to locate, edit, and load the xsp.properties file, and thus configure the

XPages runtime for your own specific requirements. An XSP property is a

simple parameter definition that can modify the behavior of the XPages run-

time in “magical” ways.

 n

Chapter 2, “Working with Notes/Domino Configuration Files,” concerns

itself with the practical business of identifying the notes.ini settings that have

particular relevance to XPages and explains their usage in detail.

 n

Chapter 3, “Working with the Console,” gives an overview of the many

ways you can interact with the XPages runtime at the console level for runtime

analysis, troubleshooting, or application debugging.

 n

Chapter 4, “Working with the XSP Client Side JavaScript Object,” exam-

ines the XSP Client Side JavaScript Object and lists simple examples of all

the publically exposed functions that that can be used in an XPage. It also

provides a general overview of Client Side JavaScript scripting techniques and

other miscellaneous features relevant to XPages development.

 n

Chapter 5, “Server-Side Scripting,” gives an overview of Server Side

JavaScript scripting objects and supporting libraries. This chapter also exam-

ines ways to integrate custom Java classes and create Managed Beans.

 n

Chapter 6, “Server-Side Debugging Techniques,” provides detail on set-

ting up a debug and logging environment for your XPages applications. It also

explains the details of stack traces and how you can analyze and decipher such

information when troubleshooting an application.

 n

Appendix A, “Definitive Resources,” points to a collection of definitive

reference sources that describe all the details of the XSP tags and Java and

JavaScript classes. It also points to specification documents that define the

technologies that XPages consumes or extends.

剩余320页未读，继续阅读

choubiao

粉丝: 0
资源: 2

Mastering XPages：深入指南

精通XPages：应用程序开发实战指南

利用XPages赋能Lotus Domino应用开发

XPages权威指南：Web开发与XSP实践详解

domino xpages 文档状态改变.

domino xpages 开发 Repeat显示富域值.doc

domino xpages 开发 视图View過濾.docx

xpages培训

Mastering XPages

xpages jdbc

XPages 揭秘

最新资源

domino xpages 开发视图View過濾.docx