FizzBus is a transportation-like service developed as a spring boot-based project with RESTful-based APIs for the client.
FizzBus service uses controllers connecting to business logic residing in services. Those services connect to the database through repositories to show how to correctly implement Zoned Date/Time in distributed systems—considering different users' timezones with daylight-saving time (DST) when saving, updating, and searching data.
Simple Application showing the zoned date-time-based conversion concept could be located here under this gist International Meeting Application.
-
Download and install the JDK 20 from here.
-
Check the Java version:
[mtaman]:~ java -version openjdk version "20" 2023-03-21 OpenJDK Runtime Environment (build 20+36-2344) OpenJDK 64-Bit Server VM (build 20+36-2344, mixed mode, sharing)
Now you are ready to clone the project a run it locally either within your favorite IDE (I am using an IntelliJ IDEA) or from the command line as the following:
- Clone the project from this repository.
- Go to the project root and run the following maven command (make sure that your environment is set to Java 18):
[mtaman]:~ mvn spring-boot:run - Open it in your IDE, set project Java language to 20, and run the main app class
com.sxi.lab.fizzbus.FizzBusApplication. - Finally, you can access its swagger documentation from this URL http://localhost:8090/api/v1/fizz-bus/doc/index.html. Which will be used for testing the application.
I have written two Java Magazine articles explaining this project and the general problems considering zoned Date-Time implementations.
- Part 1 - Handling Java Time Zone in Distributed Systems: Correctly implementing Zoned Date/Time in distributed System with Java.
- Part 2 - Handling Java Time Zone in Distributed Systems: Implementing Zoned Date/Time in distributed FizzBus Service.