English
资源说明：Table of Contents
Preface
1
Chapter 1: Introducing Trinidad
7
Background
7
Overview of Trinidad
9
Characteristics of Trinidad
9
General key criteria for the choosing of Trinidad
10
Seamidad! Ease JSF development with Seam
13
Introduction and overview of Seam
13
Application of Seam with Trinidad
14
Seam conversations and other context management
16
Seam navigation
17
Seam authorization
18
Configuring Trinidad
24
Summary
28
Chapter 2: Structuring and Building Pages with Facelets
29
Facelet page composition—templating with Facelets
30
Using the template
34
Facelet composition components
36
Creating the composition component
37
The model attribute
38
The visible attribute
39
The msgLabel attribute
39
The labelStyle attribute
40
The required attribute
40
The readOnly attribute
41
The width attribute
41
The margin attribute
41
Declaring the composition component
42
Applying the composition component
43
This material is copyright and is licensed for the sole use by Jillian Fraser on 20th November 2009
111 Sutter Street, Suite 1800, San Francisco, , 94104
Download at WoweBook.Com
Table of Contents
[ ii ]
Using JSTL for further refinement
45
Typical JSTL structures
45
Things to be aware of when using JSTL and Facelets
47
Other tags to be aware of
48
Experiencing Facelets in real life projects
48
Summary
49
Chapter 3: Most Wanted Tags and Tag Attributes
51
Component library structure
51
Trinidad’s XHTML tag library namespace (trh)
53
Trinidad’s core tag library namespace (tr)
54
Standard tag attributes
57
Standard tag attributes in tag groups
58
Attributes that occur in form and display tags
58
Attributes that occur in command and navigation components
60
Attributes that occur in large input and output components
60
The tag attributes for table, treeTable, and tree
61
The tag attributes for table and treeTable
61
The tag attributes for tree and treeTable
62
The tag attributes for treeTable
63
The tag attributes for tree
63
Summary
63
Chapter 4: Rendering Pages Partially
65
Tag-based PPR
66
Finding the trigger
67
Aspect 1: Ensure that the ID of the PPR trigger is correct
68
Aspect 2: Ensure that the Trinidad configuration is correct
68
Aspect 3: Ensure that the refreshed fields are reset
69
Aspect 4: Ensure proper MVC setup
69
Aspect 5: Ensure that the tag's partialTriggers work
70
Aspect 6: Beware of using PPR with the rendered attribute
70
PPR with server-side caching by means of the Trinidad pageFlowScope
70
PPR with a tr:selectOneChoice to refresh itself inside a component
71
PPR with a tr:selectOneChoice component and a valueChangeListener
73
PPR with a tr:selectOneChoice component and an actionListener
76
PPR and the rendered attribute
79
Applying PPR naively
79
The right way—a parent component with partial trigger
81
Java-side PPR using Trinidad's RequestContext
82
Application of PPR from the Java-side
83
Step I: Define the PPR source
84
Step II: Add the partial target
84
Summary
85
This material is copyright and is licensed for the sole use by Jillian Fraser on 20th November 2009
111 Sutter Street, Suite 1800, San Francisco, , 94104
Download at WoweBook.Com
Table of Contents
[ iii ]
Chapter 5: Web Application Groundwork
87
Navigation
87
Trinidad's Dialog Framework
90
Programmatically creating a dialog
91
Providing the data flow from dialog to dialog
91
Returning from a dialog
92
Authorization
93
Equipping each XHTML with authorization
93
User authorization
94
Internationalization (I18n)
95
I18n on single labels
95
I18n on internal Facelet composition components
95
Polling
96
Setting up the application with Seam-gen
97
Setting up an Eclipse project using Seam-gen
99
Deployment
101
Trinidad-specific and Facelet-related changes to the project files
102
Trinidad-specific changes to the Ant build script
105
Deployment from Eclipse
106
Browser client setup
109
Summary
111
Chapter 6: Building a Panel-based Content
113
Where the Trinidad panel components live and what they support
113
The accordion and showDetailItem components
115
How to play the panelAccordion
115
The showDetailItem component—press to play an accordion key
116
The combination of accordion and showDetailItem
120
An alternative to pure Facelets
122
The content panel—same soul, different incarnation
123
ControllerPanel keeps the panels under the same roof
124
The toolbar facet
125
Skinning the panels
128
Skinning the accordion and its children
128
Skinning specific properties of the accordion's children
130
Switching the skins on configuration level
130
Summary
132
Chapter 7: Building a Form
133
Building a form
134
Step I: Building the composition components
135
The fieldText component
135
This material is copyright and is licensed for the sole use by Jillian Fraser on 20th November 2009
111 Sutter Street, Suite 1800, San Francisco, , 94104
Download at WoweBook.Com
Table of Contents
[ iv ]
The fieldDate component
137
The fieldNumber component
139
The fieldSelect component
142
Step II: Building the form
143
Building a form with several panelFormLayout instances
145
The approach
146
Step III: Decorating the form with Trinidad's form submission controls
148
Processing of a part of a form by means of Trinidad subforms
149
Step IV: Adding a general message area
152
Summary
152
Chapter 8: Growing a Tree
153
Trinidad's tree components
153
ChildPropertyTreeModel—Trinidad's out of the box model
155
Creating a TreeNode Model
155
Building up a tree model
157
Extending the ChildPropertyTreeModel to a Seam component
158
Preparing the panels for navigation
159
Applying the navigation component for basic navigation control
160
Creating the XHTML
161
Using the nodeStamp facet to generate the tree
161
Using a commandLink to create the clickable tree node
162
Passing the node parameters to the navigation control
162
Extending the model-view tree couple
163
Preparations for the new tree model
164
The properties of the AbstractTreeNode
164
The AbstractTreeNode constructors
164
New and modified helper methods
165
The abstracted getters and setters
166
The new TreeNode implementation is now short and easy
166
The new tree node implementation for the new tree model
167
The new tree model—based on Trinidad's abstract TreeModel
168
Test out the row disclosure by adding a RowDisclosureEvent listener
169
Another tree content to better try tree traversal
169
The getters to access the new state
170
Tree traversal with Trinidad's container methods
171
The controller-enhanced tree models
175
Testing internal navigation
176
Summary
177
Chapter 9: The table and treeTable Components
179
The table component
179
The table component in its most minimal usage
180
Adding a selection listener
182
This material is copyright and is licensed for the sole use by Jillian Fraser on 20th November 2009
111 Sutter Street, Suite 1800, San Francisco, , 94104
Download at WoweBook.Com
Table of Contents
[ v ]
Adding sorting
184
Adding a button bar
185
Adding detail data sub views and using a POJO data model
186
Adding a search form and paging
188
Adding banding and grids for better visibility
191
Making use of JSF binding and Facelets for further encapsulation
191
Creating the XHTML: the reduction to a single line
194
The treeTable component
195
The treeTable component in its most minimal usage
195
Adding major table capabilities
196
Summary
200
Chapter 10: The Chart Component
201
Where the chart component is and what it supports
201
Bar charts
202
Stacking the bar chart
205
Pie charts
207
Area charts
209
Line charts
211
ScatterPlot charts
214
Radar charts
215
Funnel charts
219
Gauge charts
219
Summary
221
Chapter 11: Building a Wizard
223
Defining an abstract wizard model
223
The properties of the abstract wizard model
223
Constructors of the abstract wizard
224
Providing the current step, action, and actionListener methods
225
Providing control for the number of wizard steps
226
Providing control for the current step index
226
Providing step incrementation and decrementation
227
Abstract class design aspects
227
Defining the concrete wizard
228
Implementing the wizard's action listeners
228
Implementing the wizard's navigation
229
Implementing a step object
230
Initializing a wizard instance
230
The wizard's application inside the preparation controller
231
Wizard implementation design aspects
232
This material is copyright and is licensed for the sole use by Jillian Fraser on 20th November 2009
111 Sutter Street, Suite 1800, San Francisco, , 94104
Download at WoweBook.Com
Table of Contents
[ vi ]
Defining the XHTML side—the wizard's face
234
Summary
237
Chapter 12: Dialogs—Pop-Up Your Web Application!
239
Using the right scope: Seam or only Trinidad
240
How the conversation is kept during a Trinidad dialog
242
Defining a dialog-enabled navigation control
243
Creating Trinidad dialogs in the navigation control
244
Ensuring correct partial page rendering
245
Standard context retrieval methods
247
Calling the proper preparation method
248
The resulting navigation point
249
Making a dialog-enabled tree control
251
Creating concrete tree contents
252
Standard tree methods
253
Providing navigational attributes
254
The tree's navigation method
254
Revisiting the wizard—few additions make it pop-up
256
Summary
258
Appendix: References
259
Links to the Apache MyFaces Trinidad web site
259
References
260
Chapter 1
260
Chapter 2
260
Chapter 3
261
Chapter 4
261
Chapter 5
261
Chapter 6
261
Chapter 7
262
Chapter 8
262
Chapter 9
262
Chapter 10
262
Chapter 11
263
Chapter 12
263
Index
265
本源码包内暂不包含可直接显示的源代码文件，请下载源码包。
