Exploring Lift

Contents......Page 3 List of Figures......Page 11 List of Listings......Page 13 I The Basics......Page 25 1.1 Why Lift?......Page 27 1.4 For More Information about Lift......Page 29 1.5 Your First Lift Application......Page 30 2 PocketChange......Page 35 2.1 Defining the Model......Page 36 2.2 Our First Template......Page 38 2.3 Writing Snippets......Page 39 2.4 A Little AJAX Spice......Page 43 2.5 Conclusion......Page 45 3.1 Entry into Lift......Page 47 3.2.1 Class Resolution......Page 48 3.4.3 LiftRules......Page 49 3.7 URL Rewriting......Page 50 3.8 Custom Dispatch Functions......Page 52 3.9 HTTP Redirects......Page 54 3.11 Session and Request State......Page 55 3.12 Conclusion......Page 58 4.1 Template XML......Page 59 4.1.2 Processing Template XML......Page 60 4.2.1 Determining the Content Element......Page 62 4.4 Views......Page 63 4.5 Tags......Page 65 4.5.5 comet......Page 66 4.5.7 embed......Page 67 4.5.17 surround......Page 68 4.6 Head and Tail Merge......Page 69 4.7 Binding......Page 70 5.1 The Snippet Tag......Page 71 5.2.1 Implicit Dispatch Via Reflection......Page 72 5.2.2 Explicit Dispatch......Page 74 5.3 Snippet Methods......Page 76 5.3.1 Binding Values in Snippets......Page 77 5.3.2 CSS Selector Transforms......Page 78 5.3.3 Stateless versus Stateful Snippets......Page 82 5.3.4 Eager Evaluation......Page 85 5.4.2 XHTML Attribute Pass-through......Page 86 6.1 Form Fundamentals......Page 89 6.3.1 checkbox......Page 91 6.3.3 link......Page 92 6.3.5 textarea......Page 93 6.3.8 radio......Page 94 6.3.10 selectObj......Page 95 6.4 File Uploads......Page 96 7.1 Basic SiteMap Definition......Page 99 7.1.3 Creating Menu Entries......Page 100 7.1.4 Nested Menus......Page 101 7.2.1 Hidden......Page 102 7.2.3 Using ......Page 103 7.3 Access Control......Page 104 7.4.1 The Template Parameter......Page 105 7.4.3 Title......Page 106 7.5.2 LocGroup......Page 107 7.6 Writing Your Own Loc......Page 108 7.6.2 Type Safe Parameters......Page 109 7.7 Conclusion......Page 111 8.1 Introduction to Mapper and MetaMapper......Page 113 8.1.2 Setting Up the Database Connection......Page 114 8.1.3 Constructing a Mapper-enabled Class......Page 115 8.1.4 Object Relationships......Page 117 8.1.6 Schema Mapping......Page 119 8.1.7 Persistence Operations on an Entity......Page 120 8.1.9 Comparison QueryParams......Page 122 8.1.10 Control QueryParams......Page 125 8.2.1 Display Generation......Page 126 8.2.2 Form Generation......Page 127 8.2.3 Validation......Page 128 8.2.5 Lifecycle Callbacks......Page 130 8.2.6 Base Field Types......Page 131 8.2.7 Defining Custom Field Types in Mapper......Page 133 8.2.8 ProtoUser and MegaProtoUser......Page 136 8.3.1 Using Multiple Databases......Page 137 8.3.3 SQL-based Queries......Page 139 8.5 Summary......Page 141 II Advanced Topics......Page 143 9.1 Architectural Overview......Page 145 9.2 The Request/Response Lifecycle......Page 147 9.3 Lift Function Mapping......Page 153 9.4.2 StreamingResponse......Page 154 9.4.3 Hierarchy......Page 155 9.4.4 RedirectWithState......Page 156 9.5 Session Management......Page 157 9.5.1 Lift garbage collection......Page 158 9.6 Miscellaneous Lift Features......Page 159 9.6.2 Passing Template Parameters to Snippets......Page 160 9.6.4 Processing Element Attributes......Page 161 9.7.4 Per-session DispatchPF functions......Page 162 9.7.8 Other functions......Page 163 9.9 HTTP Authentication......Page 164 9.9.2 Providing the Authentication Hook......Page 165 9.9.3 Role Hierarchies......Page 167 10.1 JavaScript high level abstractions......Page 169 10.1.1 JsCmd and JsExp overview......Page 170 10.1.2 JavaScript Abstraction Examples......Page 172 10.2 JQuery and other JavaScript frameworks......Page 173 10.3 XML and JavaScript......Page 174 10.4 JSON......Page 176 10.4.1 JSON forms......Page 177 10.5 JqSHtml object......Page 178 10.6 A recap......Page 179 11.1 What are AJAX and Comet, really?......Page 181 11.2 Using AJAX in Lift......Page 182 11.3 A more complex AJAX example......Page 183 11.4 AJAX Generators in Detail......Page 184 11.5 Comet and Lift......Page 185 11.5.1 Actors in Scala......Page 187 11.5.2 Building a Comet Application in Lift......Page 188 11.6 Coordinating Between Multiple Comet Clients......Page 190 11.7 Summary......Page 191 12 JPA Integration......Page 193 12.1 Introducing JPA......Page 194 12.1.2 Using the orm.xml descriptor......Page 195 12.1.3 Working with Attached and Detached Objects......Page 196 12.2 Obtaining a Per-Session EntityManager......Page 197 12.3 Handling Transactions......Page 198 12.4 ScalaEntityManager and ScalaQuery......Page 199 12.5.1 Persisting, Merging and Removing Entities......Page 200 12.5.2 Loading an Entity......Page 201 12.5.4 Using Queries Wisely......Page 202 12.5.6 The importance of flush() and Exceptions......Page 203 12.5.7 Validating Entities......Page 204 12.6 Supporting User Types......Page 205 12.7 Running the Application......Page 206 12.8 Summing Up......Page 207 13.1 OpenID Integration......Page 209 13.2 AMQP......Page 211 13.3 PayPal......Page 213 13.4 Facebook......Page 214 13.5 XMPP......Page 215 13.6 Lucene/Compass Integration......Page 217 14.1.1 TableSorter widget......Page 219 14.1.2 Calendar widgets......Page 220 14.1.3 RSS Feed widget......Page 224 14.1.5 TreeView widget......Page 225 14.1.6 Sparklines widget......Page 227 14.2 How to build a widget......Page 228 15.1.1 A Little Bit about HTTP......Page 231 15.2 A Simple API for PocketChange......Page 233 15.3 Adding REST Helper Methods to our Entities......Page 234 15.4 Multiple Approaches to REST Handling......Page 235 15.4.1 Using Custom Dispatch......Page 236 15.4.2 Using the RestHelper Trait......Page 237 15.5 Processing Expense PUTs......Page 240 15.6 The Request and Response Cycles for Our API......Page 243 15.7 Extending the API to Return Atom Feeds......Page 244 15.7.1 An Example Atom Request......Page 245 15.8 Conclusion......Page 246 III Appendices......Page 247 A.2 Lifecycles, Phases and Goals......Page 249 A.3 Repositories......Page 250 A.4 Plugins......Page 251 A.5.1 Adding a Dependency......Page 252 A.7 Project Layout......Page 253 B.1 Sending Messages......Page 255 B.2 Displaying Messages......Page 256 C.2 Box (or Scala's Option class on steroids)......Page 257 C.3 ActorPing......Page 260 C.5 CodeHelpers......Page 261 C.7 CSSHelpers......Page 262 C.8 BindHelpers......Page 263 C.13 NamedPartialFunctions......Page 264 C.15 TimeHelpers......Page 265 D.1 Localized Templates......Page 267 D.3 An Important Note on Resource Bundle Resolution......Page 268 D.4 Localized Strings in Scala Code......Page 269 D.6 Localized Strings in Templates......Page 270 D.7 Calculating Locale......Page 271 E.2 Basic Logging......Page 273 E.2.2 Obtaining a Logger......Page 274 E.2.3 Logging Methods......Page 275 E.3 Log Level Guards......Page 276 E.4 Logging Mapper Queries......Page 277 F.2 Sending Emails......Page 279 G.1 JPA Library Demo......Page 281 G.1.1 Author Entity......Page 282 G.1.2 orm.xml Mapping......Page 283 G.1.3 Enumv Trait......Page 284 G.1.4 EnumerationType......Page 285 G.1.5 JPA web.xml......Page 286 Index......Page 287