1. Chapter 1 Getting Started with JBoss

   1. Why "JBoss at Work"?

   2. Why JBoss?

   3. The Example: JAW Motors

   4. The Tools

   5. Installing JBoss

   6. Deploying Applications to JBoss

   7. Looking Ahead...

2. Chapter 2 Web Applications

   1. The Servlet Container

   2. Three-Tier Applications

   3. Exploring the Presentation Tier

   4. Building the View Cars Page

   5. Adding a Model and Controller

   6. Looking Ahead...

3. Chapter 3 Building and Deploying an EAR

   1. WARs Versus EARs

   2. Application.xml

   3. Common JAR

   4. Deploying the EAR

   5. Adding a DAO

   6. Using XDoclet

   7. Looking Ahead...

4. Chapter 4 Databases and JBoss

   1. Persistence Options

   2. JDBC

   3. JNDI

   4. JNDI References in web.xml

   5. JBoss DataSource Descriptors

   6. JDBC Driver JARs

   7. Database Checklist

   8. Accessing the Database Using Ant

   9. Creating JDBCCarDAO

   10. Looking Ahead...

5. Chapter 5 Hibernate and JBoss

   1. The Pros and Cons of ORMs

   2. Hibernate Mapping Files

   3. Hibernate MBean Service Descriptor

   4. Creating a HAR

   5. Adding the HAR to the EAR

   6. Creating a JNDI Lookup

   7. Hibernate Checklist

   8. HibernateCarDAO

   9. Adding a Car

   10. Editing a Car

   11. Deleting a Car

   12. Looking Ahead...

6. Chapter 6 Stateless Session Beans

   1. Issues with EJBs

   2. Should I Use EJB or Not?

   3. Business Tier

   4. Enterprise JavaBeans

   5. Our Example

   6. Iteration 1—Introduce a Session Bean

   7. Calling the Session Bean from the Controller Servlet

   8. EJB-Based JNDI References in Web-Based Deployment Descriptors

   9. Session Bean Types

   10. Session Beans

   11. Remote Versus Local EJB Calls

   12. Local and Remote Interfaces

   13. Home Interfaces

   14. Reviewing Iteration 1

   15. Testing Iteration 1

   16. Iteration 2—Move Business Logic Out of the Controller

   17. Reviewing Iteration 2

   18. Testing Iteration 2

   19. Iteration 3—Buy a Car

   20. The AccountingDTO

   21. Developing the HibernateAccountingDAO

   22. Adding buyCar() to the InventoryFacadeBean

   23. Reviewing Iteration 3

   24. Testing Iteration 3

   25. Final Thoughts on Session Beans

   26. Looking Ahead ...

7. Chapter 7 Java Message Service (JMS) and Message-Driven Beans

   1. Sending Messages with JMS

   2. Upgrade the Site: Running a Credit Check

   3. JMS Architecture Overview

   4. JMS Messaging Models

   5. Creating a Message

   6. Sending the Message

   7. Core JMS API

   8. Sending a JMS Message

   9. JMS-Based JNDI References in Web-Based Deployment Descriptors

   10. Deploying JMS Destinations on JBoss

   11. JMS Checklist

   12. Message-Driven Beans (MDBs)

   13. MDB Checklist

   14. Testing the Credit Check

   15. Looking Ahead ...

8. Chapter 8 JavaMail

   1. Running a Credit Check

   2. Sending Email Messages with JavaMail

   3. Upgrading the MDB to Send an Email Message

   4. Sending an Email Message

   5. JavaMail-Based JNDI References in EJB Deployment Descriptors

   6. Automating JavaMail-Based JNDI References with XDoclet

   7. Deploying JavaMail on JBoss

   8. JavaMail Checklist

   9. Testing the Credit Check Notification Email

   10. Looking Ahead ...

9. Chapter 9 Security

   1. J2EE Security

   2. Web-Based Security

   3. Restricting Access with web.xml

   4. JAAS

   5. Deploying a JAAS-Based Security Realm on JBoss

   6. Testing Secure JSPs

   7. Protecting the Administrative Actions

   8. Web Security Checklist

   9. Integrating Web Tier and EJB Tier Security

   10. EJB Security

   11. EJB Security Checklist

   12. Looking Ahead ...

10. Chapter 10 Web Services

    1. Web Services Architecture

    2. JBoss 4.x and Web Services

    3. J2EE 1.4 and Web Services

    4. Implementing J2EE 1.4 Web Services

    5. Service Endpoint Interface (SEI)

    6. Modifying ejb-jar.xml

    7. webservices.xml

    8. JAX-RPC Mapping File

    9. WSDL File

    10. Set the Web Service URL

    11. Modifying the InventoryFacadeBean EJB

    12. Web Services Deployment

    13. Automating Web Services Deployment

    14. J2EE Web Services Checklist

    15. Testing Web Services Deployment

    16. Web Services Client

    17. Implementing a Web Service Client

    18. Web Service Client Checklist

    19. Testing the Web Service Client

    20. Final Thoughts on J2EE 1.4 Web Services

    21. Conclusion

    22. Congratulations!

1. Appendix A ClassLoaders and JBoss

   1. Namespaces

   2. Class Loading in the J2EE

   3. Class Loading with JBoss

   4. Common ClassLoader Issues

   5. ClassLoader Options

   6. Solving ClassLoader Issues

   7. Conclusion

2. Appendix B Logging and JBoss

   1. Jakarta Commons Logging (JCL) API

   2. Apache Log4J

   3. Adding Application-Specific Properties to System Properties

   4. Configuring Log4J with a Configuration File

   5. Loading Resources from the CLASSPATH

   6. Logging Deployment

   7. Logging Checklist

   8. Testing Logging

   9. Conclusion

3. Appendix C JAAS Tutorial

   1. JAAS

   2. Client-Side JAAS

   3. Conclusion

4. Colophon

About the Authors

Tom Marrs, a 20-year veteran in the software industry, is the Principal and Senior Software Architect at Vertical Slice, a consulting firm that designs and implements mission-critical business applications using the latest J2EE and open source technologies, along with providing architecture evaluation and developer training and mentoring services. Tom teaches Java/J2EE/JBoss training classes, speaks regularly at software conferences such as No Fluff Just Stuff (http://www.nofluffjuststuff.com), and is a blogger on java.net and ONJava. An active participant in the local technical community, Tom is the President of the Denver JBoss User Group and has served as President of the Denver Java Users Group (http://www.denverjug.org).

Scott Davis is a senior software engineer in the Colorado front range. He is passionate about open source solutions and agile development. He has worked on a variety of Java platforms, from J2EE to J2SE to J2ME (sometimes all on the same project).

Scott is a frequent presenter at national conferences and local user groups. He was the president of the Denver Java Users Group in 2003 when it was voted one of the Top 10 JUGs in North America. After a quick move north, he is currently active in the leadership of the Boulder Java Users Group. Keep up with him at http://www.davisworld.org.

Colophon

Our look is the result of reader comments, our own experimentation, and feedback from distribution channels. Distinctive covers complement our distinctive approach to technical topics, breathing personality and life into potentially dry subjects.

The animal on the cover of JBoss at Work: A Practical Guide is a golden eagle (Aquila chrysaetos), named for the golden feathers on the back of its neck. This large bird of prey is one of the two eagle breeds found in the United States, inhabiting parts of the West as well as Canada, Alaska, Eurasia, and northern Africa. The golden eagle makes its home in desert grasslands and above the timberline. There it can stretch its wings (7 feet across) and go for a nice swoop at 200 mph, or catch a rising mass of warm air called a thermal and spiral upward into the sky. Golden eagles build large stick nests in trees or cliff walls. They may build multiple nests within a nesting range and alternate among them, depending on the year. Since golden eagles continually elaborate on their nests, the nests can grow quite large, reaching 8 to 10 feet across and 3 to 4 feet in depth. Both the male and female participate in the rearing of the eaglets, with the male doing most of the hunting and the female doing most of the incubating. If food is scarce, the larger of the eaglets may commit siblicide.

The young fledge when 72 to 84 days old and depend upon their parents for another 3 months. After this period they either migrate or move out of their parents' territory, but they generally winter in their natal area. At four years of age, golden eagles mate. They often stay paired with the same mate for life-about 30 years. Golden eagles are excellent hunters and for this reason are rarely forced to migrate far from their nesting territory. They feast on over 50 species of mammals, 48 birds, 5 reptiles, and 2 fish. Among these are included prairie dogs, rabbits, ground squirrels, grouse, ducks, chukars, marmots, foxes, skunks, cats, meadowlarks, and snakes. Golden eagles are protected in the U.S. through the U.S. Fish and Wildlife Service. Possessing a feather or any other body part belonging to this bird will incur a $10,000 fine or a jail term of up to 10 years. (There are some exceptions for Native American traditions.)

Colleen Gorman was the production editor and proofreader, and Ann Schirmer was the copyeditor for JBoss at Work: A Practical Guide. Jamie Peppard and Genevieve d'Entremont provided quality control. Loranah Dimant provided production assistance. Johnna VanHoose Dinse wrote the index.

Karen Montgomery designed the cover of this book, based on a series design by Edie Freedman. The cover image is a 19th-century engraving from Johnson's Natural History. Karen Montgomery produced the cover layout with Adobe InDesign CS using Adobe's ITC Garamond font.

David Futato designed the interior layout. This book was converted by Joe Wizda to FrameMaker 5.5.6 with a format conversion tool created by Erik Ray, Jason McIntosh, Neil Walls, and Mike Sierra that uses Perl and XML technologies. The text font is Linotype Birka; the heading font is Adobe Myriad Condensed; and the code font is LucasFont's TheSans Mono Condensed. The illustrations that appear in the book were produced by Robert Romano, Jessamyn Read, and Lesley Borash using Macromedia FreeHand MX and Adobe Photoshop CS. The tip and warning icons were drawn by Christopher Bing. This colophon was written by Lydia Onofrei.