Author: rafabene
Date: Wed Dec 3 14:26:05 2014
New Revision: 1643124
URL: http://svn.apache.org/r1643124
Log:
Site checkin for project Apache DeltaSpike - Documentation
Added:
deltaspike/site/trunk/content/staging/documentation/modules.html
deltaspike/site/trunk/content/staging/documentation/steps_for_a_release.html
Modified:
deltaspike/site/trunk/content/staging/documentation/addons.html
deltaspike/site/trunk/content/staging/documentation/build.html
deltaspike/site/trunk/content/staging/documentation/cdiimp.html
deltaspike/site/trunk/content/staging/documentation/configure.html
deltaspike/site/trunk/content/staging/documentation/examples.html
deltaspike/site/trunk/content/staging/documentation/external.html
deltaspike/site/trunk/content/staging/documentation/index.html
deltaspike/site/trunk/content/staging/documentation/overview.html
deltaspike/site/trunk/content/staging/documentation/snapshots.html
deltaspike/site/trunk/content/staging/documentation/source.html
deltaspike/site/trunk/content/staging/documentation/spi.html
Modified: deltaspike/site/trunk/content/staging/documentation/addons.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/staging/documentation/addons.html?rev=1643124&r1=1643123&r2=1643124&view=diff
==============================================================================
--- deltaspike/site/trunk/content/staging/documentation/addons.html (original)
+++ deltaspike/site/trunk/content/staging/documentation/addons.html Wed Dec 3
14:26:05 2014
@@ -188,23 +188,10 @@ body {
<h2 id="_monitoring">Monitoring</h2>
<div class="sectionbody">
<div class="paragraph">
-<p><strong>Replace this text!</strong> Write 2-3 sentences in plain language
making sure you answer every question:</p>
+<p><code>ds-monitoring-addon</code> provides simple monitoring for several
common use-cases (exceptions, performance, audits), collecting information
about the monitored method-invocations during a request and enabling you to
process the entries based on your requirements. For more information about its
use and implementation, see <a
href="http://os890.blogspot.com.au/2014/04/add-on-monitoring-lite-with-deltaspike.html";>os890:
[add-on] monitoring lite with deltaspike</a>.</p>
</div>
-<div class="ulist">
-<ul>
-<li>
-<p>What is the purpose of the add-on (e.g., A two-way cdi-spring bridge that
allows spring-beans to be injected into cdi-beans and vice versa provided the
concepts, for example qualifiers, are compatible.)?</p>
-</li>
-<li>
-<p>When would the user use this add-on?</p>
-</li>
-<li>
-<p>Where can the user get the add-on from (<a
href="https://github.com/os890/ds-monitoring-addon";
class="bare">https://github.com/os890/ds-monitoring-addon</a> )?</p>
-</li>
-<li>
-<p>Any special instructions for using the add-on correctly?</p>
-</li>
-</ul>
+<div class="paragraph">
+<p><strong>Source code:</strong> <a
href="https://github.com/os890/ds-monitoring-addon";
class="bare">https://github.com/os890/ds-monitoring-addon</a></p>
</div>
</div>
</div>
@@ -212,26 +199,10 @@ body {
<h2 id="_spring_bridge">Spring Bridge</h2>
<div class="sectionbody">
<div class="paragraph">
-<p><code>ds-spring-bridge-addon</code> is a two-way cdi-spring bridge that
allows spring-beans to be injected into cdi-beans and vice versa provided the
concepts, for example qualifiers, are compatible. You can obtain this add-on
from <a href="https://github.com/os890/ds-spring-bridge-addon";
class="bare">https://github.com/os890/ds-spring-bridge-addon</a>.</p>
+<p><code>ds-spring-bridge-addon</code> is a two-way cdi-spring bridge that
allows spring-beans to be injected into cdi-beans and vice versa provided the
concepts, for example qualifiers, are compatible. For more information about
its use and implementation, see <a
href="http://os890.blogspot.com.au/2013/12/add-on-spring-bridge-with-deltaspike.html";>os890:
[add-on] spring-bridge with deltaspike</a>.</p>
</div>
<div class="paragraph">
-<p><strong>Replace this text!</strong> Write 2-3 sentences in plain language
making sure you answer every question:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>What is the purpose of the add-on (e.g., A two-way cdi-spring bridge that
allows spring-beans to be injected into cdi-beans and vice versa provided the
concepts, for example qualifiers, are compatible.)?</p>
-</li>
-<li>
-<p>When would the user use this add-on?</p>
-</li>
-<li>
-<p>Where can the user get the add-on from (<a
href="https://github.com/os890/ds-spring-bridge-addon";
class="bare">https://github.com/os890/ds-spring-bridge-addon</a> )?</p>
-</li>
-<li>
-<p>Any special instructions for using the add-on correctly?</p>
-</li>
-</ul>
+<p><strong>Source code:</strong> <a
href="https://github.com/os890/ds-spring-bridge-addon";
class="bare">https://github.com/os890/ds-spring-bridge-addon</a>.</p>
</div>
</div>
</div>
@@ -239,26 +210,10 @@ body {
<h2 id="_disruptor">Disruptor</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>This add-on creates a disruptor process for every observer method. It
currently works with Apache TomEE and JBoss AS 7.</p>
+<p><code>ds-disruptor-addon</code> improves CDI synchronous event-processing
performance by creating a disruptor process for every observer method, enabling
CDI synchronous events in conjunction with asynchronous observers. This add-on
currently works with Apache TomEE and JBoss AS 7. For more information about
its use and implementation, see <a
href="http://os890.blogspot.com.au/2014/05/faster-cdi-like-events.html";>os890:
[add-on] fast event processing with disruptor + deltaspike</a>.</p>
</div>
<div class="paragraph">
-<p><strong>Replace this text!</strong> Write 2-3 sentences in plain language
making sure you answer every question:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>What is the purpose of the add-on (e.g., A two-way cdi-spring bridge that
allows spring-beans to be injected into cdi-beans and vice versa provided the
concepts, for example qualifiers, are compatible.)?</p>
-</li>
-<li>
-<p>When would the user use this add-on?</p>
-</li>
-<li>
-<p>Where can the user get the add-on from (<a
href="https://github.com/os890/ds-disruptor-addon";
class="bare">https://github.com/os890/ds-disruptor-addon</a> )?</p>
-</li>
-<li>
-<p>Any special instructions for using the add-on correctly?</p>
-</li>
-</ul>
+<p><strong>Source code:</strong> <a
href="https://github.com/os890/ds-disruptor-addon";
class="bare">https://github.com/os890/ds-disruptor-addon</a></p>
</div>
</div>
</div>
Modified: deltaspike/site/trunk/content/staging/documentation/build.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/staging/documentation/build.html?rev=1643124&r1=1643123&r2=1643124&view=diff
==============================================================================
--- deltaspike/site/trunk/content/staging/documentation/build.html (original)
+++ deltaspike/site/trunk/content/staging/documentation/build.html Wed Dec 3
14:26:05 2014
@@ -173,7 +173,7 @@ body {
<ul class="sectlevel1">
<li><a href="#_build_without_cdi_implementation_tests">Build without CDI
Implementation Tests</a></li>
<li><a href="#_build_and_test_with_a_cdi_implementation">Build and Test with a
CDI Implementation</a></li>
-<li><a href="#_build_and_test_with_cdi_containers">Build and Test with CDI
Containers</a></li>
+<li><a href="#_build_and_test_with_a_cdi_container">Build and Test with a CDI
Container</a></li>
<li><a href="#_next">Next</a></li>
</ul>
<hr>
@@ -181,13 +181,13 @@ body {
<div id="preamble">
<div class="sectionbody">
<div class="paragraph">
-<p>The DeltaSpike source (modules and examples) is provided for inspection,
contribution and testing purposes. The source must be built with Maven, which
has been used to automate the compilation, testing and packaging processes.
Arquillian tests are automatically conducted when DeltaSpike is built and CDI
implementations or containers with which to carry out the tests can be
specified.</p>
+<p>The DeltaSpike source (modules and examples) is provided for inspection,
contribution and testing purposes. The source must be built with Maven, which
has been used to automate the compilation, testing and packaging processes.
Arquillian tests are included with the source and a CDI implementation or
container can be specified with which to carry out the tests.</p>
</div>
<div class="paragraph">
-<p>In all cases, to obtain the DeltaSpike source, <a
href="https://deltaspike.apache.org/download.html";>download
<code>deltaspike-project-<version>-source-release.zip</code></a> and
extract the contents.</p>
+<p>In all cases, to obtain the DeltaSpike source, <a
href="https://deltaspike.apache.org/download.html";>download</a>
<code>deltaspike-project-<version>-source-release.zip</code> and extract
the contents.</p>
</div>
<div class="paragraph">
-<p><strong>Note:</strong> You can also obtain the DeltaSpike source from the
project Git repository. The repository is subject to change and it can be used
for contributing but should not be used in production environments. For more
information, see <a href="source.html">Get Source and compile it</a>.</p>
+<p><strong>Note:</strong> You can also obtain the DeltaSpike source from the
project Git repository. The repository is subject to change and it can be used
for contributing but should not be used in production environments. For more
information, see <a href="source.html">Contribute to the DeltaSpike
Source</a>.</p>
</div>
</div>
</div>
@@ -245,7 +245,7 @@ $ mvn clean install</code></pre>
</div>
</div>
<div class="sect1">
-<h2 id="_build_and_test_with_cdi_containers">Build and Test with CDI
Containers</h2>
+<h2 id="_build_and_test_with_a_cdi_container">Build and Test with a CDI
Container</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Tests can be executed with JBoss Weld and Apache OpenWebBeans through Java
EE 6+ application servers and containers. Configurations are currently provided
as details in the table here.</p>
Modified: deltaspike/site/trunk/content/staging/documentation/cdiimp.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/staging/documentation/cdiimp.html?rev=1643124&r1=1643123&r2=1643124&view=diff
==============================================================================
--- deltaspike/site/trunk/content/staging/documentation/cdiimp.html (original)
+++ deltaspike/site/trunk/content/staging/documentation/cdiimp.html Wed Dec 3
14:26:05 2014
@@ -175,14 +175,13 @@ body {
<li><a href="#_java_ee5_and_servlet_containers">Java EE5 and Servlet
Containers</a></li>
<li><a href="#_java_se6">Java SE6+</a>
<ul class="sectlevel2">
-<li><a href="#_declare_dependencies_for_maven_based_projects">Declare
Dependencies for Maven-based Projects</a>
+<li><a href="#_1_declare_cdi_dependencies">1. Declare CDI Dependencies</a>
<ul class="sectlevel3">
-<li><a href="#_option_a_for_jboss_weld">Option A: For JBoss Weld</a></li>
-<li><a href="#_option_b_for_apache_openwebbeans">Option B: For Apache
OpenWebBeans</a></li>
+<li><a href="#_option_a_declare_dependencies_for_maven_based_projects">Option
A: Declare Dependencies for Maven-based Projects</a></li>
+<li><a
href="#_option_b_declare_dependencies_for_maven_independent_projects">Option B:
Declare Dependencies for Maven-independent Projects</a></li>
</ul>
</li>
-<li><a href="#_declare_dependencies_for_maven_independent_projects">Declare
Dependencies for Maven-independent Projects</a></li>
-<li><a href="#_start_the_cdi_container_from_your_project">Start the CDI
Container from Your Project</a></li>
+<li><a href="#_2_start_the_cdi_container_from_your_project">2. Start the CDI
Container from Your Project</a></li>
</ul>
</li>
<li><a href="#_next">Next</a></li>
@@ -192,7 +191,7 @@ body {
<div id="preamble">
<div class="sectionbody">
<div class="paragraph">
-<p>DeltaSpike requires a CDI implementation to be available in the Java
environment that your projects are deployed to. The implementation provides the
CDI essentials, managing dependency injection and contextual lifecycles. <a
href="http://weld.cdi-spec.org/";>JBoss Weld</a> and <a
href="http://openwebbeans.apache.org/";>Apache OpenWebBeans (OWB)</a> are two
widely used CDI implementations. Dependent on the Java environment you choose,
some setup may be necessary as detailed here.</p>
+<p>DeltaSpike requires a CDI implementation to be available in the Java
environment where your projects are deployed. The implementation provides the
CDI essentials, managing dependency injection and contextual lifecycles. <a
href="http://weld.cdi-spec.org/";>JBoss Weld</a> and <a
href="http://openwebbeans.apache.org/";>Apache OpenWebBeans (OWB)</a> are two
widely used CDI implementations. Dependent on the Java environment you choose,
some setup may be necessary as detailed here.</p>
</div>
</div>
</div>
@@ -231,7 +230,9 @@ body {
<p>Instructions are provided here for adding the required resources to both
Maven-based and Maven-independent projects and subsequently booting the CDI
container from your project source code.</p>
</div>
<div class="sect2">
-<h3 id="_declare_dependencies_for_maven_based_projects">Declare Dependencies
for Maven-based Projects</h3>
+<h3 id="_1_declare_cdi_dependencies">1. Declare CDI Dependencies</h3>
+<div class="sect3">
+<h4 id="_option_a_declare_dependencies_for_maven_based_projects">Option A:
Declare Dependencies for Maven-based Projects</h4>
<div class="paragraph">
<p>For Maven-based projects, the Container Control module is available in
Maven Central together with the other DeltaSpike modules. You must configure
your project to use the DeltaSpike Container Control API and one of the CDI
container-specific modules.</p>
</div>
@@ -255,16 +256,9 @@ body {
</li>
<li>
<p>Add CDI container dependencies for one of the container options listed
here</p>
-</li>
-</ol>
-</div>
-<div class="sect3">
-<h4 id="_option_a_for_jboss_weld">Option A: For JBoss Weld</h4>
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>Open the project <code>pom.xml</code> file for editing</p>
-</li>
+<div class="olist loweralpha">
+<div class="title">For JBoss Weld</div>
+<ol class="loweralpha" type="a">
<li>
<p>Add the JBoss Weld version to the list of properties, replacing the version
as desired</p>
<div class="listingblock">
@@ -301,27 +295,11 @@ body {
</div>
</div>
</li>
-<li>
-<p>Save the <code>pom.xml</code> file changes</p>
-</li>
-<li>
-<p>Download all required dependencies</p>
-<div class="listingblock">
-<div class="content">
-<pre>mvn clean install</pre>
-</div>
-</div>
-</li>
</ol>
</div>
-</div>
-<div class="sect3">
-<h4 id="_option_b_for_apache_openwebbeans">Option B: For Apache
OpenWebBeans</h4>
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>Open the project <code>pom.xml</code> file for editing</p>
-</li>
+<div class="olist loweralpha">
+<div class="title">For Apache OpenWebBeans</div>
+<ol class="loweralpha" type="a">
<li>
<p>Add the Apache OpenWebBeans version to the list of properties, replacing
the version as desired</p>
<div class="listingblock">
@@ -365,6 +343,9 @@ body {
</div>
</div>
</li>
+</ol>
+</div>
+</li>
<li>
<p>Save the <code>pom.xml</code> file changes</p>
</li>
@@ -379,18 +360,18 @@ body {
</ol>
</div>
</div>
-</div>
-<div class="sect2">
-<h3 id="_declare_dependencies_for_maven_independent_projects">Declare
Dependencies for Maven-independent Projects</h3>
+<div class="sect3">
+<h4 id="_option_b_declare_dependencies_for_maven_independent_projects">Option
B: Declare Dependencies for Maven-independent Projects</h4>
<div class="paragraph">
<p>For Maven-independent projects, the Container Control module is distributed
together with the other DeltaSpike modules in
<code>distribution-fill-<version>.zip</code>. You must add two of the
files from the <code>cdictrl</code> directory to your project, namely
<code>deltaspike-cdictrl-api.jar</code> and the .jar file that corresponds to
the CDI container you have chosen. Add these files to the project
<code>WEB-INF/lib</code> or <code>EAR/lib</code> directory for .war and .ear
projects respectively.</p>
</div>
</div>
+</div>
<div class="sect2">
-<h3 id="_start_the_cdi_container_from_your_project">Start the CDI Container
from Your Project</h3>
+<h3 id="_2_start_the_cdi_container_from_your_project">2. Start the CDI
Container from Your Project</h3>
<div class="paragraph">
<p>To start a CDI container in your application, you must instantiate a
<code>CdiContainer</code> object and call the <code>#boot</code> method. When
<code>#boot</code> is called, the <code>CdiContainer</code> scans CDI-enabled
-archives for beans and CDI extensions. An example is given in the code snippet
here. Before the application exits, <code>#shutdown</code> must be called to
correctly destroy all beans.</p>
+archives for beans and CDI extensions. Before the application exits,
<code>#shutdown</code> must be called to correctly destroy all beans. An
example is given in the code snippet here.</p>
</div>
<div class="listingblock">
<div class="content">
@@ -426,7 +407,7 @@ archives for beans and CDI extensions. A
CdiContainer cdiContainer = CdiContainerLoader.getCdiContainer();
cdiContainer.boot();
- <span class="comment">// Starting the application-context allows to
use @ApplicationScoped beans</span>
+ <span class="comment">// Starting the application-context enables use
of @ApplicationScoped beans</span>
ContextControl contextControl = cdiContainer.getContextControl();
contextControl.startContext(ApplicationScoped.class);
@@ -438,7 +419,7 @@ archives for beans and CDI extensions. A
</div>
</div>
<div class="paragraph">
-<p>To resolve project beans, you can use the DeltaSpike
<code>BeanProvider</code> class. Whether <code>EchoService</code> is a concrete
implementation or just an interface depends on the application. In the case
that it is an interface, the corresponding implementation is resolved. The
resolved bean is a standard CDI bean and it can be used for all CDI concepts,
such as @Inject, in the class without further uses of
<code>BeanProvider</code>. An example of resolving the bean without qualifiers
is given in the code snippet here.</p>
+<p>To resolve project beans, you can use the DeltaSpike
<code>BeanProvider</code> class. Whether <code>EchoService</code> is a concrete
implementation or just an interface depends on the application. In the case
that it is an interface, the corresponding implementation is resolved. The
resolved bean is a standard CDI bean and it can be used for all CDI concepts,
such as <code>@Inject</code>, in the class without further uses of
<code>BeanProvider</code>. An example of resolving the bean without qualifiers
is given in the code snippet here.</p>
</div>
<div class="listingblock">
<div class="content">
@@ -456,6 +437,12 @@ archives for beans and CDI extensions. A
<li>
<p>For more information about the Container Control module, see <a
href="container-control.html">Container Control Module</a>.</p>
</li>
+<li>
+<p>To understand how the various DeltaSpike modules can enhance and extend
your applications, see <a href="modules.html">Overview of DeltaSpike
Modules</a> and the individual module pages.</p>
+</li>
+<li>
+<p>To see ready-to-deploy example DeltaSpike applications, see <a
href="examples.html">See DeltaSpike in Action</a>.</p>
+</li>
</ul>
</div>
</div>
Modified: deltaspike/site/trunk/content/staging/documentation/configure.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/staging/documentation/configure.html?rev=1643124&r1=1643123&r2=1643124&view=diff
==============================================================================
--- deltaspike/site/trunk/content/staging/documentation/configure.html
(original)
+++ deltaspike/site/trunk/content/staging/documentation/configure.html Wed Dec
3 14:26:05 2014
@@ -171,8 +171,8 @@ body {
<div id="toc" class="toc">
<ul class="sectlevel1">
-<li><a href="#_configure_deltaspike_in_maven_based_projects">Configure
DeltaSpike in Maven-based Projects</a></li>
-<li><a href="#_configure_deltaspike_in_maven_independent_projects">Configure
DeltaSpike in Maven-independent Projects</a></li>
+<li><a href="#_option_a_configure_deltaspike_in_maven_based_projects">Option
A: Configure DeltaSpike in Maven-based Projects</a></li>
+<li><a
href="#_option_b_configure_deltaspike_in_maven_independent_projects">Option B:
Configure DeltaSpike in Maven-independent Projects</a></li>
<li><a href="#_next">Next</a></li>
</ul>
<hr>
@@ -183,12 +183,12 @@ body {
<p>DeltaSpike is available for use in Maven-based and Maven-independent
projects. Instructions are given here for obtaining released final versions of
DeltaSpike for both approaches.</p>
</div>
<div class="paragraph">
-<p><strong>Note:</strong> You can also opt to use the lastest DeltaSpike
snapshots; for more information, see <a href="snapshots.html">Test
Snapshots</a>.</p>
+<p><strong>Note:</strong> You can also opt to use the lastest DeltaSpike
snapshots; for more information, see <a href="snapshots.html">Use DeltaSpike
Snapshots</a>.</p>
</div>
</div>
</div>
<div class="sect1">
-<h2 id="_configure_deltaspike_in_maven_based_projects">Configure DeltaSpike in
Maven-based Projects</h2>
+<h2 id="_option_a_configure_deltaspike_in_maven_based_projects">Option A:
Configure DeltaSpike in Maven-based Projects</h2>
<div class="sectionbody">
<div class="paragraph">
<p>DeltaSpike released versions are available from the Maven Central
repository for use in Maven-based projects. This means that you do not need to
modify your Maven configuration <code>settings.xml</code> file; when building
projects, Maven automatically searches the online Maven Central repository for
project dependencies and downloads sources to your local Maven repository.</p>
@@ -276,7 +276,7 @@ body {
</div>
</div>
<div class="sect1">
-<h2 id="_configure_deltaspike_in_maven_independent_projects">Configure
DeltaSpike in Maven-independent Projects</h2>
+<h2 id="_option_b_configure_deltaspike_in_maven_independent_projects">Option
B: Configure DeltaSpike in Maven-independent Projects</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Deltaspike is provided as a set of downloadable .jar files for projects not
utilizing the Maven build system. Alternatively, you can build the DeltaSpike
.jar files from source; for instructions, see <a href="build.html">Build
DeltaSpike from Source</a>. In both cases, you must add the DeltaSpike .jar
files directly to your projects.</p>
@@ -302,10 +302,10 @@ body {
<div class="olist loweralpha">
<ol class="loweralpha" type="a">
<li>
-<p>For .war projects, copy the .jar files to <code>WEB-INF/lib</code>
directory</p>
+<p>For .war projects, copy the .jar files to the <code>WEB-INF/lib</code>
directory</p>
</li>
<li>
-<p>For .ear projects, copy the .jar files to <code>EAR/lib directory</code>
and add the following to <code>META-INF/application.xml</code>:</p>
+<p>For .ear projects, copy the .jar files to the <code>EAR/lib
directory</code> and add the following to
<code>META-INF/application.xml</code>:</p>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="xml"><span
class="tag"><library-directory></span>lib<span
class="tag"></library-directory></span></code></pre>
@@ -325,13 +325,13 @@ body {
<div class="ulist">
<ul>
<li>
-<p>To check whether your Java envrionment needs any additional CDI-specific
configuration, see <a href="cdiimp.html">Enable CDI For Your Java
Environment</a>.</p>
+<p>To check whether your Java environment needs any additional CDI-specific
configuration, see <a href="cdiimp.html">Enable CDI For Your Java
Environment</a>.</p>
</li>
<li>
<p>To see ready-to-deploy example DeltaSpike applications, see <a
href="examples.html">See DeltaSpike in Action</a>.</p>
</li>
<li>
-<p>To understand how the various DeltaSpike modules can enhance and extend
your applications, see the individual module pages.</p>
+<p>To understand how the various DeltaSpike modules can enhance and extend
your applications, see <a href="modules.html">Overview of DeltaSpike
Modules</a> and the individual module pages.</p>
</li>
</ul>
</div>
Modified: deltaspike/site/trunk/content/staging/documentation/examples.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/staging/documentation/examples.html?rev=1643124&r1=1643123&r2=1643124&view=diff
==============================================================================
--- deltaspike/site/trunk/content/staging/documentation/examples.html (original)
+++ deltaspike/site/trunk/content/staging/documentation/examples.html Wed Dec
3 14:26:05 2014
@@ -171,17 +171,14 @@ body {
<div id="toc" class="toc">
<ul class="sectlevel1">
-<li><a href="#_jse_examples">jse-examples</a></li>
-<li><a href="#_jsf_examples">jsf-examples</a></li>
-<li><a href="#_jsf_playground">jsf-playground</a></li>
-<li><a href="#_scheduler_playground">scheduler-playground</a></li>
+<li><a href="#_next">Next</a></li>
</ul>
<hr>
<div id="preamble">
<div class="sectionbody">
<div class="paragraph">
-<p>A collection of ready-to-build Maven-based projects are provided to
demonstrate the inclusion of DeltaSpike in applications. Each example showcases
a different DeltaSpike feature and explores the mechanics of DeltaSpike
implementation. You can use these examples to see DeltaSpike in action and
learn how to add these capabilities to your own projects. The Maven-based
project examples are available in
<code>deltaspike-project-<version>-source-release.zip</code> and each is
briefly outlined here.</p>
+<p>A collection of ready-to-build Maven-based projects are provided to
demonstrate the inclusion of DeltaSpike in applications. Each example showcases
a different DeltaSpike feature and explores the mechanics of DeltaSpike
implementation. You can use these examples to see DeltaSpike in action and
learn how to add these capabilities to your own projects. The Maven-based
project examples are available in
<code>deltaspike-project-<version>-source-release.zip</code>.</p>
</div>
<div class="paragraph">
<p>To begin using the projects, complete the following steps:</p>
@@ -213,84 +210,15 @@ $ mvn clean package</code></pre>
</div>
</div>
<div class="sect1">
-<h2 id="_jse_examples">jse-examples</h2>
+<h2 id="_next">Next</h2>
<div class="sectionbody">
-<div class="paragraph">
-<p><strong>Replace this text!</strong> Write 2-3 sentences in plain language
making sure you answer every question:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>What is the purpose of the example (e.g., This quickstart demonstrates the
use of a partial bean to provide dynamic implementations of an interface, and
how this might be used to provide a generic query service.)?</p>
-</li>
-<li>
-<p>When would the user use this example (e.g., The PersonQueryService provides
an example of the end user API that might be available from such a framework.
Extensive code comments document the example implementation.)?</p>
-</li>
-<li>
-<p>Any special instructions for how to build and deploy (e.g., It does not
contain any user interface; the tests must be run to verify everything is
working correctly.)?</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_jsf_examples">jsf-examples</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p><strong>Replace this text!</strong> Write 2-3 sentences in plain language
making sure you answer every question:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>What is the purpose of the example (e.g., This quickstart demonstrates the
use of a partial bean to provide dynamic implementations of an interface, and
how this might be used to provide a generic query service.)?</p>
-</li>
-<li>
-<p>When would the user use this example (e.g., The PersonQueryService provides
an example of the end user API that might be available from such a framework.
Extensive code comments document the example implementation.)?</p>
-</li>
-<li>
-<p>Any special instructions for how to build and deploy (e.g., It does not
contain any user interface; the tests must be run to verify everything is
working correctly.)?</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_jsf_playground">jsf-playground</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p><strong>Replace this text!</strong> Write 2-3 sentences in plain language
making sure you answer every question:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>What is the purpose of the example (e.g., This quickstart demonstrates the
use of a partial bean to provide dynamic implementations of an interface, and
how this might be used to provide a generic query service.)?</p>
-</li>
-<li>
-<p>When would the user use this example (e.g., The PersonQueryService provides
an example of the end user API that might be available from such a framework.
Extensive code comments document the example implementation.)?</p>
-</li>
-<li>
-<p>Any special instructions for how to build and deploy (e.g., It does not
contain any user interface; the tests must be run to verify everything is
working correctly.)?</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_scheduler_playground">scheduler-playground</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p><strong>Replace this text!</strong> Write 2-3 sentences in plain language
making sure you answer every question:</p>
-</div>
<div class="ulist">
<ul>
<li>
-<p>What is the purpose of the example (e.g., This quickstart demonstrates the
use of a partial bean to provide dynamic implementations of an interface, and
how this might be used to provide a generic query service.)?</p>
-</li>
-<li>
-<p>When would the user use this example (e.g., The PersonQueryService provides
an example of the end user API that might be available from such a framework.
Extensive code comments document the example implementation.)?</p>
+<p>To see more ready-to-deploy DeltaSpike examples and templates, see <a
href="external.html">External Examples</a>.</p>
</li>
<li>
-<p>Any special instructions for how to build and deploy (e.g., It does not
contain any user interface; the tests must be run to verify everything is
working correctly.)?</p>
+<p>To read how DeltaSpike is being used by developers, see <a
href="articles.html">Articles and Blogs</a>.</p>
</li>
</ul>
</div>
Modified: deltaspike/site/trunk/content/staging/documentation/external.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/staging/documentation/external.html?rev=1643124&r1=1643123&r2=1643124&view=diff
==============================================================================
--- deltaspike/site/trunk/content/staging/documentation/external.html (original)
+++ deltaspike/site/trunk/content/staging/documentation/external.html Wed Dec
3 14:26:05 2014
@@ -171,27 +171,37 @@ body {
<div id="toc" class="toc">
<ul class="sectlevel1">
-<li><a href="#_example_confess_2012_workshop_demo">Example: Confess 2012
Workshop Demo</a></li>
-<li><a href="#_example_fullstack_ee6_with_deltaspike">Example: Fullstack EE6+
with DeltaSpike</a></li>
-<li><a href="#_example_fullstack_codi_to_deltaspike">Example: Fullstack CODI
to DeltaSpike</a></li>
-<li><a href="#_examples_jboss_web_framework_kit_quickstarts">Examples: JBoss
Web Framework Kit Quickstarts</a></li>
-<li><a href="#_template_java_se_cdi_ds">Template: Java SE + CDI + DS</a></li>
-<li><a href="#_template_jsf_cdi_ds_servlet_container">Template: JSF + CDI + DS
(Servlet-Container)</a></li>
-<li><a href="#_template_ejb_cdi_ds_module">Template: EJB + CDI + DS
(Module)</a></li>
-<li><a href="#_template_jsf_ejb_cdi_ds_ee_server">Template: JSF + EJB + CDI +
DS (EE-Server)</a></li>
+<li><a href="#_examples">Examples</a>
+<ul class="sectlevel2">
+<li><a href="#_confess_2012_workshop_demo">Confess 2012 Workshop Demo</a></li>
+<li><a href="#_fullstack_ee6_with_deltaspike">Fullstack EE6+ with
DeltaSpike</a></li>
+<li><a href="#_fullstack_codi_to_deltaspike">Fullstack CODI to
DeltaSpike</a></li>
+<li><a href="#_jboss_quickstarts">JBoss Quickstarts</a></li>
+</ul>
+</li>
+<li><a href="#_templates">Templates</a>
+<ul class="sectlevel2">
+<li><a href="#_java_se_cdi_ds">Java SE + CDI + DS</a></li>
+<li><a href="#_jsf_cdi_ds_servlet_container">JSF + CDI + DS
(Servlet-Container)</a></li>
+<li><a href="#_ejb_cdi_ds_module">EJB + CDI + DS (Module)</a></li>
+<li><a href="#_jsf_ejb_cdi_ds_ee_server">JSF + EJB + CDI + DS
(EE-Server)</a></li>
+</ul>
+</li>
</ul>
<hr>
<div id="preamble">
<div class="sectionbody">
<div class="paragraph">
-<p>A number of DeltaSpike examples and templates have been developed external
to the DeltaSpike project. These extend the DeltaSpike resources from which you
can see DeltaSpike in action. Brief information is given here about each of the
examples and templates, with details of where they can be obtained from.</p>
+<p>A number of DeltaSpike examples and templates have been developed external
to the DeltaSpike project. These extend the DeltaSpike resources from which you
can see DeltaSpike in action. Brief information is given here about the
examples and templates, with details of where they can be obtained from.</p>
</div>
</div>
</div>
<div class="sect1">
-<h2 id="_example_confess_2012_workshop_demo">Example: Confess 2012 Workshop
Demo</h2>
+<h2 id="_examples">Examples</h2>
<div class="sectionbody">
+<div class="sect2">
+<h3 id="_confess_2012_workshop_demo">Confess 2012 Workshop Demo</h3>
<div class="paragraph">
<p>This example was prepared for the Confess workshop and demonstrates how to
use DeltaSpike instead of and side-by-side with MyFaces CODI. The secured web
application demonstrates presenting users with differentiating content based on
their account status.</p>
</div>
@@ -199,10 +209,8 @@ body {
<p><strong>Source code:</strong> <a
href="https://github.com/confess/confess2012_deltaspike";
class="bare">https://github.com/confess/confess2012_deltaspike</a></p>
</div>
</div>
-</div>
-<div class="sect1">
-<h2 id="_example_fullstack_ee6_with_deltaspike">Example: Fullstack EE6+ with
DeltaSpike</h2>
-<div class="sectionbody">
+<div class="sect2">
+<h3 id="_fullstack_ee6_with_deltaspike">Fullstack EE6+ with DeltaSpike</h3>
<div class="paragraph">
<p>Simple example based on Java EE6+ and DeltaSpike (tested with EE6 and
EE7).</p>
</div>
@@ -210,10 +218,8 @@ body {
<p><strong>Source code:</strong> <a
href="https://github.com/os890/ee6-ds-demo";
class="bare">https://github.com/os890/ee6-ds-demo</a></p>
</div>
</div>
-</div>
-<div class="sect1">
-<h2 id="_example_fullstack_codi_to_deltaspike">Example: Fullstack CODI to
DeltaSpike</h2>
-<div class="sectionbody">
+<div class="sect2">
+<h3 id="_fullstack_codi_to_deltaspike">Fullstack CODI to DeltaSpike</h3>
<div class="paragraph">
<p>This pair of examples show how to achieve the most important MyFaces CODI
features with DeltaSpike and also how to migrate a CODI project to DeltaSpike.
The examples are basic, compacting core CODI features into just a few JSF
pages, and are intended for deployment with TomEE.</p>
</div>
@@ -231,10 +237,8 @@ body {
</ul>
</div>
</div>
-</div>
-<div class="sect1">
-<h2 id="_examples_jboss_web_framework_kit_quickstarts">Examples: JBoss Web
Framework Kit Quickstarts</h2>
-<div class="sectionbody">
+<div class="sect2">
+<h3 id="_jboss_quickstarts">JBoss Quickstarts</h3>
<div class="paragraph">
<p>The JBoss quickstarts are small working examples that demonstrate
recommended practices for specific Java EE technology use cases. A subset of
these quickstarts are dedicated to demonstrating DeltaSpike, including custom
authorization restrictions using annotations, constructing and modifying beans,
extending the influence of CDI using BeanManager, and deactivating DeltaSpike
features.</p>
</div>
@@ -243,99 +247,33 @@ body {
</div>
</div>
</div>
-<div class="sect1">
-<h2 id="_template_java_se_cdi_ds">Template: Java SE + CDI + DS</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p><strong>Replace this text!</strong> Write 2-3 sentences in plain language
making sure you answer every question:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>What is the purpose of the template (e.g., This quickstart demonstrates the
use of a partial bean to provide dynamic implementations of an interface, and
how this might be used to provide a generic query service.)?</p>
-</li>
-<li>
-<p>When would the user use this template (e.g., The PersonQueryService
provides an example of the end user API that might be available from such a
framework. Extensive code comments document the example implementation.)?</p>
-</li>
-<li>
-<p>Where can the user get the template from (<a
href="https://github.com/os890/javase-cdi-ds-project-template";
class="bare">https://github.com/os890/javase-cdi-ds-project-template</a> )?</p>
-</li>
-<li>
-<p>Any special instructions for how to build and deploy (e.g., It does not
contain any user interface; the tests must be run to verify everything is
working correctly.)?</p>
-</li>
-</ul>
-</div>
-</div>
</div>
<div class="sect1">
-<h2 id="_template_jsf_cdi_ds_servlet_container">Template: JSF + CDI + DS
(Servlet-Container)</h2>
+<h2 id="_templates">Templates</h2>
<div class="sectionbody">
+<div class="sect2">
+<h3 id="_java_se_cdi_ds">Java SE + CDI + DS</h3>
<div class="paragraph">
-<p><strong>Replace this text!</strong> Write 2-3 sentences in plain language
making sure you answer every question:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>What is the purpose of the template (e.g., This quickstart demonstrates the
use of a partial bean to provide dynamic implementations of an interface, and
how this might be used to provide a generic query service.)?</p>
-</li>
-<li>
-<p>When would the user use this template (e.g., The PersonQueryService
provides an example of the end user API that might be available from such a
framework. Extensive code comments document the example implementation.)?</p>
-</li>
-<li>
-<p>Where can the user get the template from (<a
href="https://github.com/os890/javaweb-cdi-ds-project-template";
class="bare">https://github.com/os890/javaweb-cdi-ds-project-template</a> )?</p>
-</li>
-<li>
-<p>Any special instructions for how to build and deploy (e.g., It does not
contain any user interface; the tests must be run to verify everything is
working correctly.)?</p>
-</li>
-</ul>
+<p><strong>Source code:</strong> <a
href="https://github.com/os890/javase-cdi-ds-project-template";
class="bare">https://github.com/os890/javase-cdi-ds-project-template</a></p>
</div>
</div>
-</div>
-<div class="sect1">
-<h2 id="_template_ejb_cdi_ds_module">Template: EJB + CDI + DS (Module)</h2>
-<div class="sectionbody">
+<div class="sect2">
+<h3 id="_jsf_cdi_ds_servlet_container">JSF + CDI + DS (Servlet-Container)</h3>
<div class="paragraph">
-<p><strong>Replace this text!</strong> Write 2-3 sentences in plain language
making sure you answer every question:</p>
+<p><strong>Source code:</strong> <a
href="https://github.com/os890/javaweb-cdi-ds-project-template";
class="bare">https://github.com/os890/javaweb-cdi-ds-project-template</a></p>
</div>
-<div class="ulist">
-<ul>
-<li>
-<p>What is the purpose of the template (e.g., This quickstart demonstrates the
use of a partial bean to provide dynamic implementations of an interface, and
how this might be used to provide a generic query service.)?</p>
-</li>
-<li>
-<p>When would the user use this template (e.g., The PersonQueryService
provides an example of the end user API that might be available from such a
framework. Extensive code comments document the example implementation.)?</p>
-</li>
-<li>
-<p>Where can the user get the template from (<a
href="https://github.com/os890/javaee_cdi_ejb_ds_project_template";
class="bare">https://github.com/os890/javaee_cdi_ejb_ds_project_template</a>
)?</p>
-</li>
-<li>
-<p>Any special instructions for how to build and deploy (e.g., It does not
contain any user interface; the tests must be run to verify everything is
working correctly.)?</p>
-</li>
-</ul>
</div>
+<div class="sect2">
+<h3 id="_ejb_cdi_ds_module">EJB + CDI + DS (Module)</h3>
+<div class="paragraph">
+<p><strong>Source code:</strong> <a
href="https://github.com/os890/javaee_cdi_ejb_ds_project_template";
class="bare">https://github.com/os890/javaee_cdi_ejb_ds_project_template</a></p>
</div>
</div>
-<div class="sect1">
-<h2 id="_template_jsf_ejb_cdi_ds_ee_server">Template: JSF + EJB + CDI + DS
(EE-Server)</h2>
-<div class="sectionbody">
+<div class="sect2">
+<h3 id="_jsf_ejb_cdi_ds_ee_server">JSF + EJB + CDI + DS (EE-Server)</h3>
<div class="paragraph">
-<p><strong>Replace this text!</strong> Write 2-3 sentences in plain language
making sure you answer every question:</p>
+<p><strong>Source code:</strong> <a
href="https://github.com/os890/javaee_jsf_cdi_ejb_ds_project_template";
class="bare">https://github.com/os890/javaee_jsf_cdi_ejb_ds_project_template</a></p>
</div>
-<div class="ulist">
-<ul>
-<li>
-<p>What is the purpose of the template (e.g., This quickstart demonstrates the
use of a partial bean to provide dynamic implementations of an interface, and
how this might be used to provide a generic query service.)?</p>
-</li>
-<li>
-<p>When would the user use this template (e.g., The PersonQueryService
provides an example of the end user API that might be available from such a
framework. Extensive code comments document the example implementation.)?</p>
-</li>
-<li>
-<p>Where can the user get the template from (<a
href="https://github.com/os890/javaee_jsf_cdi_ejb_ds_project_template";
class="bare">https://github.com/os890/javaee_jsf_cdi_ejb_ds_project_template</a>
)?</p>
-</li>
-<li>
-<p>Any special instructions for how to build and deploy (e.g., It does not
contain any user interface; the tests must be run to verify everything is
working correctly.)?</p>
-</li>
-</ul>
</div>
</div>
</div>
Modified: deltaspike/site/trunk/content/staging/documentation/index.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/staging/documentation/index.html?rev=1643124&r1=1643123&r2=1643124&view=diff
==============================================================================
--- deltaspike/site/trunk/content/staging/documentation/index.html (original)
+++ deltaspike/site/trunk/content/staging/documentation/index.html Wed Dec 3
14:26:05 2014
@@ -176,7 +176,7 @@ body {
<div class="ulist">
<ul>
<li>
-<p>Getting Started</p>
+<p>Get Started</p>
<div class="ulist">
<ul>
<li>
@@ -195,10 +195,13 @@ body {
</div>
</li>
<li>
-<p>Using Individual Modules</p>
+<p>Use Individual Modules</p>
<div class="ulist">
<ul>
<li>
+<p><a href="modules.html">Overview of DeltaSpike Modules</a></p>
+</li>
+<li>
<p><a href="core.html">Core</a></p>
</li>
<li>
@@ -239,7 +242,7 @@ body {
<div class="ulist">
<ul>
<li>
-<p><a href="build.html">Build DeltaSpike from Source</a></p>
+<p><a href="build.html">Build and Test DeltaSpike from Source</a></p>
</li>
<li>
<p><a href="snapshots.html">Use DeltaSpike Snapshots</a></p>
@@ -248,13 +251,16 @@ body {
<p><a href="https://deltaspike.apache.org/migration-guide.html";>Migrate to
DeltaSpike</a></p>
</li>
<li>
+<p><a href="source.html">Contribute to the DeltaSpike Source</a></p>
+</li>
+<li>
<p><a href="spi.html">DeltaSpike Service Provider Interface (SPI)</a></p>
</li>
</ul>
</div>
</li>
<li>
-<p>More Resources</p>
+<p>Access More DeltaSpike Resources</p>
<div class="ulist">
<ul>
<li>
Added: deltaspike/site/trunk/content/staging/documentation/modules.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/staging/documentation/modules.html?rev=1643124&view=auto
==============================================================================
--- deltaspike/site/trunk/content/staging/documentation/modules.html (added)
+++ deltaspike/site/trunk/content/staging/documentation/modules.html Wed Dec 3
14:26:05 2014
@@ -0,0 +1,271 @@
+<!DOCTYPE html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="deltaspike-generate-pages">
+<meta name="author" content="chm">
+
+<title>Overview of DeltaSpike Modules</title>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with this work
for additional information regarding copyright ownership. The ASF licenses
this file to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance with the
License. You may obtain a copy of the License at .
http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law
or agreed to in writing, software distributed under the License is distributed
on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
either express or implied. See the License for the specific language governing
permissions and limitations under the License. -->
+
+<!-- Styles -->
+
+<link href="https://deltaspike.apache.org/resources/css/bootstrap.css";
rel="stylesheet">
+<link
href="https://deltaspike.apache.org/resources/css/bootstrap-responsive.css";
rel="stylesheet">
+
+<style type="text/css">
+/* Stylesheet for CodeRay to match GitHub theme | MIT License |
http://foundation.zurb.com */
+/*pre.CodeRay {background-color:#f7f7f8;}*/
+.CodeRay .line-numbers{border-right:1px solid #d8d8d8;padding:0 0.5em 0 .25em}
+.CodeRay
span.line-numbers{display:inline-block;margin-right:.5em;color:rgba(0,0,0,.3)}
+.CodeRay .line-numbers strong{font-weight: normal}
+table.CodeRay{border-collapse:separate;border-spacing:0;margin-bottom:0;border:0;background:none}
+table.CodeRay td{vertical-align: top}
+table.CodeRay td.line-numbers{text-align:right}
+table.CodeRay td.line-numbers>pre{padding:0;color:rgba(0,0,0,.3)}
+table.CodeRay td.code{padding:0 0 0 .5em}
+table.CodeRay td.code>pre{padding:0}
+.CodeRay .debug{color:#fff !important;background:#000080 !important}
+.CodeRay .annotation{color:#007}
+.CodeRay .attribute-name{color:#000080}
+.CodeRay .attribute-value{color:#700}
+.CodeRay .binary{color:#509}
+.CodeRay .comment{color:#998;font-style:italic}
+.CodeRay .char{color:#04d}
+.CodeRay .char .content{color:#04d}
+.CodeRay .char .delimiter{color:#039}
+.CodeRay .class{color:#458;font-weight:bold}
+.CodeRay .complex{color:#a08}
+.CodeRay .constant,.CodeRay .predefined-constant{color:#008080}
+.CodeRay .color{color:#099}
+.CodeRay .class-variable{color:#369}
+.CodeRay .decorator{color:#b0b}
+.CodeRay .definition{color:#099}
+.CodeRay .delimiter{color:#000}
+.CodeRay .doc{color:#970}
+.CodeRay .doctype{color:#34b}
+.CodeRay .doc-string{color:#d42}
+.CodeRay .escape{color:#666}
+.CodeRay .entity{color:#800}
+.CodeRay .error{color:#808}
+.CodeRay .exception{color:inherit}
+.CodeRay .filename{color:#099}
+.CodeRay .function{color:#900;font-weight:bold}
+.CodeRay .global-variable{color:#008080}
+.CodeRay .hex{color:#058}
+.CodeRay .integer,.CodeRay .float{color:#099}
+.CodeRay .include{color:#555}
+.CodeRay .inline{color:#00}
+.CodeRay .inline .inline{background:#ccc}
+.CodeRay .inline .inline .inline{background:#bbb}
+.CodeRay .inline .inline-delimiter{color:#d14}
+.CodeRay .inline-delimiter{color:#d14}
+.CodeRay .important{color:#555;font-weight:bold}
+.CodeRay .interpreted{color:#b2b}
+.CodeRay .instance-variable{color:#008080}
+.CodeRay .label{color:#970}
+.CodeRay .local-variable{color:#963}
+.CodeRay .octal{color:#40e}
+.CodeRay .predefined{color:#369}
+.CodeRay .preprocessor{color:#579}
+.CodeRay .pseudo-class{color:#555}
+.CodeRay .directive{font-weight:bold}
+.CodeRay .type{font-weight:bold}
+.CodeRay .predefined-type{color:inherit}
+.CodeRay .reserved,.CodeRay .keyword {color:#000;font-weight:bold}
+.CodeRay .key{color:#808}
+.CodeRay .key .delimiter{color:#606}
+.CodeRay .key .char{color:#80f}
+.CodeRay .value{color:#088}
+.CodeRay .regexp .delimiter{color:#808}
+.CodeRay .regexp .content{color:#808}
+.CodeRay .regexp .modifier{color:#808}
+.CodeRay .regexp .char{color:#d14}
+.CodeRay .regexp .function{color:#404;font-weight:bold}
+.CodeRay .string{color:#d20}
+.CodeRay .string .string .string{background:#ffd0d0}
+.CodeRay .string .content{color:#d14}
+.CodeRay .string .char{color:#d14}
+.CodeRay .string .delimiter{color:#d14}
+.CodeRay .shell{color:#d14}
+.CodeRay .shell .delimiter{color:#d14}
+.CodeRay .symbol{color:#990073}
+.CodeRay .symbol .content{color:#a60}
+.CodeRay .symbol .delimiter{color:#630}
+.CodeRay .tag{color:#008080}
+.CodeRay .tag-special{color:#d70}
+.CodeRay .variable{color:#036}
+.CodeRay .insert{background:#afa}
+.CodeRay .delete{background:#faa}
+.CodeRay .change{color:#aaf;background:#007}
+.CodeRay .head{color:#f8f;background:#505}
+.CodeRay .insert .insert{color:#080}
+.CodeRay .delete .delete{color:#800}
+.CodeRay .change .change{color:#66f}
+.CodeRay .head .head{color:#f4f}
+body {
+ padding-top: 60px;
+ padding-bottom: 40px;
+}
+</style>
+<script type="text/javascript">
+
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-36103647-1']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type =
'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ?
'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(ga, s);
+ })();
+
+ </script>
+</head>
+
+<body>
+
+ <div class="navbar navbar-fixed-top">
+ <div class="navbar-inner">
+ <div class="container">
+ <a class="btn btn-navbar" data-toggle="collapse"
+ data-target=".nav-collapse"> <span
class="icon-bar"></span> <span
+ class="icon-bar"></span> <span
class="icon-bar"></span>
+ </a> <a class="brand logocolor"
+
href="http://deltaspike.apache.org/index.html";>Apache
+ DeltaSpike</a>
+ <div class="nav-collapse">
+ <ul class="nav">
+ <li class="active"><a
+
href="http://deltaspike.apache.org/index.html";>Home</a></li>
+ <li><a
href="http://deltaspike.apache.org/documentation";>Documentation</a></li>
+ <li><a
href="http://deltaspike.apache.org/javadoc.html";>Javadoc</a></li>
+ <li><a
href="http://deltaspike.apache.org/documentation/source.html";>Source</a></li>
+ <li><a
href="http://deltaspike.apache.org/download.html";>Download</a></li>
+ <li><a
href="http://deltaspike.apache.org/community.html";>Community</a></li>
+ <!-- <li><a
href="./support.html">Support</a></li> -->
+ <li><a
href="http://deltaspike.apache.org/news.html";>News</a></li>
+ <li><a
+
href="http://deltaspike.apache.org/migration-guide.html";>Migration</a></li>
+ </ul>
+ </div>
+ <!--/.nav-collapse -->
+ <form id="search-form"
action="http://www.google.com/search";
+ method="get" class="navbar-search
pull-right">
+ <input value="deltaspike.apache.org"
name="sitesearch"
+ type="hidden"> <input
class="search-query" name="q"
+ id="query" type="text">
+ </form>
+ </div>
+ </div>
+ </div>
+
+ <div class="container">
+ <div class="row">
+ <div class="span12">
+ <div class="page-title">
+ <h1>Overview of DeltaSpike Modules</h1>
+ </div>
+
+ <div id="toc" class="toc">
+
+ <hr>
+
+ <div class="paragraph">
+<p>DeltaSpike consists of ready-to-use modules. These include a core module
and a number of optional modules for providing additional enterprise
functionality to your applications. An overview of each module is provided here
and for more information see the linked individual module pages.</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<caption class="title">Table 1. DeltaSpike Modules</caption>
+<colgroup>
+<col style="width: 25%;">
+<col style="width: 25%;">
+<col style="width: 50%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a
href="core.html">Core</a></p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Required</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>For the essential API and util classes</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a
href="bean-validation.html">Bean Validation</a></p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Optional</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>For adding CDI support in Bean Validation, enabling creation of CDI aware
<code>ConstraintValidator</code> methods that can use business objects (EJBs,
ManagedBeans) to support validation needs</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a
href="container-control.html">Container Control</a></p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Optional</p></td>
+<td class="tableblock halign-left valign-top"><div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a
href="data.html">Data</a></p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Optional</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>For an enhanced JPA experience with declarative queries, reducing
boilerplate to a minimum</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a
href="jpa.html">JPA</a></p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Optional</p></td>
+<td class="tableblock halign-left valign-top"><div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a
href="jsf.html">JSF</a></p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Optional</p></td>
+<td class="tableblock halign-left valign-top"><div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a
href="partial-bean.html">Partial-Bean</a></p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Optional</p></td>
+<td class="tableblock halign-left valign-top"><div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a
href="scheduler.html">Scheduler</a></p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Optional</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>For simple integration with Quartz v2 (per default) or any other scheduler
which supports cron-expressions for job-classes</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a
href="security.html">Security</a></p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Optional</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>For intercept and check security</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a
href="servlet.html">Servlet</a></p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Optional</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>For integration with the Java Servlet API, enabling injection of common
servlet objects and propagation of servlet events to the CDI event bus</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><a
href="test-control.html">Test-Control</a></p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Optional</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>For easily writing CDI based tests</p>
+</div></div></td>
+</tr>
+</tbody>
+</table>
+ </div>
+
+ <hr>
+
+ <footer>
+ <p>Copyright © 2011-2014 The Apache Software
Foundation, Licensed under the Apache License, Version 2.0.</p>
+ <p>Apache and the Apache feather logo are
trademarks of The Apache Software Foundation.</p>
+ </footer>
+
+ </div>
+ <!-- /.container -->
+
+</body>
+</html>
\ No newline at end of file
Modified: deltaspike/site/trunk/content/staging/documentation/overview.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/staging/documentation/overview.html?rev=1643124&r1=1643123&r2=1643124&view=diff
==============================================================================
--- deltaspike/site/trunk/content/staging/documentation/overview.html (original)
+++ deltaspike/site/trunk/content/staging/documentation/overview.html Wed Dec
3 14:26:05 2014
@@ -345,7 +345,7 @@ body {
<h2 id="_next">Next</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>For instructions on how to start using DeltaSpike, see <a
href="configure.html">Configure DeltaSpike in Your Projects</a>.</p>
+<p>For instructions on how to start using DeltaSpike, see <a
href="configure.html">Configure DeltaSpike in Your Projects</a> and <a
href="cdiimp.html">Enable CDI For Your Java Environment</a>.</p>
</div>
</div>
</div>
Modified: deltaspike/site/trunk/content/staging/documentation/snapshots.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/staging/documentation/snapshots.html?rev=1643124&r1=1643123&r2=1643124&view=diff
==============================================================================
--- deltaspike/site/trunk/content/staging/documentation/snapshots.html
(original)
+++ deltaspike/site/trunk/content/staging/documentation/snapshots.html Wed Dec
3 14:26:05 2014
@@ -171,8 +171,8 @@ body {
<div id="toc" class="toc">
<ul class="sectlevel1">
-<li><a
href="#_configure_maven_to_use_the_apache_snapshot_repository">Configure Maven
to Use the Apache Snapshot Repository</a></li>
-<li><a href="#_configure_your_project_with_the_snapshot_version">Configure
Your Project with the Snapshot Version</a></li>
+<li><a href="#_1_configure_maven_to_use_the_apache_snapshot_repository">1.
Configure Maven to Use the Apache Snapshot Repository</a></li>
+<li><a href="#_2_configure_your_project_with_the_snapshot_version">2.
Configure Your Project with the Snapshot Version</a></li>
</ul>
<hr>
@@ -187,7 +187,7 @@ body {
</div>
</div>
<div class="sect1">
-<h2 id="_configure_maven_to_use_the_apache_snapshot_repository">Configure
Maven to Use the Apache Snapshot Repository</h2>
+<h2 id="_1_configure_maven_to_use_the_apache_snapshot_repository">1. Configure
Maven to Use the Apache Snapshot Repository</h2>
<div class="sectionbody">
<div class="paragraph">
<p>You must add the Apache Snapshot Repository to your Maven configuration
<code>settings.xml</code> file. This ensures Maven can find the repository when
it searches for your project DeltaSpike dependencies.</p>
@@ -195,7 +195,7 @@ body {
<div class="olist arabic">
<ol class="arabic">
<li>
-<p>Open Maven configuration <code>settings.xml</code> file for editing</p>
+<p>Open your Maven configuration <code>settings.xml</code> file for editing</p>
</li>
<li>
<p>Add the Apache Snapshot Repository to the list of repositories</p>
@@ -224,7 +224,7 @@ body {
</div>
</div>
<div class="sect1">
-<h2 id="_configure_your_project_with_the_snapshot_version">Configure Your
Project with the Snapshot Version</h2>
+<h2 id="_2_configure_your_project_with_the_snapshot_version">2. Configure Your
Project with the Snapshot Version</h2>
<div class="sectionbody">
<div class="paragraph">
<p>With Maven configured for the Apache Snapshot Repository, you can specify
DeltaSpike snapshot versions in your Maven-based projects.</p>
Modified: deltaspike/site/trunk/content/staging/documentation/source.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/staging/documentation/source.html?rev=1643124&r1=1643123&r2=1643124&view=diff
==============================================================================
--- deltaspike/site/trunk/content/staging/documentation/source.html (original)
+++ deltaspike/site/trunk/content/staging/documentation/source.html Wed Dec 3
14:26:05 2014
@@ -6,7 +6,7 @@
<meta name="description" content="deltaspike-generate-pages">
<meta name="author" content="chm">
-<title>Get Source and compile it</title>
+<title>Contribute to the DeltaSpike Source</title>
<!-- Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with this work
for additional information regarding copyright ownership. The ASF licenses
this file to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance with the
License. You may obtain a copy of the License at .
http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law
or agreed to in writing, software distributed under the License is distributed
on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
either express or implied. See the License for the specific language governing
permissions and limitations under the License. -->
@@ -166,129 +166,132 @@ body {
<div class="row">
<div class="span12">
<div class="page-title">
- <h1>Get Source and compile it</h1>
+ <h1>Contribute to the DeltaSpike Source</h1>
</div>
<div id="toc" class="toc">
<ul class="sectlevel1">
-<li><a href="#_introduction">Introduction</a></li>
-<li><a href="#_scm_repository">SCM / Repository</a>
-<ul class="sectlevel2">
-<li><a href="#_initial_checkout">Initial 'checkout'</a></li>
-<li><a href="#_update_existing_clone">Update existing clone</a></li>
-<li><a href="#_read_only_mirrors">Read-only Mirrors</a>
-<ul class="sectlevel3">
-<li><a href="#_github_mirror">GitHub-Mirror</a></li>
-</ul>
-</li>
-<li><a href="#_git_workflow">GIT Workflow</a></li>
-</ul>
-</li>
-<li><a href="#_build">Build</a></li>
-<li><a href="#_tools_ide">Tools / IDE</a>
+<li><a href="#_1_get_the_source">1. Get the Source</a></li>
+<li><a href="#_2_make_additions_and_changes_to_the_source">2. Make Additions
and Changes to the Source</a>
<ul class="sectlevel2">
<li><a href="#_intellij">IntelliJ</a></li>
<li><a href="#_eclipse">Eclipse</a></li>
</ul>
</li>
+<li><a href="#_3_build_the_source">3. Build the Source</a></li>
+<li><a href="#_4_make_a_pull_request">4. Make a Pull Request</a></li>
+<li><a href="#_git_resources">Git Resources</a></li>
</ul>
<hr>
- <div class="sect1">
-<h2 id="_introduction">Introduction</h2>
+ <div id="preamble">
<div class="sectionbody">
-
+<div class="paragraph">
+<p>If you are looking to contribute to the DeltaSpike source, you must start
with the latest version of the code base. DeltaSpike source is stored in the
Apache Git repository at <a
href="https://git-wip-us.apache.org/repos/asf/deltaspike.git";
class="bare">https://git-wip-us.apache.org/repos/asf/deltaspike.git</a></p>
+</div>
+<div class="paragraph">
+<p>It is also important that you follow the git workflows we have established
for the project to ensure efficient and clean collaboration as detailed
here.</p>
+</div>
</div>
</div>
<div class="sect1">
-<h2 id="_scm_repository">SCM / Repository</h2>
+<h2 id="_1_get_the_source">1. Get the Source</h2>
<div class="sectionbody">
-<div class="paragraph">
-<p>We are using GIT as a Version Control System. The official GIT
-repository of the project is available
-<a href="https://git-wip-us.apache.org/repos/asf/deltaspike.git";>here</a>.</p>
-</div>
-<div class="sect2">
-<h3 id="_initial_checkout">Initial 'checkout'</h3>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Checkout the source</p>
<div class="listingblock">
<div class="content">
-<pre>git clone https://git-wip-us.apache.org/repos/asf/deltaspike.git</pre>
+<pre class="CodeRay highlight"><code>git clone
https://git-wip-us.apache.org/repos/asf/deltaspike.git</code></pre>
</div>
</div>
+<div class="paragraph">
+<p>or for a read-only mirror version</p>
</div>
-<div class="sect2">
-<h3 id="_update_existing_clone">Update existing clone</h3>
<div class="listingblock">
<div class="content">
-<pre>git pull --rebase</pre>
-</div>
+<pre class="CodeRay highlight"><code>git clone
https://github.com/apache/deltaspike</code></pre>
</div>
</div>
-<div class="sect2">
-<h3 id="_read_only_mirrors">Read-only Mirrors</h3>
-<div class="sect3">
-<h4 id="_github_mirror">GitHub-Mirror</h4>
+</li>
+<li>
+<p>Update the repository clone</p>
<div class="listingblock">
<div class="content">
-<pre>git clone https://github.com/apache/deltaspike</pre>
+<pre class="CodeRay highlight"><code>git pull --rebase</code></pre>
</div>
</div>
-<div class="paragraph">
-<p>More information can be found <a
href="https://help.github.com/articles/which-remote-url-should-i-use";>here</a>.</p>
+</li>
+</ol>
</div>
</div>
</div>
-<div class="sect2">
-<h3 id="_git_workflow">GIT Workflow</h3>
+<div class="sect1">
+<h2 id="_2_make_additions_and_changes_to_the_source">2. Make Additions and
Changes to the Source</h2>
+<div class="sectionbody">
<div class="paragraph">
-<p>We follow an <a href="../suggested-git-workflows.html">unified 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";
class="bare">http://git-wip-us.apache.org</a>.</p>
+<p>Commits (and in the best case also patches), have to follow our
+"formatting rules". The following section provides settings for IDEs
+used by us.</p>
</div>
+<div class="sect2">
+<h3 id="_intellij">IntelliJ</h3>
<div class="paragraph">
-<p><strong>Hint:</strong></p>
+<p><a
href="http://deltaspike.apache.org/resources/files/settings.jar";>Attached</a>
you can find the settings
+for formatting the source code. Import them via File | Import
+Settings</p>
</div>
+</div>
+<div class="sect2">
+<h3 id="_eclipse">Eclipse</h3>
<div class="paragraph">
-<p>If you are new to Git you might like to try the
-<a href="http://git.or.cz/course/svn.html";>Git guide for subversion users</a>
or have
-a look at the <a href="http://git-scm.com/book";>Git community book</a>.</p>
+<p>For Eclipse you can use this
+<a
href="http://deltaspike.apache.org/resources/files/deltaspike-code-conventions.xml";>Code
Formatter Profile</a>. Import it via Window | Preferences | Java | Code Style
| Formatter</p>
</div>
</div>
</div>
</div>
<div class="sect1">
-<h2 id="_build">Build</h2>
+<h2 id="_3_build_the_source">3. Build the Source</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>So now you probably want to <strong><code>build the code</code></strong>.
So follow the
-instructions <a href="build.html">here</a></p>
+<p>Always build and test your changes before you make pull requests to the
DeltaSpike repository. For instructions on building the source and running
Arquillian tests, see <a href="build.html">Build and Test DeltaSpike from
Source</a>.</p>
</div>
</div>
</div>
<div class="sect1">
-<h2 id="_tools_ide">Tools / IDE</h2>
+<h2 id="_4_make_a_pull_request">4. Make a Pull Request</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>Commits (and in the best case also patches), have to follow our
-"formatting rules". The following section provides settings for IDEs
-used by us.</p>
+<p>Ensure your commits and pull requests follow the our established <a
href="https://deltaspike.apache.org/suggested-git-workflows.html";>DeltaSpike
GIT workflow</a>.</p>
</div>
-<div class="sect2">
-<h3 id="_intellij">IntelliJ</h3>
-<div class="paragraph">
-<p><a
href="http://deltaspike.apache.org/resources/files/settings.jar";>Attached</a>
you can find the settings
-for formatting the source code. Import them via File | Import
-Settings…​</p>
</div>
</div>
-<div class="sect2">
-<h3 id="_eclipse">Eclipse</h3>
+<div class="sect1">
+<h2 id="_git_resources">Git Resources</h2>
+<div class="sectionbody">
<div class="paragraph">
-<p>For Eclipse you can use this
-<a
href="http://deltaspike.apache.org/resources/files/deltaspike-code-conventions.xml";>Code
Formatter Profile</a>. Import it via Window | Preferences | Java | Code Style
| Formatter</p>
+<p>For general information about Git and using Git, see the following:</p>
</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="http://wiki.apache.org/couchdb/Git_At_Apache_Guide";>Git At Apache
Guide</a></p>
+</li>
+<li>
+<p><a href="http://git-wip-us.apache.org";>Git at The ASF</a></p>
+</li>
+<li>
+<p><a href="http://git.or.cz/course/svn.html";>Git - SVN Crash Course</a></p>
+</li>
+<li>
+<p><a href="http://git-scm.com/book";>Pro Git</a></p>
+</li>
+<li>
+<p><a
href="https://help.github.com/articles/which-remote-url-should-i-use";>GitHub:
Which remote URL should I use?</a></p>
+</li>
+</ul>
</div>
</div>
</div>
Modified: deltaspike/site/trunk/content/staging/documentation/spi.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/staging/documentation/spi.html?rev=1643124&r1=1643123&r2=1643124&view=diff
==============================================================================
--- deltaspike/site/trunk/content/staging/documentation/spi.html (original)
+++ deltaspike/site/trunk/content/staging/documentation/spi.html Wed Dec 3
14:26:05 2014
@@ -171,7 +171,6 @@ body {
<div id="toc" class="toc">
<ul class="sectlevel1">
-<li><a href="#_introduction">Introduction</a></li>
<li><a href="#_deactivatable">Deactivatable</a>
<ul class="sectlevel2">
<li><a href="#_classdeactivator">ClassDeactivator</a></li>
@@ -188,51 +187,31 @@ body {
</ul>
<hr>
- <div class="sect1">
-<h2 id="_introduction">Introduction</h2>
+ <div id="preamble">
<div class="sectionbody">
-
+<div class="paragraph">
+<p>DeltaSpike provides an Service Provider Interface (SPI) to enable you to
extend it.</p>
+</div>
</div>
</div>
<div class="sect1">
<h2 id="_deactivatable">Deactivatable</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>This mechanism is only used for artifacts <strong>like</strong>
implementations of
-(<code>javax.enterprise.inject.spi.Extension</code>) which
<strong>can’t</strong> be deactivated
-with std. CDI mechanisms.</p>
-</div>
-<div class="paragraph">
-<p>This interface is just a marker interface which is implemented by all
-pre-configured DeltaSpike artifacts which can be deactivated manually
-(e.g. to improve the performance if a part isn’t needed, to provide a
-custom implementation if the default implementation isn’t pluggable by
-default or to bypass an implementation which causes an issue (in this
-case please also <strong>contact us</strong> and we will fix it)).</p>
-</div>
-<div class="paragraph">
-<p>To deactivate a class it’s required to implement
<code>ClassDeactivator</code>.
-Returning 'false' or 'true' allows to de-/activate the class in
-question. Retuning null means that the current class-deactivator doesn’t
-have information about the class in question and can’t provide a result.
-Since <code>ClassDeactivator</code> implementations are configured with the
-low-level config of DeltaSpike, the class-deactivator with the highest
-ordinal has the final decision. DeltaSpike itself doesn’t deactivate an
-implementation, however, an add-on or a 3rd party portable CDI extension
-based on DeltaSpike (Core+) can use the concept to deactivate a default
-implementation of DeltaSpike in favour of its own implementation.</p>
-</div>
-<div class="paragraph">
-<p><strong>Attention</strong>: due to the ordinal feature of the low-level
config
-approach it’s possible that a class-deactivator with a higher ordinal,
-e.g. used in a concrete project, can re-activate a deactivated
-implementation.<br>
-<strong>Please note</strong> that you might have to deactivate the parts of
the add-on
-or 3rd party CDI extension which relies on its own implementation.
-Therefore, you should <strong>be really careful with re-activation</strong>.)
The
-implementation should be stateless because the result will be cached and
-as soon as everything is initialized the class-deactivators won’t be
-used any longer.</p>
+<p>This mechanism is only used for artifacts <strong>like</strong>
implementations of (<code>javax.enterprise.inject.spi.Extension</code>) which
<strong>can’t</strong> be deactivated with std. CDI mechanisms.</p>
+</div>
+<div class="paragraph">
+<p>This interface is just a marker interface which is implemented by all
pre-configured DeltaSpike artifacts which can be deactivated manually (e.g. to
improve the performance if a part isn’t needed, to provide a custom
implementation if the default implementation isn’t pluggable by default
or to bypass an implementation which causes an issue (in this case please also
<strong>contact us</strong> and we will fix it)).</p>
+</div>
+<div class="paragraph">
+<p>To deactivate a class it’s required to implement
<code>ClassDeactivator</code>. Returning 'false' or 'true' allows to
de-/activate the class in question. Retuning null means that the current
class-deactivator doesn’t have information about the class in question
and can’t provide a result. Since <code>ClassDeactivator</code>
implementations are configured with the low-level config of DeltaSpike, the
class-deactivator with the highest ordinal has the final decision. DeltaSpike
itself doesn’t deactivate an implementation, however, an add-on or a 3rd
party portable CDI extension based on DeltaSpike (Core+) can use the concept to
deactivate a default implementation of DeltaSpike in favour of its own
implementation.</p>
+</div>
+<div class="paragraph">
+<p><strong>Attention</strong>: due to the ordinal feature of the low-level
config approach it’s possible that a class-deactivator with a higher
ordinal, e.g. used in a concrete project, can re-activate a deactivated
implementation.</p>
+</div>
+<div class="paragraph">
+<p><strong>Please note</strong> that you might have to deactivate the parts of
the add-on or 3rd party CDI extension which relies on its own implementation.
Therefore, you should <strong>be really careful with re-activation</strong>.)
The implementation should be stateless because the result will be cached and
+as soon as everything is initialized the class-deactivators won’t be
used any longer.</p>
</div>
<div class="sect2">
<h3 id="_classdeactivator">ClassDeactivator</h3>
@@ -257,12 +236,7 @@ used any longer.</p>
</div>
</div>
<div class="paragraph">
-<p>A class-deactivator will be resolved from the environment via the
-default resolvers or via a custom resolver which allows to use any type
-of configuration-format. (see
-<code>org.apache.deltaspike.core.api.config.ConfigResolver</code>). The key is
the
-fully qualified name of the interface
-(<code>org.apache.deltaspike.core.spi.activation.ClassDeactivator</code>).</p>
+<p>A class-deactivator will be resolved from the environment via the default
resolvers or via a custom resolver which allows to use any type of
configuration-format. (see
<code>org.apache.deltaspike.core.api.config.ConfigResolver</code>). The key is
the fully qualified name of the interface
(<code>org.apache.deltaspike.core.spi.activation.ClassDeactivator</code>).</p>
</div>
</div>
</div>
@@ -290,12 +264,7 @@ fully qualified name of the interface
<h2 id="_global_alternative">Global Alternative</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>There are several application servers (using CDI 1.0) which can’t
handle
-alternative CDI beans correctly (e.g. due to a too strict interpretation
-or a broken implementation). Therefore, DeltaSpike allows to use the
-std. <code>@Alternative</code> annotation and an additional config entry for
-DeltaSpike which allows to use the alternative implementation as a
-global alternative.</p>
+<p>There are several application servers (using CDI 1.0) which can’t
handle alternative CDI beans correctly (e.g. due to a too strict interpretation
or a broken implementation). Therefore, DeltaSpike allows to use the std.
<code>@Alternative</code> annotation and an additional config entry for
DeltaSpike which allows to use the alternative implementation as a global
alternative.</p>
</div>
<div class="paragraph">
<p><strong>Std. CDI alternative implementation (without the required XML
config)</strong></p>
@@ -314,15 +283,11 @@ global alternative.</p>
</div>
</div>
<div class="paragraph">
-<p>Instead of configuring the alternative in the beans.xml, a global
-alternative needs to be configured in
-/META-INF/apache-deltaspike.properties. CDI 1.1 should fix this issue
-and migrating to it means to remove the config entry for DeltaSpike
-again and move to the std. CDI config approach.</p>
+<p>Instead of configuring the alternative in the beans.xml, a global
alternative needs to be configured in /META-INF/apache-deltaspike.properties.
CDI 1.1 should fix this issue and migrating to it means to remove the config
entry for DeltaSpike again and move to the std. CDI config approach.</p>
</div>
<div class="listingblock">
<div class="content">
-<pre>custom.CustomBean=custom.AlternativeCustomBean</pre>
+<pre class="CodeRay
highlight"><code>custom.CustomBean=custom.AlternativeCustomBean</code></pre>
</div>
</div>
</div>
