You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2015/11/22 20:42:26 UTC
[8/8] isis git commit: ISIS-128: isis-maven-plugin xsd image
ISIS-128: isis-maven-plugin xsd image
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/d8473972
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/d8473972
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/d8473972
Branch: refs/heads/master
Commit: d8473972e902d319d25eadf02f62d3c2412244c3
Parents: c70d6ef
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Sun Nov 22 19:42:11 2015 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Sun Nov 22 19:42:11 2015 +0000
----------------------------------------------------------------------
.../asciidoc/guides/_cg_isis-maven-plugin_xsd.adoc | 15 ++++++++-------
1 file changed, 8 insertions(+), 7 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/d8473972/adocs/documentation/src/main/asciidoc/guides/_cg_isis-maven-plugin_xsd.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_cg_isis-maven-plugin_xsd.adoc b/adocs/documentation/src/main/asciidoc/guides/_cg_isis-maven-plugin_xsd.adoc
index 1e52c08..8b1b5b6 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_cg_isis-maven-plugin_xsd.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_cg_isis-maven-plugin_xsd.adoc
@@ -28,15 +28,16 @@ Defaults to `generated-resources/isis-xsd`
+
Defaults to `false`. Most DTO classes will reference one another or the xref:rg.adoc#_rg_schema-common[common schema]. Normally it's fine to merge all these XSDs together. This property, if set, results in each a separate directory for each generation of its XSD or XSDs.
-The sections below explain in more detail how to configure the plugin.
-
-As a convenience to potential Java subscribers, the XSDs generated from the view models can then in turn be generated
-into DTOs. The original view models and these DTOs are similar but not identical: the view models can only be used
+As a convenience to any (Java) consumers, the XSDs generated from the view models can then in turn be generated
+into DTOs. The original view models and these DTOs are similar but not identical: while the view models can only be used
within the Isis application (they may reference underlying domain entities) whereas the DTO classes generated from the
XSDs can be used standalone, eg by a Java subscriber running on an ESB such as Apache Camel.
+The diagram below shows how these different plugins fit together:
+image::{_imagesdir}maven-plugin/xsd-goal.png[width="800px",link="{_imagesdir}maven-plugin/xsd-goal.png"]
+The sections below explain in more detail how to configure the `xsd` plugin (and other plugins).
[[_cg_isis-maven-plugin_xsd]]
== `xsd` submodule
@@ -308,14 +309,14 @@ If for any reason you want to disable the generation of the DTOs, use:
[source,bash]
----
-mvn test -Dskip.xjc
+mvn package -Dskip.xjc
----
-If you want to disable the generation of both the XSDs and the DTOs, use:
+If you want to disable the generation of both the XSDs and the DTOs, use:
[source,bash]
----
-mvn test -Dskip.xjc -Dskip.isis-xsd
+mvn package -Dskip.xjc -Dskip.isis-xsd
----