The Main Thread Weekly — CW 50

A Java & Quarkus Engineering Digest for Modern Developers

Welcome to CW 50 of The Main Thread Weekly.

As always, this newsletter is the short, curated layer on top of my daily Substack, The Main Thread. It’s designed to help you quickly spot what’s worth your time, with direct links to full, runnable tutorials and deeper architectural discussions.

If you like this format, you’ll get the most value by subscribing to The Main Thread itself, where new content drops daily.

Let’s look at this week’s highlights.

Best of the Week on The Main Thread

Protobuf REST APIs with Quarkus

Binary APIs aren’t just for gRPC anymore.

This tutorial shows how to build Protobuf-based REST APIs with Quarkus. Faster, smaller payloads, and explicit schemas, while still speaking HTTP.

Key Takeaways:

• Expose Protobuf payloads over REST
• Content negotiation with application/x-protobuf
• Strong schema contracts for backend/frontend integration
• When Protobuf REST makes more sense than JSON

Read the full tutorial → https://www.the-main-thread.com/p/protobuf-quarkus-rest-api-tutorial-java

Emotional Self-Control for Developers & Mentors

Technical excellence starts with emotional discipline.

A rarer non-code article this week: Focused on mentoring, feedback, and how emotional self-control directly affects code quality, team health, and leadership effectiveness.

Key Takeaways:

• Why senior developers are role models first, coders second
• How emotional reactions amplify technical debt
• Practical techniques for calmer, clearer mentoring
• Long-term impact on team velocity and trust

Read the article → https://www.the-main-thread.com/p/emotional-self-control-developer-mentoring

Holiday Wishlists with Soft Deletes in Quarkus

A festive tutorial with a very real enterprise lesson.

Using a holiday wishlist example, this guide demonstrates soft deletes with Hibernate, preserving data history while keeping APIs clean.

Key Takeaways:

• Implement soft deletes using Hibernate filters
• Keep APIs simple while retaining auditability
• Avoid "ghost data" bugs
• A pattern you’ll reuse far beyond holiday apps

Read the full tutorial → https://www.the-main-thread.com/p/quarkus-holiday-wishlist-tutorial-hibernate-soft-delete

More Hands-On Tutorials This Week

Zero-DTO Polymorphic APIs in Quarkus

Flexible APIs without exploding your DTO count.

This tutorial shows how to build polymorphic REST APIs in Quarkus without creating dozens of DTO classes while keeping type safety and clarity.

https://www.the-main-thread.com/p/quarkus-zero-dto-polymorphic-api-tutorial

Stripe API Versioning with Adapters in Quarkus

Third-party APIs change. Your code shouldn’t break.

Learn how to isolate Stripe API changes behind a clean adapter layer, making upgrades predictable and low-risk.

https://www.the-main-thread.com/p/quarkus-stripe-api-versioning-adapter-java-tutorial

Recursive Comments with PostgreSQL CTEs

Hierarchical data done properly.

This guide explains how to implement threaded comments using PostgreSQL recursive CTEs, exposed cleanly through Quarkus.

https://www.the-main-thread.com/p/quarkus-recursive-comments-postgresql-cte-tutorial

Building an Actuator-Style Extension for Quarkus

Spring Boot features implemented the Quarkus way.

A deep dive into building a Quarkus extension that exposes health, metrics, and operational insight. All without sacrificing startup time or build-time optimizations.

https://www.the-main-thread.com/p/quarkus-actuator-extension-java-tutorial

This Week’s Insight

“Good architecture isn’t just about abstraction layers. It is about emotional discipline, operational clarity, and choosing the right level of flexibility for the problem at hand.”

What You Get Every Week

✓ Curated Java & Quarkus content

✓ Runnable, production-grade examples

✓ Architecture patterns you can reuse

✓ A calm, practical perspective on modern Java

If this weekly digest helps you, consider subscribing to The Main Thread on Substack for daily, in-depth engineering articles.

See you in CW 51 👋