deltaspike-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rdebussc...@apache.org
Subject deltaspike git commit: DELTASPIKE-798: Documentation for creating an Uber-jar
Date Fri, 19 Dec 2014 15:24:26 GMT
Repository: deltaspike
Updated Branches:
  refs/heads/master 5d8b92dbe -> 65c9a3bde


DELTASPIKE-798: Documentation for creating an Uber-jar


Project: http://git-wip-us.apache.org/repos/asf/deltaspike/repo
Commit: http://git-wip-us.apache.org/repos/asf/deltaspike/commit/65c9a3bd
Tree: http://git-wip-us.apache.org/repos/asf/deltaspike/tree/65c9a3bd
Diff: http://git-wip-us.apache.org/repos/asf/deltaspike/diff/65c9a3bd

Branch: refs/heads/master
Commit: 65c9a3bde4ace2d25b1e5a8879a0ad3ebdb52b14
Parents: 5d8b92d
Author: Rudy De Busscher <rudy.debusscher@c4j.be>
Authored: Fri Dec 19 16:25:28 2014 +0100
Committer: Rudy De Busscher <rudy.debusscher@c4j.be>
Committed: Fri Dec 19 16:25:28 2014 +0100

----------------------------------------------------------------------
 documentation/src/main/asciidoc/container-control.adoc | 11 +++++++++++
 1 file changed, 11 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/deltaspike/blob/65c9a3bd/documentation/src/main/asciidoc/container-control.adoc
----------------------------------------------------------------------
diff --git a/documentation/src/main/asciidoc/container-control.adoc b/documentation/src/main/asciidoc/container-control.adoc
index 39e1f4d..6bcec63 100644
--- a/documentation/src/main/asciidoc/container-control.adoc
+++ b/documentation/src/main/asciidoc/container-control.adoc
@@ -35,6 +35,17 @@ For instructions and examples on using this feature in your projects, see
<<cdii
 === ContextControl Usage
 The `ContextControl` interface provides life-cycle control of the CDI container built-in
contexts. This includes starting and stoping built-in standard contexts like `@RequestScoped`,
`@ConversationScoped`, and `@SessionScoped`. It is provided as an `@Dependent` bean and can
be injected in the classic CDI way. This feature can be used and is helpful in all Java environments,
including Java SE, as illustrated here.
 
+=== Procedure for builing Uber jar
+Uber jar or executable jar can created by using the maven shade plugin. Some things you needs
to be aware of when you use it.
+
+* Multiple `beans.xml` and `javax.enterprise.inject.spi.Extension` files needs to be merged
into the final jar using a transformer.
+[source,xml]
+----
+<transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
+----
+* The _asm:asm:3.3.1_ transitive dependency of OpenWebBeans isn't properly included in the
Uber jar.  Add it as a project dependency if you use OWB. (Only needed for OWB 1.1.8 !)
+* Some frameworks, like logging frameworks, aren't CDI compatible.  So you need to exclude
them from scanning. Use for example the `scan` feature of Weld to define which packages needs
to be excluded.
+
 ==== Restart the RequestContext in Unit Tests
 In unit testing it can be necessary to test with attached and also with
 detached JPA entities. A very common approach for JPA is the


Mime
View raw message