Skip to content

Commit 2dded4e

Browse files
authored
Clean getting-started document (#591)
* Talk about styles * Add a note about Eclipse * Remove a blank line * Add a description of the DSL style
1 parent 6b54536 commit 2dded4e

File tree

1 file changed

+9
-4
lines changed

1 file changed

+9
-4
lines changed

docs/getting-started.rst

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,9 @@ Eclipse
6161
-------
6262

6363
We tested Eclipse 2020-09.
64+
Note that you need `a patch <https://marketplace.eclipse.org/content/java-15-support-eclipse-2020-09-417>`_
65+
to enable Java 15 features.
66+
See also `this movie <https://www.youtube.com/watch?v=-qsW-0Ztg_U>`_.
6467

6568
Before importing, generate eclipse files as follows:
6669

@@ -87,11 +90,10 @@ Import `getting-started` to your IDEA as a Gradle project.
8790
If you use IntelliJ IDEA Ultimate Edition,
8891
`Doma Support <https://plugins.jetbrains.com/plugin/7615-doma-support>`_ can help you.
8992

93+
Programming styles
94+
==================
9095

91-
Programming model
92-
=================
93-
94-
Doma provides 2 styles to access database as follows:
96+
Doma supports two programming styles as follows:
9597

9698
- DSL style
9799
- DAO style
@@ -100,6 +102,9 @@ DSL style allows you to build type-safe SQL statements with the Criteria API.
100102
DAO style allows you to map SQL statements to methods defined in the Java interface.
101103

102104
We recommend you prefer the DSL style.
105+
This is because the Criteria API, which enables the DSL style, has many advantages.
106+
For example, the Criteria API does not use reflection.
107+
It also supports associations such as one-to-many, many-to-one, one-to-one.
103108

104109
DSL style
105110
=========

0 commit comments

Comments
 (0)