Home Projects Portfolio Dashboard Export PDF Log in

Languages

English
51

Latest Updates

Documenting code, one commit at a time.

Swagger 5 posts
×

Optimizing Swagger Documentation: Moving Beyond Pageable in Spring

Improving API Clarity

When building robust APIs with Spring, managing complex pagination parameters can often lead to messy documentation. In the capevents project, we recently discovered that relying on Spring's native Pageable object in controller methods creates ambiguity in Swagger (OpenAPI) documentation.

The Challenge

Using Pageable is elegant for backend development because

0 Java Spring Swagger

Ensuring Data Integrity: Implementing Lifecycle Timestamps in capevents

In event-driven applications, knowing exactly when a resource was born is as important as the data itself. In the capevents project, we recently addressed a common oversight in entity modeling: the lack of standardized lifecycle tracking for our User domain.

The Challenge of Forgotten Timestamps

When we build systems, it is easy to focus on state and attributes, often treating time as an

Scaling Data Access: Implementing Pagination in capevents

Introduction

In the capevents project, as the volume of events grows, fetching all records in a single request becomes a bottleneck. To maintain system performance and a responsive user interface, we have introduced pagination for our event listing and search endpoints.

The Problem: Data Overload

Imagine trying to read an entire encyclopedia by spreading all pages across your floor at

Achieving Milestone Velocity: Integrating Frontend and Backend for CapEvents

Building a robust web platform is a balancing act of ensuring the data layer stays consistent while the interface remains responsive. In the development of the WissemBagga/capevents project, our focus shifted toward finalizing the integration between our Spring-based backend and the frontend, ensuring that our architectural patterns were working in harmony.

The Integration Challenge