Java 9 Revealed for early Adoption and Migration

Contents at a Glance......Page 5
Contents......Page 7
About the Author......Page 18
About the Technical Reviewer......Page 19
Acknowledgments......Page 20
Introduction......Page 21
 Introduction to JDK 9......Page 23
 How to Read This Book......Page 24
 System Requirements......Page 25
 Installing the NetBeans IDE......Page 26
 Downloading the Source Code......Page 27
 Life Before Java 9......Page 28
 The New Module System......Page 30
 What Is a Module?......Page 31
 Module Dependencies......Page 32
  Module Graph......Page 34
 Declaring Modules......Page 38
  Module Names......Page 40
  Controlling Access to Modules......Page 41
  Configuring Services......Page 42
  Compiling Module Declarations......Page 43
  Module Source Files Structure......Page 44
  A Module in a Modular JAR......Page 45
 Module Path......Page 46
 Observable Modules......Page 49
 Summary......Page 50
  Setting Up the Directories......Page 52
  Writing the Source Code......Page 53
  Compiling the Source Code......Page 54
  Packaging the Module Code......Page 56
  Running the Program......Page 57
  Configuring the IDE......Page 60
  Creating the Java Project......Page 64
  Setting the Project Properties......Page 66
  Adding the Module Declaration......Page 68
  Writing the Source Code......Page 71
  Packaging the Module Code......Page 73
  Running the Program......Page 74
 Summary......Page 76
 Declaring Module Dependency......Page 78
  Empty Package Error......Page 86
  Module Resolution Exception......Page 87
 Implicit Readability......Page 88
 Qualified Exports......Page 93
 Optional Dependency......Page 94
 Accessing Modules Using Reflection......Page 95
  Opening Packages......Page 96
  Using Deep Reflection......Page 97
 Splitting Packages Across Modules......Page 106
 Types of Modules......Page 107
  Automatic Modules......Page 109
  Unnamed Modules......Page 113
   Normal Modules to Unnamed Modules......Page 114
   Unnamed Modules to Normal Modules......Page 116
 Migration Path to JDK 9......Page 119
 Dissembling Module Definitions......Page 120
 Summary......Page 124
 What Is a Service?......Page 126
 Discovering Services......Page 128
 Providing Service Implementations......Page 129
 Defining the Service Interface......Page 131
  Defining a Generic Prime Service Provider......Page 134
  Defining a Faster Prime Service Provider......Page 136
  Defining a Fastest Prime Service Provider......Page 138
 Testing the Prime Service......Page 139
 Selecting and Filtering Providers......Page 142
 Testing Prime Service in Legacy Mode......Page 144
 Summary......Page 146
 The JAR Format......Page 147
  What Is a Multi-Release JAR?......Page 148
  Creating Multi-Release JARs......Page 149
   Modular Multi-Release JARs and Encapsulation......Page 156
  Multi-Release JARs and JAR URL......Page 157
  Using the jmod Tool......Page 158
   Creating JMOD Files......Page 160
   Listing JMOD File Contents......Page 161
   Recording Modules Hashes......Page 162
 Summary......Page 165
 What Is a Custom Runtime Image?......Page 166
 Creating Custom Runtime Images......Page 167
 Binding Services......Page 170
 Using Plugins with the jlink Tool......Page 172
 The jimage Tool......Page 175
 Summary......Page 177
 The New JDK Versioning Scheme......Page 178
  Version Number......Page 179
  Additional Information......Page 180
  Using the Runtime.Version Class......Page 181
 Changes to the JDK and JRE......Page 184
  Layout Changes in JDK and JRE......Page 185
   Endorsed Standards Override Mechanism......Page 187
  Changes in Class Loaders......Page 188
  Accessing Resources Before JDK 9......Page 192
  Accessing Resources in JDK 9......Page 196
   Rules to Find Resources......Page 197
   An Example of Accessing Resources in Named Modules......Page 200
   Accessing Resources in the Runtime Image......Page 205
 Using JDK Internal APIs......Page 210
 Patching Module Contents......Page 212
 Summary......Page 214
 What Is Breaking Module Encapsulation?......Page 216
  The --add-exports Option......Page 217
  The --add-opens Option......Page 218
  The --permit-illegal-access Option......Page 219
 An Example......Page 220
 Using Manifest Attributes of a JAR......Page 226
 Summary......Page 229
 What Is the Module API?......Page 230
 Describing Modules......Page 232
   Representing the exports Statement......Page 233
   Representing the requires Statement......Page 234
  Representing a Module Version......Page 235
  Other Properties of Modules......Page 236
  Knowing Module Basic Info......Page 237
 Querying Modules......Page 240
 Updating Modules......Page 242
 Annotation on Modules......Page 245
 Loading Classes......Page 247
 Working with Module Layers......Page 250
  Finding Modules......Page 252
  Reading Module Contents......Page 254
  Creating Configurations......Page 256
  Creating Module Layers......Page 257
 Summary......Page 265
 What Is the Java Shell?......Page 267
 The JShell Architecture......Page 269
 Starting the JShell Tool......Page 270
 What Are Snippets and Commands?......Page 272
 Evaluating Expressions......Page 274
 Listing Snippets......Page 276
 Editing Snippets......Page 280
 Declaring Variables......Page 283
 Import Statements......Page 286
 Method Declarations......Page 290
 Type Declarations......Page 291
 Setting Execution Environment......Page 294
 No Checked Exceptions......Page 296
 Auto-Completion......Page 297
 Snippets and Commands History......Page 300
 Reading JShell Stack Trace......Page 301
 Reusing JShell Sessions......Page 302
 Resetting the JShell State......Page 304
 Reloading the JShell State......Page 305
  Setting the Snippet Editor......Page 307
  Setting Feedback Mode......Page 309
  Creating Custom feedback Modes......Page 311
  Setting Up Startup Snippets......Page 315
 Using JShell Documentation......Page 318
 The JShell API......Page 320
  Creating a JShell......Page 321
  Working with Snippets......Page 322
  An Example......Page 324
 Summary......Page 329
 What Is the Process API?......Page 330
 The Current Process......Page 331
 Querying Process State......Page 332
 Creating a Process......Page 335
 Obtaining a Process Handle......Page 343
 Terminating Processes......Page 345
 Managing Process Permissions......Page 346
 Summary......Page 348
 The Background......Page 350
 Unmodifiable Lists......Page 353
 Unmodifiable Sets......Page 356
 Unmodifiable Maps......Page 359
 Summary......Page 363
Chapter 14: The HTTP/2 Client API......Page 364
 What Is the HTTP/2 Client API?......Page 365
 Creating HTTP Clients......Page 367
  Obtaining an HTTP Request Builder......Page 369
  Setting HTTP Request Parameters......Page 370
   Setting Request Headers......Page 371
   Setting the Request Body......Page 372
   Creating HTTP Requests......Page 373
    Processing Response Status and Headers......Page 374
    Processing the Response Body......Page 376
 Setting the Request Redirection Policy......Page 380
  Creating a Server Endpoint......Page 381
  Creating a Client Endpoint......Page 383
   Creating a Listener......Page 384
   Building an Endpoint......Page 386
  Running the WebSocket Program......Page 387
 Summary......Page 391
 How to Deprecate an API......Page 393
 Updates to @Deprecated in JDK 9......Page 395
 Suppressing Deprecation Warnings......Page 397
 A Deprecated API Example......Page 398
 Static Analysis of Deprecated APIs......Page 402
 No Deprecation Warnings on Imports......Page 405
 Summary......Page 406
 What Is a Stack?......Page 407
 Stack Walking in JDK 8......Page 408
 Drawbacks to Stack Walking......Page 411
  Representing a Stack Frame......Page 412
  Obtaining a StackWalker......Page 414
  Walking the Stack......Page 415
  Knowing the Caller’s Class......Page 420
  Stack-Walking Permissions......Page 423
 Summary......Page 424
 What Is a Stream?......Page 426
 What Is Reactive Streams?......Page 427
  Publisher-Subscriber Interactions......Page 429
  Creating Publishers......Page 430
  Publishing Items......Page 431
  A Quick Example......Page 432
  Creating Subscribers......Page 434
  Using Processors......Page 439
 Summary......Page 442
 New Stream Operations......Page 443
 New Collectors......Page 447
 Summary......Page 453
 Platform Logging API......Page 454
  Setting Up a NetBeans Project......Page 455
  Defining a Module......Page 456
  Adding a Log4j Configuration File......Page 457
  Creating a System Logger......Page 458
  Creating a Logger Finder......Page 460
  Testing the Platform Logger......Page 461
   Further Work......Page 464
 Unified JVM Logging......Page 465
  Message Tags......Page 466
  Message Decorations......Page 467
  The -Xlog Syntax......Page 468
 Summary......Page 472
Chapter 20: Other Changes in JDK 9......Page 473
 The Underscore Is a Keyword......Page 474
 Improved try-with-resources Blocks......Page 475
 Diamond Operator in Anonymous Classes......Page 480
 Private Methods in Interfaces......Page 482
 @SafeVarargs on Private Methods......Page 484
 Discarding Process Outputs......Page 486
 New Methods in the StrictMath Class......Page 487
 New Methods in the Optional Class......Page 490
 Additions to the CompletableFuture Class......Page 493
 Spin-Wait Hints......Page 494
  The Clock Class......Page 495
   Dividing a Duration by Another Duration......Page 496
   Converting and Retrieving Duration Parts......Page 497
  The ofInstant() Factory Method......Page 498
  Obtaining Epoch Seconds......Page 499
  Stream of LocalDate......Page 500
   Generic Time Zone Names......Page 502
 Stream Operations with Scanner......Page 503
 Enhancement to the Matcher Class......Page 504
 Enhancement to the Objects Class......Page 506
 Comparing Arrays......Page 507
 The Applet API Is Deprecated......Page 509
 Javadoc Enhancements......Page 510
 Native Desktop Features......Page 512
 Object Deserialization Filters......Page 516
 Additions to Java I/O API......Page 524
 Summary......Page 525
Index......Page 527