Java EE 7 Tutorial, The, Volume 1

<p>Preface xxix</p> <p>Part I: Introduction 1</p> <p>Chapter 1: Overview 3</p> <p>1.1 Java EE 7 Platform Highlights 4</p> <p>1.2 Java EE Application Model 5</p> <p>1.3 Distributed Multitiered Applications 6</p> <p>1.4 Java EE Containers 13</p> <p>1.5 Web Services Support 15</p> <p>1.6 Java EE Application Assembly and Deployment 17</p> <p>1.7 Development Roles 17</p> <p>1.8 Java EE 7 APIs 20</p> <p>1.9 Java EE 7 APIs in the Java Platform, Standard Edition 7 30</p> <p>1.10 GlassFish Server Tools 33</p> <p><strong>Chapter 2: Using the Tutorial Examples 35</strong></p> <p>2.1 Required Software 35</p> <p>2.2 Starting and Stopping GlassFish Server 39</p> <p>2.3 Starting the Administration Console. 40</p> <p>2.4 Starting and Stopping the Java DB Server 40</p> <p>2.5 Building the Examples 41</p> <p>2.6 Tutorial Example Directory Structure 41</p> <p>2.7 Java EE 7 Maven Archetypes in the Tutorial 42</p> <p>2.8 Getting the Latest Updates to the Tutorial 43</p> <p>2.9 Debugging Java EE Applications 44</p> <p>Part II: Platform Basics 47</p> <p>Chapter 3: Resource Creation 49</p> <p>3.1 Resources and JNDI Naming 49</p> <p>3.2 DataSource Objects and Connection Pools 50</p> <p>3.3 Creating Resources Administratively 51</p> <p><strong>Chapter 4: Injection 53</strong></p> <p>4.1 Resource Injection 53</p> <p>4.2 Dependency Injection 54</p> <p>4.3 The Main Differences between Resource Injection and Dependency Injection 55</p> <p><strong>Chapter 5: Packaging 57</strong></p> <p>5.1 Packaging Applications 57</p> <p>5.2 Packaging Enterprise Beans 59</p> <p>5.3 Packaging Web Archives 61</p> <p>5.4 Packaging Resource Adapter Archives 63</p> <p>Part III: The Web Tier 65</p> <p>Chapter 6: Getting Started with Web Applications 67</p> <p>6.1 Web Applications 68</p> <p>6.2 Web Application Lifecycle 69</p> <p>6.3 A Web Module That Uses JavaServer Faces Technology: The hello1 Example 70</p> <p>6.4 A Web Module That Uses Java Servlet Technology: The hello2 Example 77</p> <p>6.5 Configuring Web Applications 81</p> <p>6.6 Further Information about Web Applications 86</p> <p><strong>Chapter 7: JavaServer Faces Technology 87</strong></p> <p>7.1 What Is a JavaServer Faces Application? 88</p> <p>7.2 JavaServer Faces Technology Benefits 89</p> <p>7.3 A Simple JavaServer Faces Application 91</p> <p>7.4 User Interface Component Model 92</p> <p>7.5 Navigation Model 100</p> <p>7.6 The Lifecycle of a JavaServer Faces Application 103</p> <p>7.7 Partial Processing and Partial Rendering 110</p> <p>7.8 Further Information about JavaServer Faces Technology 110</p> <p><strong>Chapter 8: Introduction to Facelets 111</strong></p> <p>8.1 What Is Facelets? 112</p> <p>8.2 The Lifecycle of a Facelets Application 114</p> <p>8.3 Developing a Simple Facelets Application: The guessnumber-jsf Example Application 115</p> <p>8.4 Using Facelets Templates 121</p> <p>8.5 Composite Components 124</p> <p>8.6 Web Resources 127</p> <p>8.7 Relocatable Resources 128</p> <p>8.8 Resource Library Contracts 128</p> <p>8.9 HTML5-Friendly Markup 132</p> <p><strong>Chapter 9: Expression Language 141</strong></p> <p>9.1 Overview of the EL 141</p> <p>9.2 Immediate and Deferred Evaluation Syntax 142</p> <p>9.3 Value and Method Expressions 144</p> <p>9.4 Operations on Collection Objects 151</p> <p>9.5 Operators 153</p> <p>9.6 Reserved Words 154</p> <p>9.7 Examples of EL Expressions 154</p> <p>9.8 Further Information about the Expression Language 155</p> <p><strong>Chapter 10: Using JavaServer Faces Technology in Web Pages 157</strong></p> <p>10.1 Setting Up a Page 158</p> <p>10.2 Adding Components to a Page Using HTML Tag Library Tags 159</p> <p>10.3 Using Core Tags 192</p> <p><strong>Chapter 11: Using Converters, Listeners, and Validators </strong> 197</p> <p>11.1 Using the Standard Converters 198</p> <p>11.2 Registering Listeners on Components 203</p> <p>11.3 Using the Standard Validators 207</p> <p>11.4 Referencing a Managed Bean Method 209</p> <p><strong>Chapter 12: Developing with JavaServer Faces Technology </strong> 213</p> <p>12.1 Managed Beans in JavaServer Faces Technology 213</p> <p>12.2 Writing Bean Properties 216</p> <p>12.3 Writing Managed Bean Methods 226</p> <p><strong>Chapter 13: Using Ajax with JavaServer Faces Technology 231</strong></p> <p>13.1 Overview of Ajax 232</p> <p>13.2 Using Ajax Functionality with JavaServer Faces Technology 233</p> <p>13.3 Using Ajax with Facelets 233</p> <p>13.4 Sending an Ajax Request 236</p> <p>13.5 Monitoring Events on the Client 238</p> <p>13.6 Handling Errors 238</p> <p>13.7 Receiving an Ajax Response 239</p> <p>13.8 Ajax Request Lifecycle 240</p> <p>13.9 Grouping of Components 240</p> <p>13.10 Loading JavaScript as a Resource 241</p> <p>13.11 The ajaxguessnumber Example Application 243</p> <p>13.12 Further Information about Ajax in JavaServer Faces Technology 247</p> <p><strong>Chapter 14: Composite Components: Advanced Topics and an Example 249</strong></p> <p>14.1 Attributes of a Composite Component 249</p> <p>14.2 Invoking a Managed Bean 251</p> <p>14.3 Validating Composite Component Values 251</p> <p>14.4 The compositecomponentexample Example Application 251</p> <p><strong>Chapter 15: Creating Custom UI Components and Other Custom Objects 257</strong></p> <p>15.1 Determining Whether You Need a Custom Component or Renderer 259</p> <p>15.2 Understanding the Image Map Example 262</p> <p>15.3 Steps for Creating a Custom Component 268</p> <p>15.4 Creating Custom Component Classes 268</p> <p>15.5 Delegating Rendering to a Renderer 278</p> <p>15.6 Implementing an Event Listener 281</p> <p>15.7 Handling Events for Custom Components 283</p> <p>15.8 Defining the Custom Component Tag in a Tag Library Descriptor 284</p> <p>15.9 Using a Custom Component 285</p> <p>15.10 Creating and Using a Custom Converter 287</p> <p>15.11 Creating and Using a Custom Validator 292</p> <p>15.12 Binding Component Values and Instances to Managed Bean Properties 298</p> <p>15.13 Binding Converters, Listeners, and Validators to Managed Bean Properties 303</p> <p><strong>Chapter 16: Configuring JavaServer Faces Applications 305</strong></p> <p>16.1 Using Annotations to Configure Managed Beans 306</p> <p>16.2 Application Configuration Resource File 307</p> <p>16.3 Using Faces Flows 311</p> <p>16.4 Configuring Managed Beans 323</p> <p>16.5 Registering Application Messages 332</p> <p>16.6 Using Default Validators 335</p> <p>16.7 Registering a Custom Validator 336</p> <p>16.8 Registering a Custom Converter 337</p> <p>16.9 Configuring Navigation Rules 337</p> <p>16.10 Registering a Custom Renderer with a Render Kit 340</p> <p>16.11 Registering a Custom Component 342</p> <p>16.12 Basic Requirements of a JavaServer Faces Application 343</p> <p><strong>Chapter 17: Java Servlet Technology 351</strong></p> <p>17.1 What Is a Servlet? 352</p> <p>17.2 Servlet Lifecycle 352</p> <p>17.3 Sharing Information 354</p> <p>17.4 Creating and Initializing a Servlet 356</p> <p>17.5 Writing Service Methods 356</p> <p>17.6 Filtering Requests and Responses 359</p> <p>17.7 Invoking Other Web Resources 363</p> <p>17.8 Accessing the Web Context 365</p> <p>17.9 Maintaining Client State 365</p> <p>17.10 Finalizing a Servlet 367</p> <p>17.11 Uploading Files with Java Servlet Technology 370</p> <p>17.12 Asynchronous Processing 372</p> <p>17.13 Nonblocking I/O 375</p> <p>17.14 Protocol Upgrade Processing 378</p> <p>17.15 The mood Example Application 381</p> <p>17.16 The fileupload Example Application 383</p> <p>17.17 The dukeetf Example Application 388</p> <p>17.18 Further Information about Java Servlet Technology 394</p> <p><strong>Chapter 18: Java API for WebSocket 395</strong></p> <p>18.1 Introduction to WebSocket 396</p> <p>18.2 Creating WebSocket Applications in the Java EE Platform 397</p> <p>18.3 Programmatic Endpoints 398</p> <p>18.4 Annotated Endpoints 399</p> <p>18.5 Sending and Receiving Messages 400</p> <p>18.6 Maintaining Client State 402</p> <p>18.7 Using Encoders and Decoders 403</p> <p>18.8 Path Parameters 406</p> <p>18.9 Handling Errors 407</p> <p>18.10 Specifying an Endpoint Configurator Class 407</p> <p>18.11 The dukeetf2 Example Application 408</p> <p>18.12 The websocketbot Example Application 413</p> <p>18.13 Further Information about WebSocket 420</p> <p><strong>Chapter 19: JSON Processing 421</strong></p> <p>19.1 Introduction to JSON 421</p> <p>19.2 JSON Processing in the Java EE Platform 423</p> <p>19.3 Using the Object Model API 425</p> <p>19.4 Using the Streaming API 429</p> <p>19.5 JSON in Java EE RESTful Web Services 431</p> <p>19.6 The jsonpmodel Example Application 432</p> <p>19.7 The jsonpstreaming Example Application 434</p> <p>19.8 Further Information about the Java API for JSON Processing 436</p> <p><strong>Chapter 20: Internationalizing and Localizing Web Applications 437</strong></p> <p>20.1 Java Platform Localization Classes 437</p> <p>20.2 Providing Localized Messages and Labels 438</p> <p>20.3 Date and Number Formatting 441</p> <p>20.4 Character Sets and Encodings 442</p> <p>Part IV: Bean Validation 445</p> <p>Chapter 21: Introduction to Bean Validation 447</p> <p>21.1 Using Bean Validation Constraints 447</p> <p>21.2 Validating Null and Empty Strings 450</p> <p>21.3 Validating Constructors and Methods 451</p> <p>21.4 Further Information about Bean Validation 454</p> <p><strong>Chapter 22: Bean Validation: Advanced Topics 455</strong></p> <p>22.1 Creating Custom Constraints 455</p> <p>22.2 Customizing Validator Messages 457</p> <p>22.3 Grouping Constraints 457</p> <p>22.4 Using Method Constraints in Type Hierarchies 458</p> <p>Part V: Contexts and Dependency Injection for Java EE 461</p> <p>Chapter 23: Introduction to Contexts and Dependency Injection for Java EE 463</p> <p>23.1 Getting Started 464</p> <p>23.2 Overview of CDI 466</p> <p>23.3 About Beans 467</p> <p>23.4 About CDI Managed Beans 468</p> <p>23.5 Beans as Injectable Objects 468</p> <p>23.6 Using Qualifiers 469</p> <p>23.7 Injecting Beans 470</p> <p>23.8 Using Scopes 471</p> <p>23.9 Giving Beans EL Names 473</p> <p>23.10 Adding Setter and Getter Methods 473</p> <p>23.11 Using a Managed Bean in a Facelets Page 474</p> <p>23.12 Injecting Objects by Using Producer Methods 474</p> <p>23.13 Configuring a CDI Application 475</p> <p>23.14 Using the @PostConstruct and @PreDestroy Annotations with CDI Managed Bean Classes 476</p> <p>23.15 Further Information about CDI 477</p> <p><strong>Chapter 24: Running the Basic Contexts and Dependency Injection Examples 479</strong></p> <p>24.1 The simplegreeting CDI Example 479</p> <p>24.2 The guessnumber-cdi CDI Example 483</p> <p><strong>Chapter 25: Contexts and Dependency Injection for Java EE: Advanced Topics 493</strong></p> <p>25.1 Packaging CDI Applications 493</p> <p>25.2 Using Alternatives in CDI Applications 494</p> <p>25.3 Using Producer Methods, Producer Fields, and Disposer Methods in CDI Applications 497</p> <p>25.4 Using Predefined Beans in CDI Applications 499</p> <p>25.5 Using Events in CDI Applications 501</p> <p>25.6 Using Interceptors in CDI Applications 504</p> <p>25.7 Using Decorators in CDI Applications 506</p> <p>25.8 Using Stereotypes in CDI Applications 507</p> <p><strong>Chapter 26: Running the Advanced Contexts and Dependency Injection Examples 511</strong></p> <p>26.1 The encoder Example: Using Alternatives 511</p> <p>26.2 The producermethods Example: Using a Producer Method to Choose a Bean Implementation 517</p> <p>26.3 The producerfields Example: Using Producer Fields to Generate Resources 520</p> <p>26.4 The billpayment Example: Using Events and Interceptors 527</p> <p>26.5 The decorators Example: Decorating a Bean 535</p> <p>Part VI: Web Services 539</p> <p>Chapter 27: Introduction to Web Services 541</p> <p>27.1 What Are Web Services? 541</p> <p>27.2 Types of Web Services 541</p> <p>27.3 Deciding Which Type of Web Service to Use 544</p> <p><strong>Chapter 28: Building Web Services with JAX-WS 545</strong></p> <p>28.1 Creating a Simple Web Service and Clients with JAX-WS 546</p> <p>28.2 Types Supported by JAX-WS 555</p> <p>28.3 Web Services Interoperability and JAX-WS 557</p> <p>28.4 Further Information about JAX-WS 558</p> <p><strong>Chapter 29: Building RESTful Web Services with JAX-RS 559</strong></p> <p>29.1 What Are RESTful Web Services? 559</p> <p>29.2 Creating a RESTful Root Resource Class 561</p> <p>29.3 Example Applications for JAX-RS 578</p> <p>29.4 Further Information about JAX-RS 583</p> <p><strong>Chapter 30: Accessing REST Resources with the JAX-RS Client API 585</strong></p> <p>30.1 Overview of the Client API 585</p> <p>30.2 Using the Client API in the JAX-RS Example Applications 589</p> <p>30.3 Advanced Features of the Client API 592</p> <p><strong>Chapter 31: JAX-RS: Advanced Topics and an Example 597</strong></p> <p>31.1 Annotations for Field and Bean Properties of Resource Classes 598</p> <p>31.2 Validating Resource Data with Bean Validation 601</p> <p>31.3 Subresources and Runtime Resource Resolution 604</p> <p>31.4 Integrating JAX-RS with EJB Technology and CDI 606</p> <p>31.5 Conditional HTTP Requests 608</p> <p>31.6 Runtime Content Negotiation 609</p> <p>31.7 Using JAX-RS with JAXB 611</p> <p>31.8 The customer Example Application 618</p> <p>Index 627</p>