Pro Spring MVC: With Web Flow

589 Pages·2012·16.189 MB·English

by  Marten Deinum, Koen Serneels, Colin Yates, Seth Ladd, Christophe Vanfleteren (auth.)

Pro Spring MVC:
With Web Flow
Marten Deinum
Koen Serneels
with Colin Yates, Seth Ladd,
and Christophe Vanfleteren
Foreword by Erwin Vervaet,
Spring Web Flow project founder
Apress~
Pro Spring MVC
Copyright © 2012 by Marten Deinum and Koen Serneels with Colin Yates, Seth Ladd, and Christophe Vanfleteren
This work is subject to copyright. All rights are reserved by the Publisher, whether the whole or part ofthe material is
concerned, specifically the rights of translation, reprinting, reuse of illustrations, recitation, broadcasting,
reproduction on microfilms or in any other physical way, and transmission or information storage and retrieval,
electronic adaptation, computer software, or by similar or dissimilar methodology now known or hereafter
developed. Exempted from this legal reservation are brief excerpts in connection with reviews or scholarly analysis or
material supplied specifically for the purpose of being entered and executed on a computer system, for exclusive use
by the purchaser of the work. Duplication ofthis publication or parts thereof is permitted only under the provisions of
the Copyright Law ofthe Publisher's location, in its current version, and permission for use must always be obtained
from Springer. Permissions for use may be obtained through RightsLink at the Copyright Clearance Center. Violations
are liable to prosecution under the respective Copyright Law.
ISBN 978-1-4302-4155-3
ISBN 978-1-4302-4156-0 (eBook)
Trademarked names, logos, and images may appear in this book. Rather than use a trademark symbol with every
occurrence of a trademarked name, logo, or image we use the names, logos, and images only in an editorial fashion
and to the benefit ofthe trademark owner, with no intention of infringement ofthe trademark.
The use in this publication of trade names, trademarks, service marks, and similar terms, even if they are not
identified as such, is not to be taken as an expression of opinion as to whether or not they are subject to proprietary
rights.
While the advice and information in this book are believed to be true and accurate at the date of publication, neither
the authors nor the editors nor the publisher can accept any legal responsibility for any errors or omissions that may
be made. The publisher makes no warranty, express or implied, with respect to the material contained herein.
President and Publisher: Paul Manning
Lead Editor: Steve Anglin
Technical Reviewers: Manuel Jordan
Editorial Board: Steve Anglin, Ewan Buckingham, Gary Cornell, Louise Corrigan, Morgan Ertel, Jonathan
Gennick, Jonathan Hassell, Robert Hutchinson, Michelle Lowman, James Markham, Matthew Moodie, Jeff
Olson, Jeffrey Pepper, Douglas Pundick, Ben Renow-Clarke, Dominic Shakeshaft, Gwenan Spearing, Matt
Wade, Tom Welsh
Coordinating Editor: Jennifer L. Blackwell and Stephen Moles
Copy Editors: Patrick Meader and James Compton
Compositor: Bytheway Publishing Services
Indexer: SPi Global
Artist: SPi Global
Cover Designer: Anna Ishchenko
Distributed to the book trade worldwide by Springer Science+Business Media New York, 233 Spring Street, 6th Floor,
New York, NY 10013. Phone 1-800-SPRINGER, fax [phone], e-mail [email protected], or visit
www.springeronline.com.
For information on translations, please e-mail [email protected], or visit www.apress.com.
Apress and friends of ED books may be purchased in bulk for academic, corporate, or promotional use. eBook
versions and licenses are also available for most titles. For more information, reference our Special Bulk Sales-eBook
Licensing web page at www.apress.com/bulk-sales.
Any source code or other supplementary materials referenced by the author in this text is available to readers at
www.apress.com. For detailed information about how to locate your book's source code, go to
www.apress.com/source-code.
To my wife for your love and endless support.
-Marten Deinum
To Sonja Korte, die grofle liebe meines lebens, thank you for your patience and support. You
almost made me believe in automatically refilling coffee mugs. To mum and dad, for always
being there for me and buying an 80386 instead of that 8bit NBS.
-Koen Serneels
Contents at a Glance
II Foreword .............................................................................................................. xvi
II About the Authors .............................................................................................. xviii
II About the Technical Reviewer .............................................................................. xx
II Acknowledgments ............................................................................................... xxi
II Introduction ....................................................................................................... xxiii
• Chapter 1: Configuring a Spring Development Environment ................................. 1
• Chapter 2: Spring Framework Fundamentals ....................................................... 25
II Chapter 3: Web Application Architecture .............................................................. 51
II Chapter 4: Spring MVC Architecture ..................................................................... 65
II Chapter 5: Implementing Controllers .................................................................. 107
• Chapter 6: Implementing Controllers - Advanced ............................................ 177
II Chapter 7: REST and AJAX •••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••• 215
• Chapter 8: Resolving and Implementing Views .................................................. 237
• Chapter 9: Testing Spring MVC Applications ...................................................... 273
II Chapter 10: Spring Web Flow ............................................................................. 321
• Chapter 11: Building Applications with Spring Web Flow ................................. 373
II Chapter 12: Advanced Spring Web Flow ............................................................. 429
• Chapter 13: Spring Security ................................................................................ 477
• Appendix: Cloud Foundry: Deploying to the Cloud ............................................. 535
• Index ................................................................................................................... 555
iv
Contents
II Foreword .............................................................................................................. xvi
II About the Authors .............................................................................................. xviii
II About the Technical Reviewer .............................................................................. xx
II Acknowledgments ............................................................................................... xxi
II Introduction ....................................................................................................... xxiii
• Chapter 1: Configuring a Spring Development Environment ................................. 1
Prerequisites ...................................................................................................................... 1
Java Development Kit ............................................................................................................................... 2
Servlet Container ...................................................................................................................................... 2
Integrated Development Environment ...................................................................................................... 2
The Sample Application ..................................................................................................... 2
A Bookstore Sample Application .............................................................................................................. 3
The Build System ...................................................................................................................................... 4
Building the Sample Application ............................................................................................................... 6
Deploying the Sample Application ............................................................................................................ 8
SpringSource Tool Suite (STS) ......................................................................................... 10
Configuring STS for Gradle projects ....................................................................................................... 10
Importing the Sample into STS ............................................................................................................... 12
Running the Application on the SpringSource vFabric tc Server ............................................................ 17
Editing the Application ............................................................................................................................ 19
Summary ......................................................................................................................... 22
v
• CONTENTS
• Chapter 2: Spring Framework Fundamentals ....................................................... 25
The Spring Framework .................................................................................................... 25
Dependency Injection ...................................................................................................... 29
ApplicationContexts ......................................................................................................... 34
Resource Loading ................................................................................................................................... 38
Component-Scanning ............................................................................................................................. 40
Scopes .................................................................................................................................................... 41
Profiles ................................................................................................................................................... 41
Enabling Features ................................................................................................................................... 44
Aspect-Oriented Programming ............................................................................................................... 45
Web Applications ............................................................................................................. 47
Summary ......................................................................................................................... 50
II Chapter 3: Web Application Architecture .............................................................. 51
The MVC Pattern .............................................................................................................. 51
Application Layering ........................................................................................................ 53
Separation of Concerns ................................................................................................... 56
Spring MVC Application Layers ........................................................................................ 56
The Domain Layer ................................................................................................................................... 56
The User Interface Layer ........................................................................................................................ 57
The Web Layer ........................................................................................................................................ 58
The Service Layer ................................................................................................................................... 59
The Data Access Layer ........................................................................................................................... 62
More Roads to Rome ....................................................................................................... 63
Summary ......................................................................................................................... 64
II Chapter 4: Spring MVC Architecture ..................................................................... 65
DispatcherServlet Request Processing Workflow ............................................................ 65
The Workflow .......................................................................................................................................... 66
vi
• CONTENTS
The Request Processing Summary ......................................................................................................... 73
The DispatcherServlet ..................................................................................................... 74
Bootstrapping the DispatcherServlet. ..................................................................................................... 74
Configuring the DispatcherServlet. ......................................................................................................... 78
The Spring MVC Components .......................................................................................... 88
HandlerMapping ..................................................................................................................................... 88
HandlerAdapter ....................................................................................................................................... 94
MultipartResolver ................................................................................................................................... 96
LocaleResolver ....................................................................................................................................... 97
ThemeResolver ....................................................................................................................................... 99
HandlerExceptionResolver .................................................................................................................... 101
RequestToViewNameTranslator ........................................................................................................... 102
ViewResolver ........................................................................................................................................ 103
FlashMapManager ................................................................................................................................ 104
Summary ....................................................................................................................... 105
• Chapter 5: Implementing Controllers .................................................................. 107
Introducing Controllers .................................................................................................. 107
Interface-based Controllers .................................................................................................................. 108
Annotation-based Controllers ............................................................................................................... 110
Configuring View Controllers ................................................................................................................ 111
Request-Handling Methods ........................................................................................... 112
Supported Method Argument Types ..................................................................................................... 115
Supported Method Argument Annotations ........................................................................................... 118
Supported Method Return Values ......................................................................................................... 123
Writing Annotation-based Controllers ............................................................................ 125
A Simple Login Controller ..................................................................................................................... 125
Book Search Page ................................................................................................................................ 130
Book Detai I Page .................................................................................................................................. 133
vii
• CONTENTS
Data Binding .................................................................................................................. 136
Customizing Data Binding .................................................................................................................... 137
Per Controller Customization ................................................................................................................ 139
ModelAttributes .................................................................................................................................... 141
Type Conversion ................................................................................................................................... 148
Validating Model Attributes .................................................................................................................. 162
Internationalization ........................................................................................................ 170
Message Source ................................................................................................................................... 170
LocaleResolver ..................................................................................................................................... 172
LocaleChangelnterceptor ...................................................................................................................... 172
Summary ....................................................................................................................... 176
• Chapter 6: Implementing Controllers - Advanced ............................................ 177
Using Scoped Beans ...................................................................................................... 177
Adding Something to the Cart .............................................................................................................. 178
Implementing the Checkout ................................................................................................................. 183
Crosscutting Concerns ................................................................................................... 185
Interceptors .......................................................................................................................................... 186
Exception Handling ............................................................................................................................... 197
SimpleMappingExceptionResolver ....................................................................................................... 201
Extending Spring @MVC ................................................................................................ 205
Extending RequestMappingHandlerMapping ....................................................................................... 205
Extending the RequestMappingHandlerAdapter ................................................................................... 207
Using the RequestDataValueProcessor ................................................................................................ 212
Summary ....................................................................................................................... 213
II Chapter 7: REST and AJAX .................................................................................. 215
Representational State Transfer (REST) ........................................................................ 215
Identifying Resources ........................................................................................................................... 215
viii
- CONTENTS
Working with Resources ....................................................................................................................... 216
Asynchronous JavaScript and XML (AJAX) .................................................................... 220
Adding AJAX to Our Application ............................................................................................................ 221
Combining AJAX and REST ................................................................................................................... 226
Progressive Enhancement .................................................................................................................... 227
Handling File Uploads .................................................................................................... 228
Configuration ........................................................................................................................................ 228
Request Handling Method for File Upload ............................................................................................ 231
Exception Handling ............................................................................................................................... 235
Summary ....................................................................................................................... 235
• Chapter 8: Resolving and Implementing Views .................................................. 237
View Resolvers and Views ............................................................................................. 237
View Resolvers .............................................................................................................. 238
BeanNameViewResolver ....................................................................................................................... 239
XmlViewResolver .................................................................................................................................. 240
ResourceBundleViewResolver .............................................................................................................. 241
UrIBasedViewResolver .......................................................................................................................... 243
InternalResourceViewResolver ............................................................................................................. 245
XsltViewResolver .................................................................................................................................. 245
ContentNegotiatingViewResolver ......................................................................................................... 246
Implementing Your Own ViewResolver ................................................................................................. 247
View Technologies ......................................................................................................... 248
Java Server Pages ................................................................................................................................ 249
JavaServer Faces ................................................................................................................................. 249
Tiles ...................................................................................................................................................... 250
Velocity and FreeMarker ....................................................................................................................... 254
PDF ....................................................................................................................................................... 263
Excel ..................................................................................................................................................... 265
ix