Skip to content

Commit 31aa02a

Browse files
authored
Added gitbook content (#4)
* Added gitbook content Added user guide pdf * Added links to new content
1 parent 2c90c4d commit 31aa02a

File tree

126 files changed

+45541
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

126 files changed

+45541
-0
lines changed

_site/asciidoc/index.adoc

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,10 @@ ifdef::env-github,env-browser[:outfilesuffix: .adoc]
99
.. link:news/news{outfilesuffix}[News]
1010
... link:news/archived-news{outfilesuffix}[Archived News]
1111

12+
== Documentation
13+
.. link:gitbook/index.html[Git Book]
14+
.. link:user-guide.pdf[User Guide.pdf]
15+
1216
== Community
1317
.. link:community/articles{outfilesuffix}[Articles]
1418
.. link:community/support{outfilesuffix}[Support]

gitbook/about/about.adoc

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
== What is Dozer?
2+
Dozer is a Java Bean to Java Bean mapper that recursively copies data
3+
from one object to another. Typically, these Java Beans will be of
4+
different complex types.
5+
6+
Dozer supports simple property mapping, complex type mapping,
7+
bi-directional mapping, implicit-explicit mapping, as well as recursive
8+
mapping. This includes mapping collection attributes that also need
9+
mapping at the element level.
10+
11+
Dozer not only supports mapping between attribute names, but also
12+
automatically converting between types. Most conversion scenarios are
13+
supported out of the box, but Dozer also allows you to specify custom
14+
conversions via XML.
15+
16+
The mapper is used any time you need to take one type of Java Bean and
17+
map it to another type of Java Bean. Most field mapping can be done
18+
automatically by Dozer using reflection, but any custom mapping can be
19+
predescribed in XML format. Mapping is bi-directional so only one
20+
relationship between classes needs defining. If any property names on
21+
both objects are the same you do not even need to do any explicit
22+
property mapping for these fields.
23+
24+
The picture below depicts some of the common areas Dozer could be
25+
inserted into an architecture. Notice that it typically is utilized at
26+
the boundaries (entry/exit). Dozer will make sure that your internal
27+
domain objects from the database do not bleed into external presentation
28+
layers or to external consumers. It can also help map your domain
29+
objects to external APIs calls and vice-versa.
30+
31+
image:../images/architecture.gif[architecture]
32+
33+
The bean mapper is written in Java and relies heavily on the Jakarta
34+
Commons Bean Utils package for Java Bean utility methods.
35+
36+
=== Why Map?
37+
Please read the link:../documentation/whymap.adoc[Why Map?] page.
38+
39+
=== Frequently Asked Questions
40+
Please read the link:../documentation/faq.adoc[FAQ] page.

0 commit comments

Comments
 (0)