GWT in Action

GWT in Action......Page 1
brief contents......Page 8
contents......Page 10
preface......Page 22
acknowledgments......Page 25
about this book......Page 27
Who should read this book......Page 29
Roadmap......Page 30
About the title......Page 33
About the authors......Page 34
about the cover illustration......Page 35
Part 1 Basics......Page 38
1 GWT......Page 40
1.1 Unplanned consequences (or the road to GWT)......Page 41
1.2.1 Compiling and optimizing......Page 44
1.2.2 Powerful widgets and a template binding engine......Page 45
1.2.3 Event handling beyond JavaScript......Page 47
1.2.4 Client/server communication......Page 48
1.2.5 Simplified development and debugging......Page 49
1.2.6 Integration with JavaScript......Page 50
1.2.7 History support......Page 51
1.2.8 Internationalization—Sprechen sie Deutsch?......Page 52
1.3 Setting up your development environment......Page 53
1.3.2 Installing Eclipse......Page 55
1.3.3 Installing the Google Plugin for Eclipse......Page 56
1.4 Summary......Page 59
2 Building a GWT application: saying “Hello World!”......Page 61
2.1.1 Seeing the user’s view......Page 63
2.1.2 Examining the developer’s view......Page 64
2.1.3 Understanding development vs. web mode......Page 65
2.2 Examining the options for building an application......Page 68
2.3 Creating the HelloWorld application with the GPE......Page 69
2.3.1 Creating a web application......Page 70
2.3.2 Defining a GWT module......Page 72
2.3.3 Adding an entry point......Page 73
2.3.4 Providing the web page......Page 75
2.3.5 Recapping the magic......Page 76
2.4 Running HelloWorld in development mode......Page 77
2.4.1 Starting development mode in Eclipse......Page 78
2.4.2 Passing parameters to development mode......Page 79
2.5.1 Checking the code in the IDE for errors......Page 82
2.5.3 Reading the console output......Page 83
2.5.4 Debugging in Eclipse......Page 84
2.5.5 Inspecting using browser development/inspection tools......Page 85
2.6.1 Running the GWT compiler from Eclipse......Page 86
2.6.3 Passing parameters to the GWT compiler......Page 89
2.7 Understanding modules vs. packages......Page 91
2.7.1 What’s in a GWT module?......Page 92
2.7.2 What are the benefits of modules?......Page 94
2.7.3 How many modules should you have?......Page 95
2.8.2 Package structure convention......Page 97
2.8.3 What parts of Java can you use in GWT?......Page 98
2.9 Reviewing the deployable application part of a GWT application......Page 99
2.9.1 Harnessing different linkers......Page 100
2.10 Building on your understanding......Page 101
2.11 Summary......Page 102
3 Building a GWT application: enhancing HelloWorld......Page 104
3.1 Reexamining the example application......Page 105
3.1.1 Enhancements......Page 106
3.2 Updating the HTML......Page 107
3.3 Enhancing the code......Page 109
3.4 Creating your user interface......Page 110
3.4.1 Presenting widgets......Page 111
3.4.2 Organizing layout with Panels......Page 114
3.5.1 Using the RootPanel/RootLayoutPanel......Page 119
3.5.2 Manipulating the DOM directly......Page 120
3.6.2 Handling events......Page 122
3.6.3 Preventing the browser from handling events for you......Page 124
3.7.1 Handling history in GWT......Page 126
3.7.2 Implementing history management in your application......Page 127
3.8 Styling components......Page 129
3.8.2 Low-level styling......Page 130
3.8.3 Cascading Style Sheets......Page 131
3.8.4 GWT themes......Page 132
3.9 Securing your application......Page 133
3.10 Building on your understanding......Page 135
3.11 Summary......Page 136
Part 2 Next steps......Page 138
4 Creating your own widgets......Page 140
4.1 What is a widget, again?......Page 141
4.2 Creating a new widget from the DOM......Page 143
4.2.1 Introducing the GWTiACanvas widget......Page 144
4.2.2 Indicating functionality......Page 146
4.2.3 Hooking up events......Page 147
4.2.4 Getting secure by using SafeHTML, SafeUri, and SafeStyles......Page 149
4.3.1 Introducing the ReportSizeLabel widget......Page 151
4.3.2 Indicating functionality......Page 152
4.4 Extending a panel......Page 154
4.5 Creating a composite......Page 155
4.5.1 Introducing the DataField question/answer widget......Page 156
4.5.2 Indicating functionality......Page 158
4.6 Using layout panels......Page 161
4.6.1 Types of layout panels......Page 162
4.6.2 Creating layout panels......Page 163
4.6.3 Animating layout panels......Page 166
4.7.1 Widgets that animate......Page 167
4.7.2 Building your own animation......Page 168
4.8.1 Creating a widget......Page 169
4.8.2 Adding a widget......Page 170
4.8.3 Removing a widget......Page 172
4.8.4 Destroying a widget......Page 173
4.9.1 Examining Elemental......Page 174
4.9.3 Noting the benefit......Page 175
4.10 Summary......Page 176
5 Using client bundles......Page 177
5.1 Client bundle basics using DataResources......Page 178
5.1.1 DataResource......Page 179
5.1.2 A simple ClientBundle......Page 180
5.1.3 Creating ClientBundles using the Google Plugin for Eclipse......Page 183
5.1.4 Using ClientBundles in an application......Page 184
5.2.1 TextResource......Page 186
5.2.2 ExternalTextResource......Page 187
5.3 ImageResource......Page 189
5.3.2 Using ImageResource in an application......Page 190
5.3.3 Controlling ImageResource optimizations......Page 192
5.4 CssResource......Page 194
5.4.1 Optimizations......Page 195
5.4.2 Constants......Page 197
5.4.3 Runtime evaluation......Page 199
5.4.4 Nonstandard CSS values......Page 200
5.4.5 Conditional sections......Page 201
5.4.6 Using other resources in CSS......Page 202
5.5 Summary......Page 203
6 Interface design with UiBinder......Page 205
6.1 Binding the designer’s HTML to Java code......Page 206
6.1.1 Creating the UiBinder XML template from HTML......Page 208
6.1.2 Working with panels......Page 212
6.1.3 Binding the UiBinder XML template to the Java code......Page 214
6.1.4 Binding XML template elements to Java variables......Page 215
6.1.5 Making sense of it all......Page 218
6.2 Handling events with UiBinder......Page 220
6.3 Introducing the UiBinder expression language......Page 221
6.4.1 Using  to generate a CssResource......Page 225
6.4.2 Accessing a generated CssResource in your widget......Page 227
6.5 Using the Eclipse plug-in with UiBinder......Page 231
6.6 Summary......Page 232
7 Communicating with GWT-RPC......Page 233
7.1 Surveying GWT-RPC......Page 234
7.1.2 Defining the GWT-RPC classes, interfaces, and annotations......Page 235
7.1.3 Understanding GWT-RPC package structure......Page 238
7.2 Learning GWT-RPC with Twitter......Page 239
7.3 Fetching data from Twitter the non-GWT way......Page 240
7.4 Defining a GWT-RPC-compatible model......Page 241
7.4.1 Using the Serializable and IsSerializable interfaces......Page 242
7.4.2 Special considerations when using JPA/JDO model objects as DTOs......Page 243
7.4.3 Developing custom serializers......Page 244
7.5 Building and deploying the server side......Page 247
7.5.2 Defining the service interface......Page 248
7.5.3 Writing the servlet......Page 250
7.5.4 Deploying the servlet......Page 252
7.6.1 Defining the asynchronous interface......Page 254
7.6.2 Making the call to the server......Page 255
7.7 Debugging GWT-RPC......Page 259
7.8.1 Understanding XSRF attacks......Page 260
7.8.2 Adding XSRF protection to your RPC calls......Page 261
7.9 Summary......Page 266
8 Using RequestFactory......Page 268
8.1.1 Enabling RequestFactory annotation processing with javac......Page 270
8.1.2 Enabling RequestFactory annotation processing in Eclipse......Page 271
8.1.3 Enabling RequestFactory annotation processing in Maven......Page 272
8.2.1 Investigating the client-side architecture......Page 273
8.2.2 Investigating the server-side architecture......Page 274
8.3 Understanding the example project in this chapter......Page 276
8.3.2 Creating proxy interfaces for the domain classes......Page 277
8.3.3 Developing the factory interface......Page 280
8.3.4 Using the domain class as the service......Page 282
8.3.5 Adding the RequestFactory servlet to the web.xml......Page 285
8.4.1 Initializing RequestFactory and making a simple call to the server......Page 286
8.4.2 Creating and persisting using instance methods......Page 288
8.4.3 Fetching persisted objects from the server......Page 290
8.4.4 Editing domain objects and updating them on the server......Page 292
8.4.5 Error handling and validation......Page 294
8.5.1 Creating a custom Locator......Page 299
8.5.2 Creating a custom ServiceLocator......Page 301
8.6 Summary......Page 305
9 The Editor framework......Page 306
9.1 Framework and editor overview......Page 307
9.1.2 Remote domain objects......Page 309
9.2 Examining the chapter’s examples......Page 310
9.3 Editor types......Page 312
9.4 Constructing your first editor......Page 313
9.4.1 Defining the local domain object......Page 314
9.4.2 Defining the editor......Page 315
9.5 Binding an editor with drivers......Page 320
9.5.1 EmployeeEditor with SimpleBeanEditorDriver......Page 322
9.5.2 EmployeeEditor with RequestFactoryEditorDriver......Page 324
9.6 Editor subinterfaces......Page 327
9.6.1 Accessing the backing framework services......Page 328
9.6.2 Editors with error handling......Page 329
9.6.3 Editing immutable objects or read-only editors......Page 330
9.6.4 Building customized editor behavior......Page 332
9.6.5 Handling subeditors of the same type......Page 333
9.7 Accessing the RequestContext......Page 336
9.8 Alternate way to construct an editor......Page 337
9.9.1 Editing a range of domain objects......Page 339
9.9.2 Adapting a list of objects with associated editors......Page 341
9.9.3 Adapters for single-domain objects......Page 343
9.10 Summary......Page 345
10 Data-presentation (cell) widgets......Page 346
10.1 Understanding cells......Page 347
10.1.1 Looking at display cells......Page 349
10.1.2 Updating edit cells......Page 351
10.1.3 Reacting with action cells......Page 352
10.2.1 Composite......Page 354
10.2.2 From first principles......Page 356
10.3 Reviewing GWT’s cell widgets......Page 364
10.4.1 Creating a CellList......Page 366
10.4.2 Populating data......Page 367
10.4.3 Paging......Page 369
10.4.4 Handling user updates......Page 370
10.4.5 Managing data selection with SelectionModels......Page 371
10.4.6 Managing the keyboard......Page 372
10.5 Walking through a CellTree......Page 373
10.5.1 Opening a new node (with an asynchronous data provider)......Page 374
10.6 Browsing a CellBrowser......Page 377
10.7 Constructing a CellTable......Page 378
10.7.1 Creating a table......Page 379
10.7.2 Applying headers and footers......Page 380
10.7.3 Sorting the view......Page 381
10.8 Building a DataGrid......Page 383
10.8.1 Custom CellTable building......Page 384
10.9 Summary......Page 387
11 Using JSNI—JavaScript Native Interface......Page 389
11.1 What is JSNI?......Page 391
11.2.1 No, JSNI can quickly limit the benefits of using GWT......Page 392
11.2.2 Yes, in these circumstances......Page 393
11.3 Benefiting from the Google Plugin for Eclipse......Page 394
11.4.1 Example: getting a browser element’s computed style......Page 396
11.4.2 Passing data in to a JSNI method......Page 399
11.4.3 Passing data out of a JSNI method......Page 400
11.5 Handling objects from JavaScript......Page 402
11.5.1 Example: using a JavaScriptObject......Page 403
11.5.2 Example: extending a JavaScriptObject (an overlay)......Page 404
11.5.3 Example: overlaying JSONP data......Page 407
11.6 Wrapping a third-party library......Page 409
11.6.1 Ensuring the library is loaded......Page 410
11.6.2 Accessing Java fields from JSNI......Page 414
11.6.3 Calling Java methods from JSNI......Page 417
11.6.4 Creating Java objects within JSNI......Page 420
11.7 Exposing an API to JavaScript......Page 421
11.8 Summary......Page 423
12 Classic Ajax and HTML forms......Page 424
12.1.1 Understanding how HTTP works......Page 425
12.1.2 Understanding Ajax and the XMLHttpRequest object......Page 428
12.1.3 Understanding JSON......Page 429
12.1.4 Solving same-site-origin policy issues with JSONP......Page 430
12.2 Using RequestBuilder......Page 431
12.3 Posting data with RequestBuilder......Page 433
12.4 Using the JSON API and JsonpRequestBuilder......Page 436
12.5 Using JSON with JS overlay......Page 439
12.6.1 Developing a server-side proxy......Page 441
12.6.2 Calling the proxy from GWT......Page 443
12.6.3 Parsing XML content......Page 446
12.7 Using FormPanel......Page 448
12.7.1 Designing a FormPanel registration form with UiBinder......Page 449
12.7.2 Adding behavior to the FormPanel......Page 450
12.8 Summary......Page 453
13 Internationalization, localization, and accessibility......Page 454
13.1 Making a user feel comfortable......Page 455
13.1.1 What is a locale?......Page 456
13.1.2 Setting up to use internationalization......Page 457
13.1.3 The three types of GWT internationalization......Page 458
13.2 Using static string internationalization......Page 459
13.2.1 The basics......Page 461
13.2.2 The Localizable interface......Page 463
13.2.3 Localizable annotations......Page 464
13.2.4 Internationalizing constants......Page 465
13.2.6 Messaging the user......Page 467
13.2.7 Dealing with plurals......Page 470
13.2.8 Selecting an alternate message based on a user-defined value......Page 471
13.2.9 Securing against hack attacks......Page 472
13.3 Using static-string i18n with UiBinder......Page 473
13.3.1 Constants with UiBinder......Page 474
13.3.2 Parameterized messages with UiBinder......Page 476
13.4 Determining the locale for static-string internationalization......Page 477
13.4.1 Where to find the locale......Page 478
13.4.2 Searching the URL......Page 479
13.4.3 Digesting a cookie......Page 480
13.4.5 Letting the browser decide......Page 481
13.6 Dynamic string internationalization......Page 482
13.6.1 The basics......Page 483
13.6.2 Enhancing the standard approach......Page 484
13.7 Localization of dates, times, and currencies......Page 485
13.7.2 Displaying times and dates......Page 486
13.8 Displaying the right direction......Page 487
13.9.2 Setting up a tab index......Page 489
13.9.5 Using ARIA......Page 490
13.10 Summary......Page 492
Part 3 Advanced......Page 494
14 Advanced event handling and event busses......Page 496
14.1 Understanding events......Page 497
14.1.1 Native events......Page 498
14.1.2 Logical events......Page 499
14.2.1 Dealing with browser differences......Page 500
14.2.3 Sinking events......Page 503
14.2.4 Event-handling efficiency......Page 506
14.3 Previewing and canceling events......Page 507
14.4 Preventing default actions......Page 509
14.5 Programmatically firing events......Page 510
14.6 Creating your own events......Page 511
14.6.1 Defining your own event......Page 512
14.6.2 Providing the related interfaces......Page 513
14.7 Event busses......Page 514
14.7.1 What is an event bus?......Page 515
14.7.2 Types of event busses......Page 516
14.7.3 Using SimpleEventBus......Page 517
14.8 Summary......Page 519
15 Building MVP-based applications......Page 520
15.1 What is MVP?......Page 521
15.1.1 The two-way presenter/view relationship......Page 522
15.2.1 From the user’s perspective......Page 524
15.2.2 From the MVP perspective......Page 525
15.3 Building MVP yourself......Page 527
15.3.1 Creating views......Page 528
15.3.2 Presenters......Page 530
15.3.3 Controlling the application......Page 532
15.4.1 Swapping out layers......Page 534
15.4.2 Optimizing with code splitting......Page 536
15.5 Activity and Place (GWT’s reference MVP approach)......Page 537
15.5.1 How objects plug together......Page 538
15.5.2 Activity......Page 540
15.5.3 Places......Page 545
15.5.4 Place tokenizers......Page 546
15.5.5 PlaceHistoryMapper......Page 547
15.5.6 ActivityMapper......Page 548
15.5.7 Managing the activities......Page 549
15.5.9 Views......Page 550
15.6 Fitting editors/data-presentation widgets into MVP......Page 551
15.7 Summary......Page 552
16 Dependency injection......Page 553
16.1 Dependency injection—the fundamentals......Page 555
16.1.1 At the beginning of time......Page 556
16.1.2 Straight from the factory......Page 557
16.1.3 Automatically injecting dependencies......Page 558
16.2 Guice—a Java dependency injection framework......Page 559
16.2.1 Defining the dependencies......Page 560
16.2.2 Types of injection......Page 561
16.3.1 Setting up for GIN......Page 564
16.3.2 Defining the dependencies......Page 565
16.3.3 Bootstrapping the injection......Page 567
16.3.4 Types of injection......Page 568
16.3.5 Swapping components......Page 571
16.4 When to avoid DI......Page 572
16.5 Summary......Page 573
17 Deferred binding......Page 575
17.1 What is deferred binding?......Page 577
17.1.1 Storing implementation differences in a Java class hierarchy......Page 578
17.1.3 Informing the GWT compiler which class to pick......Page 581
17.1.5 Selecting the right difference (permutation) at runtime......Page 584
17.2 Pulling it all together......Page 585
17.3 Using GWT properties to drive deferred binding......Page 586
17.3.1 Defining properties......Page 587
17.3.3 Setting properties......Page 588
17.3.4 Conditionally setting a property......Page 590
17.4 Managing explosive permutation numbers......Page 591
17.4.2 Using soft permutations......Page 592
17.5.1 Directly setting a property value in a module file......Page 594
17.5.2 Understanding property providers......Page 595
17.5.3 Generating a property provider......Page 596
17.5.4 Defining your own property provider......Page 597
17.5.5 Handling failure to get a property value......Page 599
17.6 Coping when deferred binding isn’t enough......Page 600
17.7 Summary......Page 602
18 Generators......Page 603
18.1 What does a generator do?......Page 604
18.2 What can a generator do?......Page 606
18.2.2 Reading annotations......Page 607
18.2.4 Using resources......Page 608
18.2.5 Manipulating resources......Page 609
18.3 Indicating what generator to use and when......Page 610
18.4.1 Defining a configuration property......Page 611
18.4.3 Extending the value of a configuration property......Page 612
18.6 Preparing to write a generator......Page 613
18.7 Creating your own generator......Page 615
18.7.1 The generator skeleton......Page 616
18.7.2 Creating a new type......Page 617
18.7.3 Writing the new content......Page 619
18.7.4 Accessing types through the TypeOracle......Page 621
18.7.5 Accessing properties through the PropertyOracle......Page 623
18.7.6 Accessing resources through the ResourceOracle......Page 624
18.8 Using your new generator......Page 626
18.9 Summary......Page 627
19 Metrics and code splitting......Page 628
19.1 Using the lightweight metrics tool......Page 629
19.1.2 Writing the global collector......Page 630
19.1.3 Sending events to the global collector......Page 636
19.2.1 Turning on the Compile Report......Page 639
19.2.2 Understanding the permutation list......Page 641
19.2.3 Digging into the Split Point report......Page 642
19.3.1 Understanding code-splitting basics......Page 648
19.3.2 Using the Async Package pattern......Page 651
19.3.3 Reducing leftover code by specifying load order......Page 656
19.4 Summary......Page 657
A......Page 660
C......Page 661
D......Page 664
E......Page 665
G......Page 667
H......Page 669
I......Page 670
L......Page 671
M......Page 672
P......Page 673
R......Page 675
S......Page 676
U......Page 678
W......Page 679
Y......Page 680
GWT in Action-back......Page 681