deltaspike-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r932463 - in /websites/staging/deltaspike/trunk/content: ./ retired/documentation.html
Date Fri, 12 Dec 2014 17:33:42 GMT
Author: buildbot
Date: Fri Dec 12 17:33:41 2014
New Revision: 932463

Log:
Staging update by buildbot for deltaspike

Modified:
    websites/staging/deltaspike/trunk/content/   (props changed)
    websites/staging/deltaspike/trunk/content/retired/documentation.html

Propchange: websites/staging/deltaspike/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Dec 12 17:33:41 2014
@@ -1 +1 @@
-1644029
+1644984

Modified: websites/staging/deltaspike/trunk/content/retired/documentation.html
==============================================================================
--- websites/staging/deltaspike/trunk/content/retired/documentation.html (original)
+++ websites/staging/deltaspike/trunk/content/retired/documentation.html Fri Dec 12 17:33:41 2014
@@ -82,547 +82,46 @@
               </div>
               <div class="toc">
 <ul>
-<li><a href="#introduction">Introduction</a><ul>
-<li><a href="#what-is-a-portable-cdi-extension">What is a portable CDI extension ?</a></li>
-<li><a href="#deltaspike-in-a-nutshell">DeltaSpike in a nutshell</a><ul>
-<li><a href="#java-ee-7-without-java-ee-7">Java EE 7 without Java EE 7!</a></li>
-<li><a href="#jsf-improvements">JSF Improvements</a></li>
-<li><a href="#productivity-improvements">Productivity Improvements</a></li>
-</ul>
-</li>
-</ul>
-</li>
-<li><a href="#getting-started">Getting Started</a><ul>
-<li><a href="#project-configuration-without-maven">Project Configuration without Maven</a></li>
-<li><a href="#project-configuration-with-maven">Project Configuration with Maven</a><ul>
-<li><a href="#configuration-of-deltaspike-core">Configuration of DeltaSpike Core</a></li>
-<li><a href="#configuration-of-deltaspike-modules">Configuration of DeltaSpike Modules</a><ul>
-<li><a href="#security-module">Security Module</a></li>
-<li><a href="#jpa-module">JPA Module</a></li>
-<li><a href="#jsf-module">JSF Module</a></li>
-<li><a href="#bean-validation-module">Bean Validation Module</a></li>
-<li><a href="#servlet-module">Servlet Module</a></li>
-<li><a href="#data-module">Data Module</a></li>
-<li><a href="#test-control-module">Test-Control Module</a></li>
-<li><a href="#scheduler-module">Scheduler Module</a></li>
-</ul>
-</li>
-<li><a href="#with-java-se">With Java SE</a><ul>
-<li><a href="#add-the-deltaspike-container-ctrl-api">Add the DeltaSpike Container Ctrl API</a></li>
-<li><a href="#add-a-cdi-container-container-ctrl-impl">Add a CDI container + Container Ctrl Impl</a></li>
-</ul>
-</li>
-<li><a href="#for-apache-openwebbeans">... for Apache OpenWebBeans</a></li>
-<li><a href="#for-jboss-weld-ri">... for JBoss Weld (RI)</a></li>
-<li><a href="#for-embedded-servlet-runtimes-you-can-add">For Embedded Servlet Runtimes, you can add</a></li>
-<li><a href="#testing-snapshots">Testing Snapshots</a></li>
-</ul>
-</li>
-</ul>
-</li>
-<li><a href="#deployment-mode">Deployment mode</a><ul>
-<li><a href="#with-java-ee6">With Java EE6+</a></li>
-<li><a href="#with-java-ee5-or-servlet-containers">With Java EE5 or Servlet Containers</a></li>
-<li><a href="#standard-java-se6">Standard Java SE6+</a></li>
-</ul>
-</li>
-<li><a href="#start-a-cdi-container-using-java-se">Start a CDI container using Java SE</a></li>
-<li><a href="#module-overview">Module Overview</a><ul>
-<li><a href="#core-required">Core (required)</a></li>
-<li><a href="#security-optional">Security (optional)</a></li>
-<li><a href="#jpa-optional">JPA (optional)</a></li>
-<li><a href="#jsf-optional">JSF (optional)</a></li>
-<li><a href="#container-control-optional">Container Control (optional)</a></li>
-<li><a href="#bean-validation-optional">Bean Validation (optional)</a></li>
-<li><a href="#servlet-optional">Servlet (optional)</a></li>
-<li><a href="#partial-bean-optional">Partial-Bean (optional)</a></li>
-<li><a href="#data-optional">Data (optional)</a></li>
-<li><a href="#test-control-optional">Test-Control (optional)</a></li>
-<li><a href="#scheduler-optional">Scheduler (optional)</a></li>
-</ul>
-</li>
-<li><a href="#deltaspike-spi">DeltaSpike SPI</a></li>
-<li><a href="#external">External</a><ul>
-<li><a href="#blogs">Blogs</a></li>
-<li><a href="#add-ons">Add-ons</a></li>
-<li><a href="#project-templates">Project Templates</a></li>
-<li><a href="#examples">Examples</a></li>
-</ul>
-</li>
+<li><a href="#sources">Sources</a></li>
+<li><a href="#format">Format</a></li>
+<li><a href="#rendering-documentation-as-html">Rendering documentation as HTML</a></li>
+<li><a href="#contribute">Contribute</a></li>
+<li><a href="#publish-procedure-for-committers-only">Publish procedure (for committers only)</a></li>
 </ul>
 </div>
 <hr />
-<h1 id="introduction">Introduction</h1>
-<p>Apache DeltaSpike project has been created to support the development of portable CDI extensions that provide useful features for Java applications
-not provided out of the box by the CDI spec (Security, JPA, ...). CDI extensions created by the DeltaSpike community are packaged as modules.</p>
-<p>Therefore, Apache DeltaSpike is a great toolbox for CDI. More than a set of powerful extension and tools to ease extension development, DeltaSpike also proves that CDI allows Java EE to evolve between each release.</p>
-<p>The goal of the project is also to provide useful classes to :</p>
-<ul>
-<li>Boot CDI Container (Weld, OpenWebbeans, OpenEJB) for Java SE,</li>
-<li>Stage a project,</li>
-<li>Provide new scopes (Window Scope, ...),</li>
-<li>Manage messages and configurations</li>
-</ul>
-<p>The project is currently tested on different CDI implementations like Apache OpenWebBeans and JBoss Weld, and also on different Java Web containers like Apache TomEE or JavaEE, JBoss AS7, Oracle GlassFish 3.1+, Oracle WebLogic Server 12c.</p>
-<h2 id="what-is-a-portable-cdi-extension">What is a portable CDI extension ?</h2>
-<p>A portable CDI extension means that CDI itself can be extended. Such extensions can be used with any spec. compliant CDI implementation. From the user perspective, it means that you can simply drop in CDI extension jars into your runtime e.g. to integrate third-party APIs with CDI or to improve existing JavaEE-APIs.</p>
-<p>The CDI Portable extensions SPI (Service Provider Interface) allows to define additional beans, scopes, stereotypes, interceptors and decorators. The SPI of CDI is a powerful vehicle for innovation and DeltaSpike is an example of it.</p>
-<h2 id="deltaspike-in-a-nutshell">DeltaSpike in a nutshell</h2>
-<h3 id="java-ee-7-without-java-ee-7">Java EE 7 without Java EE 7!</h3>
-<p><strong>Transactional support for non-EJB beans:</strong>
-The Transactional Interceptor in DeltaSpike paved the way for @Transactional in Java EE 7.</p>
-<p><strong>Injectable Servlet objects:</strong>
-Allows the developer to inject CDI beans on Servlets on Java EE 6/CDI 1.0  environments</p>
-<p><strong>Injectable resources:</strong>
-Configuration, resource bundles,... are easy to inject when using CDI and Apache DeltaSpike.</p>
-<p><strong>@Exclude annotation:</strong>
-it's possible to annotate beans which should be ignored by CDI even if they are in a CDI enabled archive on Java EE 6/CDI 1.0 environment where you can't use @Vetoed or a veto based on project-stages or expressions is needed.</p>
-<p><strong>Scheduling tasks</strong>:
-Async processes in a non Java EE 7 environment.</p>
-<p><strong>Bean Validation integration:</strong>
-Allows to inject CDI beans and EJB in to Constraint-Validators.</p>
-<p><strong>BeanProvider:</strong>
-Access the BeanManager and CDI beans even in non managed classes like JPA-2.0 EntityListeners or Spring Beans.</p>
-<h3 id="jsf-improvements">JSF Improvements</h3>
-<p><strong>Multi-window handling:</strong>
-Allows to manage logical windows for batches,... or in case of JSF it offers proper separation of browser-tabs.</p>
-<p><strong>Type-safe view-config:</strong>
-It allows to bind meta-data (e.g. for security) to views with a type-safe, but flexible approach. It provides a more solid navigation in case of JSF and helps a lot in the maintenance phase.</p>
-<p><strong>View-Controller:</strong>
-Based on type-safe view-configs view-controller annotations provide a type-safe alternative to standard-tags.</p>
-<p><strong>Injection on Converters and Validators:</strong>
-Allows to inject CDI beans and EJB in to JSF Converters and Validators.</p>
-<p><strong>JSF event broadcasting to CDI:</strong>
-Allows CDI to be notified about JSF events</p>
-<h3 id="productivity-improvements">Productivity Improvements</h3>
-<p><strong>Security based on annotations:</strong>
-The foundation for building a robust, capable and non invasive security solution.</p>
-<p><strong>New CDI scopes:</strong>
-TransactionScoped, WindowScoped, ViewScoped, ViewAccess scope, Grouped conversion scope</p>
-<p><strong>Container Control &amp; Test Control:</strong>
-Java SE with CDI, all with a unifying API. Start, stop, add classes to a running CDI container.</p>
-<p><strong>Data Module:</strong>
-An out of the box entity framework solution complete with support for container or application managed persistence contexts, as well as JDBC.</p>
-<p><strong>Decoupled Exception handling:</strong>
-Allows to do exception handling in one location similar to CDI Observers.</p>
-<p><strong>JMX integration:</strong>
-Any CDI bean can be exposed via JMX easily with one annotation.</p>
-<p><strong>Type-safe i18n messages:</strong>
-Localized messages are easy to use with an interface and a resource bundle, no more boilerplate and your messages now have context within the code.         </p>
-<p><strong>Type-safe Project-Stages:</strong>
-Compared to project-stages in JSF, DeltaSpike provides a type-safe, but still extensible approach which can be used in CDI based applications.</p>
-<h1 id="getting-started">Getting Started</h1>
-<p>A DeltaSpike project can be designed using or not Apache Maven and consists in a collection of jar files. Depending on your needs, you will package DeltaSpike core jar (api and impl) files or extend
-the list with DeltaSpike modules. DeltaSpike Api and Impl are mandatory and provide code required to benefits of portable CDI extensions or useful features
-created.</p>
-<p>Remark : For Java SE, an additional step is required as you have to select the CDI implementation of your choice to boot a CDI container.</p>
-<p>[TODO] Add a section or remark to explain how to package &amp; deploy DeltaSpike in an OSGI environment (Apache Felix, Apache Karaf, Apache ServiceMix)</p>
-<h2 id="project-configuration-without-maven">Project Configuration without Maven</h2>
-<p>You can manually <a href="download.html" target="_blank">download</a> all JARs described above or you get <a href="source.html">the source-code</a> and <a href="build.html">build</a> DeltaSpike manually.</p>
-<h2 id="project-configuration-with-maven">Project Configuration with Maven</h2>
-<p><strong>Hint:</strong>
-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">&lt;properties&gt;</span>
-    <span class="nt">&lt;deltaspike.version&gt;</span>1.0.2<span class="nt">&lt;/deltaspike.version&gt;</span>
-<span class="nt">&lt;/properties&gt;</span>
-</pre></div>
-
-
-<p>Or if you want to very bleeding edge, point to our current snapshot.</p>
-<div class="codehilite"><pre><span class="nt">&lt;properties&gt;</span>
-    <span class="nt">&lt;deltaspike.version&gt;</span>1.0.3-SNAPSHOT<span class="nt">&lt;/deltaspike.version&gt;</span>
-<span class="nt">&lt;/properties&gt;</span>
-</pre></div>
-
-
-<h3 id="configuration-of-deltaspike-core">Configuration of DeltaSpike Core</h3>
-<div class="codehilite"><pre><span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.core<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-core-api<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>compile<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-
-<span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.core<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-core-impl<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>runtime<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-</pre></div>
-
-
-<h3 id="configuration-of-deltaspike-modules">Configuration of DeltaSpike Modules</h3>
-<h4 id="security-module">Security Module</h4>
-<div class="codehilite"><pre><span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.modules<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-security-module-api<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>compile<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-
-<span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.modules<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-security-module-impl<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>runtime<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-</pre></div>
-
-
-<h4 id="jpa-module">JPA Module</h4>
-<div class="codehilite"><pre><span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.modules<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-jpa-module-api<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>compile<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-
-<span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.modules<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-jpa-module-impl<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>runtime<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-</pre></div>
-
-
-<h4 id="jsf-module">JSF Module</h4>
-<div class="codehilite"><pre><span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.modules<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-jsf-module-api<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>compile<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-
-<span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.modules<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-jsf-module-impl<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>runtime<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-</pre></div>
-
-
-<p>Some EE6 servers can't handle optional classes. If you don't like the corresponding log entries during the startup or the deployment fails, you can use an alternative impl-module (instead of deltaspike-jsf-module-impl) since v1.0.1:</p>
-<div class="codehilite"><pre><span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.modules<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-jsf-module-impl-ee6<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>runtime<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-</pre></div>
-
-
-<h4 id="bean-validation-module">Bean Validation Module</h4>
-<div class="codehilite"><pre><span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.modules<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-bean-validation-module-impl<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>runtime<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
+<h1 id="sources">Sources</h1>
+<p><a href="/documentation/">DeltaSpike Documentation</a> is available with <a href="documentation/source.html">DeltaSpike Source</a>.</p>
+<h1 id="format">Format</h1>
+<p>The format used for DeltaSpike documentation is <a href="http://www.methods.co.nz/asciidoc/">ASCIIDOC</a> because it's easily exportable to PDF, HTML, and it's also easy to contribute. It can be used to export also to epub and also be used to write books</p>
+<h1 id="rendering-documentation-as-html">Rendering documentation as HTML</h1>
+<p><em>Requirenment:</em> Have <a href="http://maven.apache.org/">Maven</a> installed.</p>
+<p>If you cloned the source repository and want to render the documentation as HTML, you just need to run the following command:</p>
+<div class="codehilite"><pre>$ <span class="n">cd</span> <span class="n">REPO_ROOT</span><span class="o">/</span><span class="n">documentation</span>
+$ <span class="n">mvn</span> <span class="n">site</span>
 </pre></div>
 
 
-<h4 id="servlet-module">Servlet Module</h4>
-<div class="codehilite"><pre><span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.modules<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-servlet-module-api<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>compile<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-
-<span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.modules<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-servlet-module-impl<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>runtime<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-</pre></div>
-
-
-<h4 id="data-module">Data Module</h4>
-<div class="codehilite"><pre><span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.modules<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-data-module-api<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>compile<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-
-<span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.modules<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-data-module-impl<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>runtime<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-</pre></div>
-
-
-<h4 id="test-control-module">Test-Control Module</h4>
-<div class="codehilite"><pre><span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.modules<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-test-control-module-api<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>test<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-
-<span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.modules<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-test-control-module-impl<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>test<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
+<p>The generate documentation will be available at <code>REPO_ROOT/documentation/target/site</code></p>
+<h1 id="contribute">Contribute</h1>
+<p>If you would like to submit a documentation patch through Jira, you can have a look at the <a href="suggested-git-workflows.html">suggested approach</a>.</p>
+<h1 id="publish-procedure-for-committers-only">Publish procedure (for committers only)</h1>
+<p>If you're a committer and want to publish the documentation at <a href="http://deltaspike.apache.org/documentation/">DeltaSpike Site</a> you have do the following steps:</p>
+<p>Put the following information in your ~/.m2/settings.xml file</p>
+<div class="codehilite"><pre><span class="nt">&lt;server&gt;</span>
+  <span class="nt">&lt;id&gt;</span>deltaspike-site<span class="nt">&lt;/id&gt;</span>
+  <span class="nt">&lt;username&gt;&lt;YOUR_USERNAME&gt;&lt;/username&gt;</span>
+  <span class="nt">&lt;password&gt;&lt;YOUR_PASSWORD&gt;&lt;/password&gt;</span>
+<span class="nt">&lt;/server&gt;</span>
 </pre></div>
 
 
-<h4 id="scheduler-module">Scheduler Module</h4>
-<div class="codehilite"><pre><span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.modules<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-scheduler-module-api<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>compile<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-
-<span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.modules<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-scheduler-module-impl<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>runtime<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
+<p>Then run:</p>
+<div class="codehilite"><pre>$ <span class="n">mvn</span> <span class="n">site</span><span class="o">-</span><span class="n">deploy</span>
 </pre></div>
 
 
-<h3 id="with-java-se">With Java SE</h3>
-<p>To use DeltaSpike with Java SE, we must provide additional jars file corresponding to the DeltaSpike CDI Controller API
-and its implementation. The Controller uses Java Services to resolve the CDI container (<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> (and <a href="http://openejb.apache.org">Apache OpenEJB</a>)) and
-implementation contains the code to manage the <a href="#container-control-optional">CDI container and contexts</a>.</p>
-<p><strong>Hint:</strong>
-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">&lt;properties&gt;</span>
-    <span class="nt">&lt;deltaspike.version&gt;</span>1.0.0<span class="nt">&lt;/deltaspike.version&gt;</span>
-    <span class="nt">&lt;owb.version&gt;</span>1.2.0<span class="nt">&lt;/owb.version&gt;</span>
-    <span class="nt">&lt;weld.version&gt;</span>1.1.9.Final<span class="nt">&lt;/weld.version&gt;</span>
-<span class="nt">&lt;/properties&gt;</span>
-</pre></div>
-
-
-<h4 id="add-the-deltaspike-container-ctrl-api">Add the DeltaSpike Container Ctrl API</h4>
-<div class="codehilite"><pre><span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.cdictrl<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-cdictrl-api<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>compile<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-</pre></div>
-
-
-<h4 id="add-a-cdi-container-container-ctrl-impl">Add a CDI container + Container Ctrl Impl</h4>
-<h3 id="for-apache-openwebbeans">... for Apache OpenWebBeans</h3>
-<div class="codehilite"><pre><span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.openwebbeans<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>openwebbeans-impl<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">owb</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>runtime<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-
-<span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.openwebbeans<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>openwebbeans-spi<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">owb</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>compile<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-
-<span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.cdictrl<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-cdictrl-owb<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>runtime<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-</pre></div>
-
-
-<h3 id="for-jboss-weld-ri">... for JBoss Weld (RI)</h3>
-<div class="codehilite"><pre><span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.cdictrl<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-cdictrl-weld<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>runtime<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-
-<span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.jboss.weld.se<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>weld-se<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">weld</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>runtime<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-</pre></div>
-
-
-<h3 id="for-embedded-servlet-runtimes-you-can-add">For Embedded Servlet Runtimes, you can add</h3>
-<div class="codehilite"><pre><span class="nt">&lt;dependency&gt;</span>
-    <span class="nt">&lt;groupId&gt;</span>org.apache.deltaspike.cdictrl<span class="nt">&lt;/groupId&gt;</span>
-    <span class="nt">&lt;artifactId&gt;</span>deltaspike-cdictrl-servlet<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span><span class="cp">${</span><span class="n">deltaspike</span><span class="o">.</span><span class="n">version</span><span class="cp">}</span><span class="nt">&lt;/version&gt;</span>
-    <span class="nt">&lt;scope&gt;</span>compile<span class="nt">&lt;/scope&gt;</span>
-<span class="nt">&lt;/dependency&gt;</span>
-</pre></div>
-
-
-<h3 id="testing-snapshots">Testing Snapshots</h3>
-<p>If you would like to test the latest Snapshot, you can <a href="http://deltaspike.apache.org/build.html">build</a> DeltaSpike locally or you get it from the Apache Snapshot-Repository:</p>
-<div class="codehilite"><pre><span class="nt">&lt;repositories&gt;</span>
-    <span class="nt">&lt;repository&gt;</span>
-        <span class="nt">&lt;id&gt;</span>apache-snapshot-repository<span class="nt">&lt;/id&gt;</span>
-        <span class="nt">&lt;url&gt;</span>http://repository.apache.org/snapshots/<span class="nt">&lt;/url&gt;</span>
-        <span class="nt">&lt;releases&gt;</span>
-            <span class="nt">&lt;enabled&gt;</span>false<span class="nt">&lt;/enabled&gt;</span>
-        <span class="nt">&lt;/releases&gt;</span>
-        <span class="nt">&lt;snapshots&gt;</span>
-            <span class="nt">&lt;enabled&gt;</span>true<span class="nt">&lt;/enabled&gt;</span>
-        <span class="nt">&lt;/snapshots&gt;</span>
-    <span class="nt">&lt;/repository&gt;</span>
-<span class="nt">&lt;/repositories&gt;</span>
-</pre></div>
-
-
-<h1 id="deployment-mode">Deployment mode</h1>
-<p>DeltaSpike can be deployed in different Java environments. Depending which Java container and release you are using, the procedure which is different
-is explained here after.</p>
-<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="with-java-ee5-or-servlet-containers">With Java EE5 or Servlet Containers</h2>
-<p>Java EE5 application servers as well as pure servlet containers like Apache Tomcat / Eclipse Jetty 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="standard-java-se6">Standard Java SE6+</h2>
-<p>If you are only using a JDK and runs Java in a standalone or standard mode (Java SE), then DeltaSpike will allow you to boot a CDI implementation where you can use Dependency Injection with
-a Bean Manager. Such an example will be presented at the next section.</p>
-<h1 id="start-a-cdi-container-using-java-se">Start a CDI container using Java SE</h1>
-<p>This code snippet show you how with a Java MainApplication a CDI container can be started (= boot) by DeltaSpike using Java SE and how you
- define a CDI scope and resolve beans injected.</p>
-<p><strong>Hint</strong>: To bootstrap a CDI container in your Java application, you just need to instantiate the <code>CdiContainer</code> and call the <code>#boot</code> method.</p>
-<div class="codehilite"><pre><span class="kn">import</span> <span class="nn">org.apache.deltaspike.cdise.api.CdiContainer</span><span class="o">;</span>
-<span class="kn">import</span> <span class="nn">org.apache.deltaspike.cdise.api.CdiContainerLoader</span><span class="o">;</span>
-
-<span class="kd">public</span> <span class="kd">class</span> <span class="nc">MainApp</span> <span class="o">{</span>
-    <span class="kd">public</span> <span class="kd">static</span> <span class="kt">void</span> <span class="nf">main</span><span class="o">(</span><span class="n">String</span><span class="o">[]</span> <span class="n">args</span><span class="o">)</span> <span class="o">{</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="na">getCdiContainer</span><span class="o">();</span>
-        <span class="n">cdiContainer</span><span class="o">.</span><span class="na">boot</span><span class="o">();</span>
-
-        <span class="c1">// You can use CDI here</span>
-
-        <span class="n">cdiContainer</span><span class="o">.</span><span class="na">shutdown</span><span class="o">();</span>
-    <span class="o">}</span>
-<span class="o">}</span>
-</pre></div>
-
-
-<p>When <code>#boot</code> is called, the <code>CdiContainer</code> will scan CDI enabled archives for beans and CDI extensions.</p>
-<p><strong>Note</strong>: Booting the container does <i>not</i> automatically start all CDI Contexts!</p>
-<p>Example for starting the application-context:</p>
-<div class="codehilite"><pre><span class="kn">import</span> <span class="nn">org.apache.deltaspike.cdise.api.CdiContainer</span><span class="o">;</span>
-<span class="kn">import</span> <span class="nn">org.apache.deltaspike.cdise.api.CdiContainerLoader</span><span class="o">;</span>
-<span class="kn">import</span> <span class="nn">org.apache.deltaspike.cdise.api.ContextControl</span><span class="o">;</span>
-<span class="kn">import</span> <span class="nn">javax.enterprise.context.ApplicationScoped</span><span class="o">;</span>
-
-<span class="kd">public</span> <span class="kd">class</span> <span class="nc">MainApp</span> <span class="o">{</span>
-    <span class="kd">public</span> <span class="kd">static</span> <span class="kt">void</span> <span class="nf">main</span><span class="o">(</span><span class="n">String</span><span class="o">[]</span> <span class="n">args</span><span class="o">)</span> <span class="o">{</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="na">getCdiContainer</span><span class="o">();</span>
-        <span class="n">cdiContainer</span><span class="o">.</span><span class="na">boot</span><span class="o">();</span>
-
-        <span class="c1">// Starting the application-context allows to use @ApplicationScoped beans</span>
-        <span class="n">ContextControl</span> <span class="n">contextControl</span> <span class="o">=</span> <span class="n">cdiContainer</span><span class="o">.</span><span class="na">getContextControl</span><span class="o">();</span>
-        <span class="n">contextControl</span><span class="o">.</span><span class="na">startContext</span><span class="o">(</span><span class="n">ApplicationScoped</span><span class="o">.</span><span class="na">class</span><span class="o">);</span>
-
-        <span class="c1">// You can use CDI here</span>
-
-        <span class="n">cdiContainer</span><span class="o">.</span><span class="na">shutdown</span><span class="o">();</span>
-    <span class="o">}</span>
-<span class="o">}</span>
-</pre></div>
-
-
-<p>To resolve a bean of this project, you can use the <code>BeanProvider</code> provided by DeltaSpike.
-The following example shows how to resolve the a bean without qualifiers. It depends on the application if <code>EchoService</code> is a concrete implementation or just an interface. In case of an interface the corresponding implementation will be resolved.
-The resolved bean is a normal CDI bean which means you can use all CDI concepts like <code>@Inject</code> in the class (and you don't need further usages of <code>BeanProvider</code>).</p>
-<div class="codehilite"><pre><span class="n">EchoService</span> <span class="n">echoService</span> <span class="o">=</span> <span class="n">BeanProvider</span><span class="o">.</span><span class="na">getContextualReference</span><span class="o">(</span><span class="n">EchoService</span><span class="o">.</span><span class="na">class</span><span class="o">,</span> <span class="kc">false</span><span class="o">);</span>
-</pre></div>
-
-
-<p>Before the application exits, you have to call <code>#shutdown</code> to destroy beans,... in a well-ordered fashion.</p>
-<h1 id="module-overview">Module Overview</h1>
-<p>The core features of DeltaSpike project are packaged under the following different modules. Some of them are mandatory while others are optional.</p>
-<h2 id="core-required">Core (required)</h2>
-<p>Definition : Contain the API and util classes of DeltaSpike project</p>
-<p><a class="btn" href="core.html">View details »</a></p>
-<h2 id="security-optional">Security (optional)</h2>
-<p>Definition : Intercept and check security</p>
-<p><a class="btn" href="security.html">View details »</a></p>
-<h2 id="jpa-optional">JPA (optional)</h2>
-<p>Definition :</p>
-<p><a class="btn" href="jpa.html">View details »</a></p>
-<h2 id="jsf-optional">JSF (optional)</h2>
-<p>Definition :</p>
-<p><a class="btn" href="jsf.html">View details »</a></p>
-<h2 id="container-control-optional">Container Control (optional)</h2>
-<p>Definition :</p>
-<p><a class="btn" href="container-control.html">View details »</a></p>
-<h2 id="bean-validation-optional">Bean Validation (optional)</h2>
-<p>Definition : A module for adding CDI support in Bean Validation.</p>
-<p>Features : Allows a developer to create CDI aware <code>ConstraintValidator</code>s that can use business objects (EJBs, ManagedBeans) to support validation needs.</p>
-<p>*
-<a class="btn" href="bean-validation.html">View details »</a></p>
-<h2 id="servlet-optional">Servlet (optional)</h2>
-<p>Definition : The DeltaSpike Servlet module provides integration with the Java Servlet API.</p>
-<p>Features : </p>
-<ul>
-<li>Injection of common servlet objects.</li>
-<li>Propagation of servlet events to the CDI event bus. </li>
-</ul>
-<p><a class="btn" href="servlet.html">View details »</a></p>
-<h2 id="partial-bean-optional">Partial-Bean (optional)</h2>
-<p><a class="btn" href="partial-bean.html">View details »</a></p>
-<h2 id="data-optional">Data (optional)</h2>
-<p>Definition : The DeltaSpike Data module provides enhanced JPA experience with declarative queries, reducing boilerplate to a minimum.</p>
-<p>Features : </p>
-<ul>
-<li>Derive queries by simple method names or by method annotations defining JPQL, named queries or plain SQL</li>
-<li>Result pagination and sorting</li>
-<li>Auditing of entities</li>
-<li>A simplified alternative to the Criteria API</li>
-<li>Mapping of entities from and to DTOs</li>
-</ul>
-<p><a class="btn" href="data.html">View details »</a></p>
-<h2 id="test-control-optional">Test-Control (optional)</h2>
-<p>Definition : This module allows to write CDI based tests easily.</p>
-<p><a class="btn" href="test-control.html">View details »</a></p>
-<h2 id="scheduler-optional">Scheduler (optional)</h2>
-<p>Definition : This module provides a simple integration with Quartz v2 (per default) or any other scheduler which supports cron-expressions for job-classes.</p>
-<p><a class="btn" href="scheduler.html">View details »</a></p>
-<h1 id="deltaspike-spi">DeltaSpike SPI</h1>
-<p>DeltaSpike Service Provider Interface (SPI)</p>
-<p><a class="btn" href="spi.html">View details »</a></p>
-<h1 id="external">External</h1>
-<h2 id="blogs">Blogs</h2>
-<ul>
-<li><a href="http://os890.blogspot.com/search/label/deltaspike">http://os890.blogspot.com/search/label/deltaspike</a></li>
-</ul>
-<h2 id="add-ons">Add-ons</h2>
-<ul>
-<li><a href="https://github.com/os890/ds-monitoring-addon">Monitoring- and Auditing</a></li>
-<li><a href="https://github.com/os890/ds-spring-bridge-addon">CDI/Spring Bridge</a></li>
-<li><a href="https://github.com/os890/ds-disruptor-addon">Fast events via Disruptor</a></li>
-</ul>
-<h2 id="project-templates">Project Templates</h2>
-<ul>
-<li><a href="https://github.com/os890/javase-cdi-ds-project-template">Java SE + CDI + DS</a></li>
-<li><a href="https://github.com/os890/javaweb-cdi-ds-project-template">JSF + CDI + DS (Servlet-Container)</a></li>
-<li><a href="https://github.com/os890/javaee_cdi_ejb_ds_project_template">EJB + CDI + DS (Module)</a></li>
-<li><a href="https://github.com/os890/javaee_jsf_cdi_ejb_ds_project_template">JSF + EJB + CDI + DS (EE-Server)</a></li>
-</ul>
-<h2 id="examples">Examples</h2>
-<p>See <a href="examples.html#External">External Examples</a></p>
+<p>After log in to <a href="https://cms.apache.org/deltaspike/publish">https://cms.apache.org/deltaspike/publish</a> and click on the <code>Submit</code> button.</p>
           </div>
       </div>
 



Mime
View raw message