Apache MyFaces Trinidad 1.2: A Practical Guide

Table of Contents

• Preface

• Chapter 1: Introducing Trinidad
  • Background
  • Overview of Trinidad
    • Characteristics of Trinidad
  • General key criteria for the choosing of Trinidad
  • Seamidad! Ease JSF development with Seam
    • Introduction and overview of Seam
    • Application of Seam with Trinidad
      • Seam conversations and other context management
      • Seam navigation
      • Seam authorization
      • Configuring Trinidad
  • Summary

• Chapter 2: Structuring and Building Pages with Facelets
  • Facelet page composition—templating with Facelets
    • Using the template
  • Facelet composition components
    • Creating the composition component
    • The model attribute
    • The visible attribute
    • The msgLabel attribute
    • The labelStyle attribute
    • The required attribute
    • The readOnly attribute
    • The width attribute
    • The margin attribute
    • Declaring the composition component
    • Applying the composition component
  • Using JSTL for further refinement
    • Typical JSTL structures
    • Things to be aware of when using JSTL and Facelets
      • Other tags to be aware of
      • Experiencing Facelets in real life projects
  • Summary

• Chapter 3: Most Wanted Tags and Tag Attributes
  • Component library structure
    • Trinidad’s XHTML tag library namespace (trh)
    • Trinidad’s core tag library namespace (tr)
  • Standard tag attributes
  • Standard tag attributes in tag groups
    • Attributes that occur in form and display tags
    • Attributes that occur in command and navigation components
    • Attributes that occur in large input and output components
      • The tag attributes for table, treeTable, and tree
      • The tag attributes for table and treeTable
      • The tag attributes for tree and treeTable
      • The tag attributes for treeTable
      • The tag attributes for tree
  • Summary

• Chapter 4: Rendering Pages Partially
  • Tag-based PPR
    • Finding the trigger
      • Aspect 1: Ensure that the ID of the PPR trigger is correct
      • Aspect 2: Ensure that the Trinidad configuration is correct
      • Aspect 3: Ensure that the refreshed fields are reset
      • Aspect 4: Ensure proper MVC setup
      • Aspect 5: Ensure that the tag's partialTriggers work
      • Aspect 6: Beware of using PPR with the rendered attribute
    • PPR with server-side caching by means of the Trinidad pageFlowScope
    • PPR with a tr:selectOneChoice to refresh itself inside a component
    • PPR with a tr:selectOneChoice component and a valueChangeListener
    • PPR with a tr:selectOneChoice component and an actionListener
    • PPR and the rendered attribute
      • Applying PPR naively
      • The right way—a parent component with partial trigger
  • Java-side PPR using Trinidad's RequestContext
    • Application of PPR from the Java-side
      • Step I: Define the PPR source
      • Step II: Add the partial target
  • Summary

• Chapter 5: Web Application Groundwork
  • Navigation
  • Trinidad's Dialog Framework
    • Programmatically creating a dialog
    • Providing the data flow from dialog to dialog
    • Returning from a dialog
  • Authorization
    • Equipping each XHTML with authorization
    • User authorization
  • Internationalization (I18n)
    • I18n on single labels
    • I18n on internal Facelet composition components
  • Polling
  • Setting up the application with Seam-gen
    • Setting up an Eclipse project using Seam-gen
  • Deployment
    • Trinidad-specific and Facelet-related changes to the project files
    • Trinidad-specific changes to the Ant build script
    • Deployment from Eclipse
  • Browser client setup
  • Summary

• Chapter 6: Building a Panel-based Content
  • Where the Trinidad panel components live and what they support
  • The accordion and showDetailItem components
    • How to play the panelAccordion
    • The showDetailItem component—press to play an accordion key
  • The combination of accordion and showDetailItem
    • An alternative to pure Facelets
    • The content panel—same soul, different incarnation
    • ControllerPanel keeps the panels under the same roof
    • The toolbar facet
  • Skinning the panels
    • Skinning the accordion and its children
    • Skinning specific properties of the accordion's children
    • Switching the skins on configuration level
  • Summary

• Chapter 7: Building a Form
  • Building a form
    • Step I: Building the composition components
      • The fieldText component
      • The fieldDate component
      • The fieldNumber component
      • The fieldSelect component
    • Step II: Building the form
      • Building a form with several panelFormLayout instances
      • The approach
    • Step III: Decorating the form with Trinidad's form submission controls
      • Processing of a part of a form by means of Trinidad subforms
    • Step IV: Adding a general message area
  • Summary

• Chapter 8: Growing a Tree
  • Trinidad's tree components
  • ChildPropertyTreeModel—Trinidad's out of the box model
  • Creating a TreeNode Model
  • Building up a tree model
    • Extending the ChildPropertyTreeModel to a Seam component
    • Preparing the panels for navigation
    • Applying the navigation component for basic navigation control
  • Creating the XHTML
    • Using the nodeStamp facet to generate the tree
    • Using a commandLink to create the clickable tree node
    • Passing the node parameters to the navigation control
  • Extending the model-view tree couple
    • Preparations for the new tree model
      • The properties of the AbstractTreeNode
      • The AbstractTreeNode constructors
      • New and modified helper methods
      • The abstracted getters and setters
      • The new TreeNode implementation is now short and easy
      • The new tree node implementation for the new tree model
    • The new tree model—based on Trinidad's abstract TreeModel
      • Test out the row disclosure by adding a RowDisclosureEvent listener
      • Another tree content to better try tree traversal
      • The getters to access the new state
      • Tree traversal with Trinidad's container methods
    • The controller-enhanced tree models
    • Testing internal navigation
  • Summary

• Chapter 9: The table and treeTable Components
  • The table component
    • The table component in its most minimal usage
    • Adding a selection listener
    • Adding sorting
    • Adding a button bar
    • Adding detail data sub views and using a POJO data model
    • Adding a search form and paging
    • Adding banding and grids for better visibility
    • Making use of JSF binding and Facelets for further encapsulation
      • Creating the XHTML: the reduction to a single line
  • The treeTable component
    • The treeTable component in its most minimal usage
    • Adding major table capabilities
  • Summary

• Chapter 10: The Chart Component
  • Where the chart component is and what it supports
    • Bar charts
      • Stacking the bar chart
    • Pie charts
    • Area charts
    • Line charts
    • ScatterPlot charts
    • Radar charts
    • Funnel charts
    • Gauge charts
  • Summary

• Chapter 11: Building a Wizard
  • Defining an abstract wizard model
    • The properties of the abstract wizard model
    • Constructors of the abstract wizard
    • Providing the current step, action, and actionListener methods
    • Providing control for the number of wizard steps
    • Providing control for the current step index
    • Providing step incrementation and decrementation
    • Abstract class design aspects
  • Defining the concrete wizard
    • Implementing the wizard's action listeners
    • Implementing the wizard's navigation
    • Implementing a step object
    • Initializing a wizard instance
    • The wizard's application inside the preparation controller
    • Wizard implementation design aspects
  • Defining the XHTML side—the wizard's face
  • Summary

• Chapter 12: Dialogs—Pop-Up Your Web Application!
  • Using the right scope: Seam or only Trinidad
    • How the conversation is kept during a Trinidad dialog
  • Defining a dialog-enabled navigation control
    • Creating Trinidad dialogs in the navigation control
    • Ensuring correct partial page rendering
    • Standard context retrieval methods
    • Calling the proper preparation method
    • The resulting navigation point
  • Making a dialog-enabled tree control
    • Creating concrete tree contents
      • Standard tree methods
      • Providing navigational attributes
    • The tree's navigation method
  • Revisiting the wizard—few additions make it pop-up
  • Summary

• Appendix: References
  • Links to the Apache MyFaces Trinidad web site
  • References
    • Chapter 1
    • Chapter 2
    • Chapter 3
    • Chapter 4
    • Chapter 5
    • Chapter 6
    • Chapter 7
    • Chapter 8
    • Chapter 9
    • Chapter 10
    • Chapter 11
    • Chapter 12

• Index

David Thomas

This book is a good introduction to Apache MyFaces Trinidad 1.2 and I'd agree taht the book is written forJava Developers, who are beginners at JSF and experienced web developers,who are looking for an introduction into the world of open source JSF technology.

Code Downloads

Download the code and support files for this book.

Submit Errata

Please let us know if you have found any errors not listed on this list by completing our errata submission form. Our editors will check them and add them to this list. Thank you.

Sample chapters

You can view our sample chapters and prefaces of this title on PacktLib or download sample chapters in PDF format.