You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@deltaspike.apache.org by bu...@apache.org on 2012/09/13 17:52:02 UTC
svn commit: r831919 - in /websites/staging/deltaspike/trunk/content: ./
deltaspike/community.html deltaspike/documentation.html
deltaspike/resources/css/bootstrap.css deltaspike/source.html
Author: buildbot
Date: Thu Sep 13 15:52:02 2012
New Revision: 831919
Log:
Staging update by buildbot for deltaspike
Modified:
websites/staging/deltaspike/trunk/content/ (props changed)
websites/staging/deltaspike/trunk/content/deltaspike/community.html
websites/staging/deltaspike/trunk/content/deltaspike/documentation.html
websites/staging/deltaspike/trunk/content/deltaspike/resources/css/bootstrap.css
websites/staging/deltaspike/trunk/content/deltaspike/source.html
Propchange: websites/staging/deltaspike/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Sep 13 15:52:02 2012
@@ -1 +1 @@
-1384335
+1384384
Modified: websites/staging/deltaspike/trunk/content/deltaspike/community.html
==============================================================================
--- websites/staging/deltaspike/trunk/content/deltaspike/community.html (original)
+++ websites/staging/deltaspike/trunk/content/deltaspike/community.html Thu Sep 13 15:52:02 2012
@@ -66,20 +66,16 @@ If you have troubles to find the informa
<p>Furthermore, you can check our <a href="http://mail-archives.apache.org/mod_mbox/incubator-deltaspike-users/">mail-archive</a> (mirrors are available at: <a href="http://markmail.org/search/?q=list%3Aorg.apache.incubator.deltaspike-users+order%3Adate-backward">MarkMail</a>).</p>
<p>Before you file a ticket in our <a href="https://issues.apache.org/jira/browse/DELTASPIKE">Jira</a>, please ask on the mailing list if it's a known issue in case of a bug or if there is an ongoing discussion in case of a feature.</p>
<p>You are very welcome to follow our twitter account <a href="http://twitter.com/#!/DeltaSpikeTeam">@DeltaSpikeTeam</a> and spread the word of DeltaSpike with Tweets, Blog-Entries,...</p>
-<p> </p>
<h1 id="contributors">Contributors</h1>
<p>Before you get a committer you have to contribute to our effort. E.g. you can help users, participate in discussions on the dev list, submit patches,... . Therefore, it's essential to file a/n <a href="http://www.apache.org/licenses/icla.txt">(I)CLA</a> or <a href="http://www.apache.org/licenses/cla-corporate.txt">CLA</a> and send it to secretary at apache dot org (or fax it) as early as possible.</p>
<p>If you would like to submit a patch through Jira, you can have a look at the <a href="suggested-git-workflows.html">suggested approach</a></p>
-<p> </p>
<h1 id="committers">Committers</h1>
<p>Before you read this section, please ensure that you have read the contributor section. All of you are welcome to join our development effort. <a href="mailto:deltaspike-dev-subscribe@incubator.apache.org">Subscribe</a> our <a href="mailto:deltaspike-dev@incubator.apache.org">mailing list for developers</a> and start contributing and help users.</p>
<p>Optionally <a href="mailto:deltaspike-commits-subscribe@incubator.apache.org">subscribe</a> our <a href="mailto:deltaspike-commits@incubator.apache.org">mailing list for commits</a>.</p>
<p>Furthermore, you can check our <a href="http://mail-archives.apache.org/mod_mbox/incubator-deltaspike-dev/">mail-archive</a> (mirrors are available at <a href="http://markmail.org/search/?q=list%3Aorg.apache.incubator.deltaspike-dev+order%3Adate-backward">MarkMail</a> and <a href="http://apache-deltaspike-incubator-discussions.2316169.n4.nabble.com/">Nabble</a>).</p>
<p>Further details are available at <a href="http://www.apache.org/dev/">http://www.apache.org/dev/</a>.</p>
<p>Procedure to become a new <a href="new-commiter">committer</a></p>
-<p> </p>
<h1 id="mailing-lists">Mailing lists</h1>
-<p> </p>
<table class="table">
<thead>
<tr>
@@ -127,13 +123,11 @@ If you have troubles to find the informa
<li>Mail Archived : <a href="http://mail-archives.apache.org/mod_mbox/incubator-deltaspike-users/">mail-archive</a></li>
<li>Mirrors are available at: <a href="http://markmail.org/search/?q=list%3Aorg.apache.incubator.deltaspike-users+order%3Adate-backward">MarkMail</a></li>
</ul>
-<p> </p>
-<h1 id="twitter-irc">Twitter, IRC</h1>
+<h1 id="twitter-irc">Twitter - IRC</h1>
<ul>
<li>Twitter : <a href="http://twitter.com/#!/DeltaSpikeTeam">@DeltaSpikeTeam</a></li>
<li>IRC : Server irc.freenode.net and channel #deltaspike</li>
</ul>
-<p> </p>
<h1 id="jira">JIRA</h1>
<ul>
<li>Web Site : [Jira](https://issues.apache.org/jira/browse/DELTASPIKE</li>
Modified: websites/staging/deltaspike/trunk/content/deltaspike/documentation.html
==============================================================================
--- websites/staging/deltaspike/trunk/content/deltaspike/documentation.html (original)
+++ websites/staging/deltaspike/trunk/content/deltaspike/documentation.html Thu Sep 13 15:52:02 2012
@@ -62,71 +62,55 @@
</div>
<p><div class="toc">
<ul>
-<li><a href="#get-your-shoes-with-deltaspike">Get your shoes with DeltaSpike</a><ul>
-<li><a href="#with-java-ee6">With Java-EE6+</a></li>
-<li><a href="#without-java-ee6">Without Java-EE6+</a></li>
-<li><a href="#with-java-se">With Java-SE</a></li>
-</ul>
-</li>
-<li><a href="#features">Features</a></li>
+<li><a href="#get-your-shoes-with-deltaspike">Get your shoes with DeltaSpike</a></li>
+<li><a href="#a-more-complex-case">A more complex case</a></li>
+<li><a href="#projects-features">Project's features</a></li>
</ul>
</div>
<hr />
<h1 id="get-your-shoes-with-deltaspike">Get your shoes with DeltaSpike</h1>
-<p>As <a href="">CDI</a> implmentations are not provided out of the box top of all Java Containers (Java SE, Web Application Server - Apache Tomcat, Eclipse Jetty, ...), this is where DeltaSpike will help
-you as it provides the tooling required to bootstrap the container. One of the key benefit is that it offers you the possibility to start with the CDI implementation
-of your choice (<a href="">JBoss Weld</a>, <a href="">Apache OpenWebbeans</a>, <a href="">Apache OpenEJB</a>) as it uses the ServiceLoader of JDK to detect which implementation has been packaged in your
-project's classpath.</p>
-<p>To</p>
-<p>Required modules:</p>
-<ul>
-<li>Core</li>
-</ul>
-<p><strong>Hint</strong></p>
-<p>In the listings below replace the placeholders for the version with the version of your choice or use:</p>
-<div class="codehilite"><pre><span class="nt"><properties></span>
- <span class="nt"><deltaspike.version></span>0.3-incubating<span class="nt"></deltaspike.version></span>
-<span class="nt"></properties></span>
-</pre></div>
-
+<p>As a <a href="http://jcp.org/en/jsr/detail?id=299">CDI</a> container is not provided out of the box top of all Java runtime (Java-SE, Web Application Server - Apache Tomcat, Eclipse Jetty, ...),
+DeltaSpike will help you as it provides the tooling required to bootstrap a standalone container. Moreover it offers you the possibility to start with the CDI implementation
+of your choice (<a href="http://docs.jboss.org/weld/reference/1.1.5.Final/en-US/html/">JBoss Weld</a>, <a href="http://openwebbeans.apache.org">Apache OpenWebbeans</a>, <a href="http://openejb.apache.org">Apache OpenEJB</a>)
+as it uses the ServiceLoader of JDK to detect which implementation has been packaged in your project's classpath.</p>
+<p>To bootstrap a CDI container in your Java application, you just need to instantiate the CdiContainer and call the boot method.</p>
+<div class="codehilite"><pre> <span class="nb">import</span> <span class="n">org</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">cdise</span><span class="o">.</span><span class="n">api</span><span class="o">.</span><span class="n">CdiContainer</span><span class="p">;</span>
+ <span class="nb">import</span> <span class="n">org</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">cdise</span><span class="o">.</span><span class="n">api</span><span class="o">.</span><span class="n">CdiContainerLoader</span><span class="p">;</span>
+ <span class="o">....</span>
-<h2 id="with-java-ee6">With Java-EE6+</h2>
-<p>If you are using DeltaSpike in a Java-EE6 environment, you don't need to configure a CDI implementation explicitly because it's shipped with the container.</p>
-<h2 id="without-java-ee6">Without Java-EE6+</h2>
-<p>Java-EE5 application servers as well as pure servlet containers like Apache Tomcat don't provide a CDI implementation out-of-the-box. So don't forget to setup the CDI implementation of your choice.</p>
-<h2 id="with-java-se">With Java-SE</h2>
-<p>Several DeltaSpike features can be used with Java-SE5+ only. Therefore, you have to bootstrap the CDI container of your choise manually.</p>
-<div class="codehilite"><pre><span class="n">public</span> <span class="n">class</span> <span class="n">SimpleApp</span> <span class="p">{</span>
+ <span class="n">public</span> <span class="n">class</span> <span class="n">SimpleApp</span> <span class="p">{</span>
<span class="n">public</span> <span class="n">static</span> <span class="n">void</span> <span class="n">main</span><span class="p">(</span><span class="n">String</span><span class="o">[]</span> <span class="n">args</span><span class="p">)</span> <span class="p">{</span>
- <span class="n">CdiContainer</span><span class="o">.</span><span class="n">start</span><span class="p">();</span>
- <span class="sr">//</span><span class="n">You</span> <span class="n">can</span> <span class="k">use</span> <span class="n">CDI</span> <span class="n">here</span> <span class="o">-</span> <span class="n">since</span> <span class="n">you</span> <span class="n">can</span><span class="err">'</span><span class="n">t</span> <span class="n">inject</span> <span class="n">a</span> <span class="n">bean</span> <span class="n">in</span> <span class="n">this</span> <span class="n">class</span> <span class="n">directly</span> <span class="k">use</span> <span class="n">the</span> <span class="n">BeanManagerProvider</span> <span class="ow">or</span> <span class="n">the</span> <span class="n">BeanProvider</span>
+ <span class="n">CdiContainer</span> <span class="n">CdiContainer</span> <span class="o">=</span> <span class="n">CdiContainerLoader</span><span class="o">.</span><span class="n">getCdiContainer</span><span class="p">();</span>
+ <span class="n">CdiContainer</span><span class="o">.</span><span class="n">boot</span><span class="p">();</span>
+
+ <span class="sr">//</span> <span class="n">You</span> <span class="n">can</span> <span class="k">use</span> <span class="n">CDI</span> <span class="n">here</span>
- <span class="n">CdiContainer</span><span class="o">.</span><span class="n">stop</span><span class="p">();</span>
+ <span class="n">CdiContainer</span><span class="o">.</span><span class="nb">shutdown</span><span class="p">();</span>
<span class="p">}</span>
<span class="p">}</span>
+</pre></div>
-<span class="o">/**</span>
- <span class="o">*</span> <span class="n">Helper</span> <span class="n">class</span> <span class="n">to</span> <span class="n">start</span> <span class="ow">and</span> <span class="n">stop</span> <span class="n">the</span> <span class="n">OpenWebBeansContainer</span>
- <span class="o">*/</span>
-<span class="n">public</span> <span class="n">class</span> <span class="n">CdiContainer</span> <span class="p">{</span>
- <span class="n">private</span> <span class="n">static</span> <span class="n">ContainerLifecycle</span> <span class="n">lifecycle</span> <span class="o">=</span> <span class="n">null</span><span class="p">;</span>
-
- <span class="n">public</span> <span class="n">static</span> <span class="n">void</span> <span class="n">start</span><span class="p">()</span> <span class="p">{</span>
- <span class="n">lifecycle</span> <span class="o">=</span> <span class="n">WebBeansContext</span><span class="o">.</span><span class="n">currentInstance</span><span class="p">()</span><span class="o">.</span><span class="n">getService</span><span class="p">(</span><span class="n">ContainerLifecycle</span><span class="o">.</span><span class="n">class</span><span class="p">);</span>
- <span class="n">lifecycle</span><span class="o">.</span><span class="n">startApplication</span><span class="p">(</span><span class="n">null</span><span class="p">);</span>
- <span class="p">}</span>
- <span class="n">public</span> <span class="n">static</span> <span class="n">void</span> <span class="n">stop</span><span class="p">()</span> <span class="p">{</span>
- <span class="n">lifecycle</span><span class="o">.</span><span class="n">stopApplication</span><span class="p">(</span><span class="n">null</span><span class="p">);</span>
- <span class="p">}</span>
-<span class="p">}</span>
+<p>When boot is called, the CdiContainer will scan the whole classpath for Beans and CDI extensions available.</p>
+<p>Note: booting the container does <i>not</i> automatically start all CDI Contexts! Depending on the underlying CDI container you might need to invoke <code>getContextControl()
+and execute ContextControl#startContext(Class)</code> or <code>ContextControl#startContexts()</code>.</p>
+<p>To inject a bean in this project, you should use the <code>BeanManagerProvider</code> or the <code>BeanProvider</code> like this</p>
+<div class="codehilite"><pre><span class="n">EchoService</span> <span class="n">defaultEchoService</span> <span class="o">=</span> <span class="n">BeanProvider</span><span class="o">.</span><span class="n">getContextualReference</span><span class="p">(</span><span class="n">DefaultEchoService</span><span class="o">.</span><span class="n">class</span><span class="p">,</span> <span class="n">false</span><span class="p">);</span>
</pre></div>
-<h1 id="features">Features</h1>
-<p>Another characteristic of DeltaSpike is that it provides <a href="">CDI extension</a> to cover new features which are not proposed by the CDI 1.0 specification.
-Such features</p></p>
+<p>When you have finish the job, simply call <code>shutdown()</code> to tell to the CDI container to destroy the beans instantiated</p>
+<p>Remarks :</p>
+<ul>
+<li>Java-EE5 : Java-EE5 application servers as well as pure servlet containers like Apache Tomcat don't provide a CDI implementation out-of-the-box. So don't forget to setup the CDI implementation of your choice.</li>
+<li>Java-EE6+ : If you are using DeltaSpike in a Java-EE6 environment, you don't need to configure a CDI implementation explicitly because it's shipped with the container.</li>
+</ul>
+<h1 id="a-more-complex-case">A more complex case</h1>
+<p>TBD</p>
+<h1 id="projects-features">Project's features</h1>
+<p>Another characteristic of DeltaSpike is that it provides <a href="">CDI extension</a> to cover new features which are not proposed by the CDI 1.0 specification.</p>
+<p>TBD</p></p>
</div>
</div>
Modified: websites/staging/deltaspike/trunk/content/deltaspike/resources/css/bootstrap.css
==============================================================================
--- websites/staging/deltaspike/trunk/content/deltaspike/resources/css/bootstrap.css (original)
+++ websites/staging/deltaspike/trunk/content/deltaspike/resources/css/bootstrap.css Thu Sep 13 15:52:02 2012
@@ -465,7 +465,8 @@ h6 small {
h1 {
font-size: 30px;
- line-height: 36px;
+ /* line-height: 36px; */
+ line-height: 56px;
}
h1 small {
@@ -474,7 +475,8 @@ h1 small {
h2 {
font-size: 24px;
- line-height: 36px;
+ /* line-height: 36px; */
+ line-height: 48px;
}
h2 small {
Modified: websites/staging/deltaspike/trunk/content/deltaspike/source.html
==============================================================================
--- websites/staging/deltaspike/trunk/content/deltaspike/source.html (original)
+++ websites/staging/deltaspike/trunk/content/deltaspike/source.html Thu Sep 13 15:52:02 2012
@@ -76,9 +76,7 @@
<li>We follow an unified <a href="suggested-git-workflows.html">GIT workflow</a> to keep the commit history straight and therefore simple and clean.
General details about GIT at Apache are available <a href="http://wiki.apache.org/couchdb/Git_At_Apache_Guide">here</a> and at <a href="http://git-wip-us.apache.org">http://git-wip-us.apache.org</a>.</li>
</ul>
-<p> </p>
<h1 id="how-to-checkout-the-code">How to checkout the code</h1>
-<p> </p>
<h2 id="anonymous-users">Anonymous users</h2>
<p>Users can download the code source from GitHub repository or Apache Git using the following urls and git clone instruction.
More information about URL to be used can be find <a href="https://help.github.com/articles/which-remote-url-should-i-use">here</a></p>
@@ -93,23 +91,18 @@ More information about URL to be used ca
</pre></div>
-<p> </p>
<h2 id="members">Members</h2>
<p>The members of DeltaSpike project which are also committers and contributers will use a different URL address</p>
<div class="codehilite"><pre><span class="n">git</span> <span class="n">clone</span> <span class="n">https:</span><span class="sr">//gi</span><span class="n">t</span><span class="o">-</span><span class="n">wip</span><span class="o">-</span><span class="n">us</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="sr">/repos/</span><span class="n">asf</span><span class="o">/</span><span class="n">incubator</span><span class="o">-</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">git</span>
</pre></div>
-<p> </p>
<h1 id="build">Build</h1>
<p>So now you probably want to <strong><code>build the code</code></strong>. So follow here the <a href="build.html">instructions</a></p>
-<p> </p>
<h1 id="formatting-code">Formatting code</h1>
<p>Users/committers when providing code (patches, ...) should adopt "formatting rules" which are provided hereafter for IntelliJ and Eclipse</p>
-<p> </p>
<h2 id="intellij">IntelliJ</h2>
<p><a href="resources/files/settings.jar">Attached</a> you can find the settings for formatting the source code. Import them via File | Import Settings...</p>
-<p> </p>
<h2 id="eclipse">Eclipse</h2>
<p>For Eclipse you can use this <a href="resources/files/deltaspike-code-conventions.xml">Code Formatter Profile</a>. Import it via Window | Preferences | Java | Code Style | Formatter</p></p>
</div>