Welcome ✦
Here's the English translation of the provided Markdown file:
Getting Started Notes
Jimmer is an ORM framework that uses precompilation technology, with most of its magic coming from compile time rather than runtime. Therefore, precompilation is required:
-
For Java, this means APT, Annotation Processor Tool
-
For Kotlin, this means KSP, Kotlin Symbol Processing
For readers with no experience with JVM precompilation frameworks, the project's build approach may be unfamiliar. Instead of directly writing code, it's recommended to first run the simplest official example:
By successfully running these simple examples, readers will quickly become familiar with the build process for this type of project:
-
No environment setup is required, as the project uses an H2 in-memory database and automatically creates data on startup
-
If you open the project in an IDE before the first compilation, you may find some types are undefined because these types are automatically generated after precompilation. Please ignore the related errors and directly click the IDE's Run button - the errors will disappear automatically
-
Using the community-contributed Jimmer-Buddy plugin can improve the development experience during the precompilation process
Where are the examples and quick start guides?
When facing a new framework, developers' first reaction is to ask where the examples and quick start guides are:
-
Included examples: Official Examples
-
Quick start: Get Started
About This Documentation
The chapters of this documentation are divided into two types:
-
Tutorial chapters marked with a ★ symbol.
-
The most important article, marked with a ✦ symbol.
It discusses Jimmer's innovations, introduces all its features, and provides rich, concise demonstrations.
-
A quick preview of Jimmer's three most basic introductory features:
-
Querying any shape
-
Saving any shape
-
Arbitrary dynamic queries.
This chapter only includes these 3 core capabilities and does not cover other advanced features.
-
-
For any framework, some features can be demonstrated with code and do not require extensive explanations to aid understanding.
All such features that can be easily demonstrated with code and do not require much explanation are listed in this chapter.
-
-
Other chapters.
The remaining chapters should be treated as reference books, not tutorials.
These chapters delve into the details of various features, including advanced ones.
Discussion
Welcome to join the Jimmer community, Discord Link: https://discord.gg/PmgR5mpY3E