Android’s Architecture Components Version 0.10

Table of Contents......Page 4 How the Book Is Structured......Page 10 What’s New in Version 0.10?......Page 11 Warescription......Page 12 Source Code and Its License......Page 13 Acknowledgments......Page 14 Wrenching Relations Into Objects......Page 18 Room Requirements......Page 19 Entities......Page 20 DAO......Page 22 Database......Page 24 Get a Room......Page 26 Writing Instrumentation Tests......Page 28 Using In-Memory Databases......Page 30 Importing Starter Data......Page 31 Writing Unit Tests via Mocks......Page 32 Configuring Entities......Page 38 Auto-Generated Primary Keys......Page 39 Composite Primary Keys......Page 40 Adding Indexes......Page 41 Ignoring Fields......Page 42 Custom Table and Column Names......Page 44 Indexing......Page 47 DAOs and Queries......Page 48 Adding Parameters......Page 49 What You Can Return......Page 50 Breadth of Results......Page 51 Aggregate Functions......Page 53 Dynamic Queries......Page 54 @RawQuery......Page 55 Other DAO Operations......Page 56 Conflict Resolution......Page 57 Other Operations......Page 58 Custom Methods......Page 59 On @Query Methods......Page 60 Threads and Room......Page 61 Type Converters......Page 62 Setting Up a Type Converter......Page 63 Example: Dates and Times......Page 64 Example: Locations......Page 66 Example: Simple Collections......Page 67 Example: Locations......Page 70 Simple vs. Prefixed......Page 72 Updating the Trip Sample......Page 73 The Classic ORM Approach......Page 78 A History of Threading Mistakes......Page 79 Cascades on Updates and Deletes......Page 80 The Domain Model......Page 81 The New Entities......Page 82 The Updated DAO and Database......Page 86 Self-Referential Relations for Tree Structures......Page 89 Using @Relation......Page 91 Representing No Relation......Page 93 “Can’t You See That This is a Facade?”......Page 96 Other ORMs......Page 97 Get a Factory......Page 98 Add a Callback......Page 100 Get a Helper......Page 101 Get the Rest......Page 102 Getting a Database......Page 103 Using the Database......Page 104 What’s a Migration?......Page 108 But First, a Word About Exporting Schemas......Page 109 Writing Migrations......Page 112 Employing Migrations......Page 117 Testing Migrations......Page 119 Adding the Schemas......Page 120 Setting Up the Helper......Page 121 Creating a Database for a Schema Version......Page 122 Testing a Migration......Page 123 Migrating Under Protest......Page 124 SQLCipher for Android......Page 126 Adding the Dependency......Page 127 Passphrase Management......Page 128 More to Come!......Page 129 Lifecycle......Page 132 Adding the Lifecycle Components......Page 133 ...From a FragmentActivity or a Support Fragment......Page 134 ...From Anything Else......Page 135 Observing a Lifecycle......Page 136 Ordinary Activities and Fragments, and Other Objects......Page 137 Pre-Java 8......Page 139 So, What’s the Point of This?......Page 141 Observables Are the New Black......Page 142 Observer......Page 143 Implementing LiveData......Page 144 State Transitions......Page 145 Retaining the LiveData......Page 147 Event Bus......Page 150 Room......Page 151 Testing LiveData......Page 152 ViewModels, As Originally Envisioned......Page 154 ...Saved Instance State......Page 155 Mommy, Where Do ViewModels Come From?......Page 156 ViewModels, Google’s Way......Page 157 Defining a ViewModel......Page 158 Using the ViewModel......Page 159 ViewModels as Simple POJOs......Page 160 Getting a ViewModel......Page 161 Scenario: Tabbed Editor......Page 163 The ViewModel......Page 164 The Layouts......Page 167 The Activity and Tabs......Page 169 The Paging......Page 175 ProcessLifecycleOwner......Page 178 Wait... Where Are LifecycleProvider and LifecycleReceiver?......Page 182 New Layout Resource Structure......Page 184 Adapters......Page 185 Binding from Code......Page 186 LiveData Updating Data Binding......Page 187 Updating Observables......Page 188 Binding to LiveData......Page 191 Handling Changes to LiveData......Page 193 The Saved Instance State Situation......Page 195 Existing Model......Page 198 New Model......Page 199 Where Should We Use WorkManager?......Page 200 WorkManager Dependencies......Page 201 Workers: They Do Work......Page 202 Work Inputs......Page 204 Constrained Work......Page 205 Tagged Work......Page 206 Getting the Status Updates......Page 207 Consuming the Status Updates... In Code......Page 208 Consuming the Status Updates... In Data Binding......Page 210 Canceling Work......Page 211 Parallel Work......Page 212 How Do We Chain Work?......Page 213 OK, Where’s the Code?......Page 214 How Complex Can This Get?......Page 218 Unique Work......Page 219 Testing Work......Page 220 Implementing a Join Entity......Page 226 Static Entity Classes......Page 227 Foreign Keys and Indices......Page 229 Adding and Removing Relations......Page 230 Fetching Via the Join......Page 231 Where’s That Good Ol’ Object Feel?......Page 232 Polymorphism With Separate Tables......Page 234 Polymorphism With a Single Table......Page 239 Polymorphism With M:N Relations......Page 243 The Bucket Brigade......Page 244 Mapping Data to Data......Page 245 Writing a Transformation......Page 247 Do We Really Want This?......Page 249 Adding RxJava......Page 252 The InstantTaskExecutorRule......Page 253 Rx Query Response Types......Page 254 What Happens... Normally?......Page 255 What Happens... When the Data is Updated?......Page 256 Single......Page 257 Maybe......Page 258 Applying This to Your UI......Page 259 @RawQuery and Reactive Responses......Page 260 The Classic Approach......Page 262 Bridging RxJava and LiveData......Page 263 From RxJava to LiveData......Page 264 From LiveData to RxJava......Page 265 The Semi-Deprecated Solution: RxLifecycle......Page 266 The Problem......Page 268 The Classic Solution: SQLiteAssetHelper......Page 269 Merging SQLiteAssetHelper with Room......Page 270 The Problem: Too Much Data......Page 274 Enter the Paging Library......Page 275 PagedListAdapter......Page 276 The Dependency......Page 277 The Entity, DAO, and Database......Page 278 The ViewModel......Page 281 The PagedListAdapter......Page 282 The CitiesFragment......Page 284 The Results......Page 285 What About RxJava?......Page 286 No Dirty Data......Page 290 Thread Safety......Page 291 Partial Immutability Problems......Page 292 Some Things Want Setters......Page 293 Garbage, To Be Collected......Page 294 Immutability via AutoValue......Page 295 AutoValue and LiveData......Page 297 AutoValue and Room......Page 298 What the Repository Does......Page 300 Normalizes Model Objects......Page 301 Isolates Rest of App from Strategy Changes......Page 302 Network + Network API Caching......Page 303 Persistence-Only......Page 304 API......Page 305 Implementation......Page 306 Managing the Observables......Page 308 Saving State......Page 310 The Factory......Page 311 The UI......Page 312 The Menu......Page 314 The Event Flow......Page 317 Blending Data Sources......Page 318 Pwned Passwords......Page 319 score()......Page 320 Integrating PwnedCheck......Page 323 Modifying the Model......Page 324 Validating the Passphrase......Page 325 GUI Architectures......Page 328 Avoiding Known Problems......Page 329 Consistency Over Time......Page 330 Atypical Apps......Page 331 No Obvious User Benefit......Page 332 A Rough Comparison of GUI Architectures......Page 333 The Basics of Model-View-Intent......Page 336 What’s a View State?......Page 337 Where Does the “Intent” Thing Show Up?......Page 338 Additional MVI Resources......Page 340 The Roster......Page 342 The Viewer......Page 348 The Editor......Page 349 MVI and the Sample App......Page 350 The Model......Page 351 The View State......Page 353 The View......Page 355 Receiving View States......Page 356 Rendering View States......Page 357 The Actions......Page 359 Publishing Actions......Page 363 The Repositories......Page 365 ToDoRepository......Page 366 FilterModeRepository......Page 369 The Controller......Page 370 Doing the Work and Publishing Results......Page 371 add()/modify()/delete()......Page 372 select()/unselect()/unselectAll()......Page 373 About Those Results......Page 374 Subscribing to Results......Page 376 Merging Results Into the ViewState......Page 377 DisplayFragment......Page 381 Summary......Page 382 Plan A: The Whole Directory......Page 386 Plan B: Just SQLite’s Files......Page 387 When You Feel Like It......Page 388 A Simple Close......Page 389 Triggering the Operation......Page 390 Our UI......Page 392 Performing the Operation......Page 395 Areas for Improvement......Page 396 Backing Up Off-Device......Page 397 What Is FTS?......Page 398 The FTS Recipe......Page 399 RawQuery the Table......Page 400 The Book......Page 401 The Data Model......Page 402 The Database......Page 404 The Searches......Page 409 The Repository......Page 411 The ViewModels......Page 412 The UI......Page 413 The Results......Page 419 When To Make Changes......Page 422 Example: Turbo Boost Mode......Page 423