https://github.com/mohamed-taman/zoneddt-in-distributed-system
A spring boot-based RESTful application with DB shows how to Implement Zoned Date/Time in distributed systems correctly—considering different users' timezones and daylight saving time (DST) when saving, updating, and searching data.
https://github.com/mohamed-taman/zoneddt-in-distributed-system
Last synced: 3 months ago
JSON representation
A spring boot-based RESTful application with DB shows how to Implement Zoned Date/Time in distributed systems correctly—considering different users' timezones and daylight saving time (DST) when saving, updating, and searching data.
- Host: GitHub
- URL: https://github.com/mohamed-taman/zoneddt-in-distributed-system
- Owner: mohamed-taman
- License: mit
- Created: 2021-07-21T14:26:38.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-07-02T21:52:50.000Z (over 2 years ago)
- Last Synced: 2025-04-03T16:48:08.468Z (6 months ago)
- Language: Java
- Size: 504 KB
- Stars: 29
- Watchers: 2
- Forks: 12
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Handling Timezone with Java in Distributed Systems
**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](https://gist.github.com/mohamed-taman/1cd8e8483c033eeaac536d91e15dcd81).
### Running FizzBus Service
- Download and install the JDK 20 from [here](https://www.oracle.com/java/technologies/downloads/#java20).
- Check the Java version:
```bash
[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:
1. Clone the project from this repository.
2. Go to the project root and run the following maven command (make sure that your environment is set to Java 18):
```bash
[mtaman]:~ mvn spring-boot:run
```
3. Open it in your IDE, set project Java language to 20, and run the main app class `com.sxi.lab.fizzbus.FizzBusApplication`.
4. Finally, you can access its swagger documentation from this URL [http://localhost:8090/api/v1/fizz-bus/doc/index.html](http://localhost:8090/api/v1/fizz-bus/doc/index.html). Which will be used for testing the application.
### Related Articles
I have written two Java Magazine articles explaining this project and the general problems considering zoned Date-Time implementations.
1. **Part 1** - Handling Java Time Zone in Distributed Systems: [Correctly implementing Zoned Date/Time in distributed System with Java](https://blogs.oracle.com/javamagazine/post/java-timezone-part-1).
2. **Part 2** - Handling Java Time Zone in Distributed Systems: [Implementing Zoned Date/Time in distributed FizzBus Service](https://blogs.oracle.com/javamagazine/post/java-timezone-part-2).