Andrew Lalis d60f7142e8 | ||
---|---|---|
.. | ||
.mvn/wrapper | ||
sample_data | ||
src | ||
.gitignore | ||
README.md | ||
gen_keys.d | ||
mvnw | ||
mvnw.cmd | ||
pom.xml |
README.md
Gymboard API
An HTTP/REST API powered by Java and Spring Boot. This API serves as the main entrypoint for all data processing, and is generally the first point-of-contact for the web app or other services that consume Gymboard data.
Development
To ease development, nl.andrewlalis.gymboard_api.util.SampleDataLoader
will run on startup and populate the database with some sample entities. You can regenerate this data by manually deleting the database, and deleting the .sample_data
marker file that's generated in the project directory.
ULIDs
For entities that don't need a human-readable primary key (or keys), we choose to use ULID strings, which are like UUIDs, but use a timestamp based preamble such that their values are monotonically increasing, and lexicographically ordered by creation time. The result is a pseudorandom string of 26 characters which appears random to a human, yet is efficient as a primary key. It's also near-impossible for automated systems to guess previous/next ids.