Quarkus Cookbook: Kubernetes-Optimized Java Solutions

Cover
Copyright
Table of Contents
Foreword
Preface
	Who Should Read This Book
	Why We Wrote This Book
	Navigating This Book
	Conventions Used in This Book
	Using Code Examples
	O’Reilly Online Learning
	How to Contact Us
	Acknowledgments
Chapter 1. Quarkus Overview
	Developer-Friendly
	Integration with Kubernetes
	Memory and First Response Time
	A Basic Quarkus Workflow
Chapter 2. Scaffolding
	2.1 Scaffolding a Quarkus Project with Maven
		Problem
		Solution
		Discussion
	2.2 Scaffolding a Quarkus Project with Gradle
		Problem
		Solution
		Discussion
	2.3 Scaffolding a Quarkus Project with the Quarkus Start Coding Website
		Problem
		Solution
		Discussion
		See Also
	2.4 Scaffolding a Quarkus Project with Visual Studio Code
		Problem
		Solution
		Discussion
		See Also
	2.5 Live Reloading with Dev Mode
		Problem
		Solution
		Discussion
	2.6 Serving Static Resources
		Problem
		Solution
Chapter 3. Developing RESTful Services
	3.1 Creating a Simple REST API Endpoint
		Problem
		Solution
	3.2 Extracting Request Parameters
		Problem
		Solution
		Discussion
		See Also
	3.3 Using Semantic HTTP Response Status Codes
		Problem
		Solution
		Discussion
		See Also
	3.4 Binding HTTP Methods
		Problem
		Solution
		See Also
	3.5 Enabling Cross-Origin Resource Sharing (CORS)
		Problem
		Solution
		Discussion
		See Also
	3.6 Using Reactive Routes
		Problem
		Solution
		Discussion
		See Also
	3.7 Intercepting HTTP Requests
		Problem
		Solution
		Discussion
		See Also
	3.8 Secure Connections with SSL
		Problem
		Solution
		Discussion
		See Also
Chapter 4. Configuration
	4.1 Configuring the Application with Custom Properties
		Problem
		Solution
		Discussion
	4.2 Accessing Configuration Properties Programmatically
		Problem
		Solution
	4.3 Overwriting Configuration Values Externally
		Problem
		Solution
	4.4 Configuring with Profiles
		Problem
		Solution
		Discuss
	4.5 Changing Logger Configuration
		Problem
		Solution
	4.6 Adding Application Logs
		Problem
		Solution
		Discussion
	4.7 Advanced Logging
		Problem
		Solution
		Discussion
		See Also
	4.8 Configuring with Custom Profiles
		Problem
		Solution
		Discussion
	4.9 Creating Custom Sources
		Problem
		Solution
		Discussion
	4.10 Creating Custom Converters
		Problem
		Solution
		Discussion
	4.11 Grouping Configuration Values
		Problem
		Solution
		Discussion
	4.12 Validating Configuration Values
		Problem
		Solution
		Discussion
Chapter 5. Programming Model
	5.1 Marshalling/Unmarshalling JSON
		Problem
		Solution
		Discussion
		See Also
	5.2 Marshalling/Unmarshalling XML
		Problem
		Solution
		Discussion
		See Also
	5.3 Validating Input and Output Values
		Problem
		Solution
		Discussion
		See Also
	5.4 Creating Custom Validations
		Problem
		Solution
		Discussion
		See Also
	5.5 Validating Objects Programmatically
		Problem
		Solution
		Discussion
	5.6 Injecting Dependencies
		Problem
		Solution
		Discussion
		See Also
	5.7 Creating Factories
		Problem
		Solution
		Discussion
		See Also
	5.8 Executing Object Life Cycle Events
		Problem
		Solution
		Discussion
		See Also
	5.9 Executing Application Life Cycle Events
		Problem
		Solution
		Discussion
		See Also
	5.10 Using a Named Qualifier
		Problem
		Solution
		Discussion
		See Also
	5.11 Using Custom Qualifiers
		Problem
		Solution
		Discussion
		See Also
	5.12 Qualifying and Configuring Annotations
		Problem
		Solution
		See Also
	5.13 Creating Interceptors
		Problem
		Solution
		Discussion
		See Also
	5.14 Writing Behavioral Tests
		Problem
		Solution
		Discussion
		See Also
	5.15 Writing Unit Tests
		Problem
		Solution
		Discussion
		See Also
	5.16 Creating Mock Objects
		Problem
		Solution
		Discussion
	5.17 Creating Mock Objects with Mockito
		Problem
		Solution
	5.18 Grouping Several Annotations into One with a Meta-Annotation
		Problem
		Solution
		Discussion
	5.19 Executing Code Before or After a Test
		Problem
		Solution
		Discussion
		See Also
	5.20 Testing the Native Executable
		Problem
		Solution
		Discussion
Chapter 6. Packaging Quarkus Applications
	6.1 Running in Command Mode
		Problem
		Solution
		Discussion
	6.2 Creating a Runnable JAR File
		Problem
		Solution
		Discussion
		See Also
	6.3 Über-JAR Packaging
		Problem
		Solution
	6.4 Building a Native Executable
		Problem
		Solution
		Discussion
	6.5 Building a Docker Container for JAR File
		Problem
		Solution
	6.6 Building a Docker Container for Native File
		Problem
		Solution
		Discussion
	6.7 Build and Dockerize a Native SSL Application
		Problem
		Solution
		Discussion
Chapter 7. Persistence
	7.1 Defining a Datasource
		Problem
		Solution
		Discussion
	7.2 Using Multiple Datasources
		Problem
		Solution
		Discussion
	7.3 Adding Datasource Health Check
		Problem
		Solution
		Discussion
		See Also
	7.4 Defining Transaction Boundaries Declaratively
		Problem
		Solution
		Discussion
	7.5 Setting a Transaction Context
		Problem
		Solution
		Discussion
	7.6 Programmatic Transaction Control
		Problem
		Solution
		See Also
	7.7 Setting and Modifying a Transaction Timeout
		Problem
		Solution
		Discussion
		See Also
	7.8 Setup with Persistence.xml
		Problem
		Solution
		Discussion
	7.9 Setup Without persistence.xml
		Problem
		Solution
		Discussion
	7.10 Using Entities from a Different JAR
		Problem
		Solution
		Discussion
	7.11 Persisting Data with Panache
		Problem
		Solution
		Discussion
	7.12 Finding All Entity Instances with Panache listAll Method
		Problem
		Solution
	7.13 Finding Individual Entities with Panache findById Method
		Problem
		Solution
	7.14 Finding Entities Using Panache Find and List Methods
		Problem
		Solution
	7.15 Obtaining a Count of Entities Using the Panache count Method
		Problem
		Solution
	7.16 Paginating Through Entity Lists Using the Panache page Method
		Problem
		Solution
		Discussion
		See Also
	7.17 Streaming Results via the Panache Stream Method
		Problem
		Solution
		See Also
	7.18 Testing Panache Entities
		Problem
		Solution
		See Also
	7.19 Using a Data Access Object (DAO) or Repository Pattern
		Problem
		Solution
		See Also
	7.20 Using Amazon DynamoDB
		Problem
		Solution
		Discussion
	7.21 Working with MongoDB
		Problem
		Solution
		Discussion
	7.22 Using Panache with MongoDB
		Problem
		Solution
		Discussion
	7.23 Using Neo4j with Quarkus
		Problem
		Solution
		See Also
	7.24 Flyway at Startup
		Problem
		Solution
		Discussion
	7.25 Using Flyway Programmatically
		Problem
		Solution
		Discussion
Chapter 8. Fault Tolerance
	8.1 Implementing Automatic Retries
		Problem
		Solution
		Discussion
		See Also
	8.2 Implementing Timeouts
		Problem
		Solution
		See Also
	8.3 Avoiding Overloads with the Bulkhead Pattern
		Problem
		Solution
		Discussion
		See Also
	8.4 Avoiding Unnecessary Calls with the Circuit Breaker Pattern
		Problem
		Solution
		Discussion
		See Also
	8.5 Disabling Fault Tolerance
		Problem
		Solution
Chapter 9. Observability
	9.1 Using Automatic Health Checks
		Problem
		Solution
		Discussion
		See Also
	9.2 Creating Custom Health Checks
		Problem
		Solution
		Discussion
		See Also
	9.3 Exposing Metrics
		Problem
		Solution
		Discussion
		See Also
	9.4 Creating Metrics
		Problem
		Solution
		Counter
		Gauge
		Metered
		Timed
		Histogram
		Discussion
	9.5 Using Distributed Tracing
		Problem
		Solution
		Discussion
		See Also
	9.6 Custom Distributed Tracing
		Problem
		Solution
		Discussion
Chapter 10. Integrating with Kubernetes
	10.1 Building and Pushing Container Images
		Problem
		Solution
		Discussion
		See Also
	10.2 Generating Kubernetes Resources
		Problem
		Solution
		Discussion
		See Also
	10.3 Generating Kubernetes Resources with Health Checks
		Problem
		Solution
		Discussion
		See Also
	10.4 Deploying Services on Kubernetes
		Problem
		Solution
		Discussion
	10.5 Deploying Services on OpenShift
		Problem
		Solution
	10.6 Building and Deploying a Container Image Automatically
		Problem
		Solution
		Discussion
	10.7 Configuring an Application from Kubernetes
		Problem
		Solution
		Discussion
		See Also
	10.8 Configuring an Application from Kubernetes with Config Extension
		Problem
		Solution
	10.9 Interacting with a Kubernetes Cluster Programmatically
		Problem
		Solution
		Discussion
		See Also
	10.10 Testing Kubernetes Client Interactions
		Problem
		Solution
	10.11 Implementing a Kubernetes Operator
		Problem
		Solution
		Discussion
		See Also
	10.12 Deploying and Managing Serverless Workloads with Knative
		Problem
		Solution
		Discussion
		See Also
Chapter 11. Authentication and Authorization
	Quarkus Security Basics
		Authentication
		Authorization
	11.1 Authentication and Authorization with Elytron Properties File Config
		Problem
		Solution
		Discussion
	11.2 Authentication and Authorization with Elytron Security JDBC Config
		Problem
		Solution
		Discussion
	11.3 Authorization with MicroProfile JWT
		Problem
		Solution
		Discussion
		See Also
	11.4 Authorization and Authentication with OpenId Connect
		Problem
		Solution
		See Also
	11.5 Protecting Web Resources with OpenId Connect
		Problem
		Solution
Chapter 12. Application Secrets Management
	12.1 Storing Data Using Kubernetes Secrets
		Problem
		Solution
		Discussion
		See Also
	12.2 Store Configuration Secrets Securely with Vault
		Problem
		Solution
		Discussion
		See Also
	12.3 Cryptography as a Service
		Problem
		Solution
		Discussion
		See Also
	12.4 Generate Database Password as Secret
		Problem
		Solution
		Discussion
		See Also
	12.5 Authenticating Services Using Vault Kubernetes Auth
		Problem
		Solution
		Discussion
		See Also
Chapter 13. Quarkus REST Clients
	13.1 Using the JAX-RS Web Client
		Problem
		Solution
		Discussion
		See Also
	13.2 Using the MicroProfile REST Client
		Problem
		Solution
		Discussion
		See Also
	13.3 Implementing a CRUD Client
		Problem
		Solution
		Discussion
	13.4 Manipulating Headers
		Problem
		Solution
		Discussion
	13.5 Using REST Client for Multipart Messages
		Problem
		Solution
	13.6 Using REST Client to Configure SSL
		Problem
		Solution
		Discussion
Chapter 14. Developing Quarkus Applications Using Spring APIs
	14.1 Using Spring Dependency Injection
		Problem
		Solution
		Discussion
	14.2 Using Spring Web
		Problem
		Solution
		Discussion
	14.3 Using Spring Data JPA
		Problem
		Solution
		Discussion
	14.4 Using Spring Security
		Problem
		Solution
		Discussion
	14.5 Using Spring Boot Properties
		Problem
		Solution
Chapter 15. Working with a Reactive Programming Model
	15.1 Creating Async HTTP Endpoints
		Problem
		Solution
		See Also
	15.2 Streaming Data Asynchronously
		Problem
		Solution
		See Also
	15.3 Using Messaging to Decouple Components
		Problem
		Solution
		Discussion
		See Also
	15.4 Reacting to Apache Kafka Messages
		Problem
		Solution
		Discussion
		See Also
	15.5 Sending Messages to Apache Kafka
		Problem
		Solution
		Discussion
		See Also
	15.6 Marshalling POJOs into/out of Kafka
		Problem
		Solution
		Discussion
	15.7 Using Kafka Streams API
		Problem
		Solution
		Discussion
		See Also
	15.8 Using AMQP with Quarkus
		Problem
		Solution
		See Also
	15.9 Using MQTT
		Problem
		Solution
		Discussion
		See Also
	15.10 Query Using Reactive SQL
		Problem
		Solution
		Discussion
		See Also
	15.11 Insert Using Reactive SQL Client
		Problem
		Solution
		See Also
	15.12 Using the Reactive MongoDB Client
		Problem
		Solution
		See Also
	15.13 Using the Reactive Neo4j Client
		Problem
		Solution
Chapter 16. Additional Quarkus Features
	16.1 Creating Templates with the Qute Template Engine
		Problem
		Solution
		Discussion
		See Also
	16.2 Rending HTML Using Qute
		Problem
		Solution
		Discussion
	16.3 Changing the Location of Qute Templates
		Problem
		Solution
	16.4 Extending Qute Data Classes
		Problem
		Solution
	16.5 Describing Endpoints with OpenAPI
		Problem
		Solution
		Discussion
		See Also
	16.6 Customizing OpenAPI Spec
		Problem
		Solution
		Discussion
		See Also
	16.7 Sending Email Synchronously
		Problem
		Solution
		Discussion
		See Also
	16.8 Sending Email Reactively
		Problem
		Solution
		Discussion
		See Also
	16.9 Creating Scheduled Jobs
		Problem
		Solution
		Discussion
		See Also
	16.10 Using Application Data Caching
		Problem
		Solution
		Discussion
Appendix A. Minikube
Appendix B. Keycloak
Appendix C. Knative
Index
About the Authors