Author: johndament
Date: Sun Sep 21 23:48:24 2014
New Revision: 1626650
URL: http://svn.apache.org/r1626650
Log:
Site checkin for project Apache DeltaSpike - Documentation
Added:
deltaspike/site/trunk/content/documentation/container-control-test.html
deltaspike/site/trunk/content/documentation/deltaspike_1.0.3.html
Removed:
deltaspike/site/trunk/content/documentation/README.md
Modified:
deltaspike/site/trunk/content/documentation/bean-validation.html
deltaspike/site/trunk/content/documentation/build.html
deltaspike/site/trunk/content/documentation/configuration.html
deltaspike/site/trunk/content/documentation/core.html
deltaspike/site/trunk/content/documentation/index.html
deltaspike/site/trunk/content/documentation/jpa.html
deltaspike/site/trunk/content/documentation/jsf.html
deltaspike/site/trunk/content/documentation/scheduler.html
deltaspike/site/trunk/content/documentation/source.html
deltaspike/site/trunk/content/documentation/spi.html
Modified: deltaspike/site/trunk/content/documentation/bean-validation.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/documentation/bean-validation.html?rev=1626650&r1=1626649&r2=1626650&view=diff
==============================================================================
--- deltaspike/site/trunk/content/documentation/bean-validation.html (original)
+++ deltaspike/site/trunk/content/documentation/bean-validation.html Sun Sep 21
23:48:24 2014
@@ -205,25 +205,24 @@ simply need to override the factory, eit
</div>
<div class="listingblock">
<div class="content">
-<pre class="CodeRay highlight"><code
data-lang="java">Validation.byDefaultProvider().configure().constraintValidatorFactory(<span
class="keyword">new</span>
CDIAwareConstraintValidatorFactory()).buildValidatorFactory()</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Or in XML:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="xml">:::xml
-<span class="tag"><validation-config</span> <span
class="attribute-name">xmlns</span>=<span class="string"><span
class="delimiter">"</span><span
class="content">http://jboss.org/xml/ns/javax/validation/configuration</span><span
class="delimiter">"</span></span>
- <span class="attribute-name">xmlns:xsi</span>=<span class="string"><span
class="delimiter">"</span><span
class="content">http://www.w3.org/2001/XMLSchema-instance</span><span
class="delimiter">"</span></span>
- <span class="attribute-name">xsi:schemaLocation</span>=<span
class="string"><span class="delimiter">"</span><span
class="content">http://jboss.org/xml/ns/javax/validation/configuration</span><span
class="delimiter">"</span></span><span class="tag">></span>
- <span
class="tag"><constraint-validator-factory></span>org.apache.deltaspike.beanvalidation.impl.CDIAwareConstraintValidatorFactory<span
class="tag"></constraint-validator-factory></span>
-<span class="tag"></validation-config></span></code></pre>
-</div>
+<pre class="CodeRay highlight"><code
data-lang="java">Validation.byDefaultProvider().configure().constraintValidatorFactory(<span
class="keyword">new</span>
CDIAwareConstraintValidatorFactory()).buildValidatorFactory()
+-------------------------------------------------------------------------------------------------
+
+Or in XML:
+
+[source,xml]
+------------------------------------------------------------------------------------------------------------------------
+:::xml
+<validation-config xmlns=<span class="string"><span
class="delimiter">"</span><span
class="content">http://jboss.org/xml/ns/javax/validation/configuration</span><span
class="delimiter">"</span></span>
+ xmlns:xsi=<span class="string"><span class="delimiter">"</span><span
class="content">http://www.w3.org/2001/XMLSchema-instance</span><span
class="delimiter">"</span></span>
+ xsi:schemaLocation=<span class="string"><span
class="delimiter">"</span><span
class="content">http://jboss.org/xml/ns/javax/validation/configuration</span><span
class="delimiter">"</span></span>>
+
<constraint-validator-factory>org.apache.deltaspike.beanvalidation.impl.CDIAwareConstraintValidatorFactory</constraint-validator-factory>
+</validation-config>
+------------------------------------------------------------------------------------------------------------------------
+
+And then you can simply build your <span
class="error">`</span>ConstraintValidator<span class="error">`</span>s based on
CDI
+programming rules.</code></pre>
</div>
-<div class="paragraph">
-<p>And then you can simply build your `ConstraintValidator`s based on CDI
-programming rules.</p>
</div>
</div>
</div>
Modified: deltaspike/site/trunk/content/documentation/build.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/documentation/build.html?rev=1626650&r1=1626649&r2=1626650&view=diff
==============================================================================
--- deltaspike/site/trunk/content/documentation/build.html (original)
+++ deltaspike/site/trunk/content/documentation/build.html Sun Sep 21 23:48:24
2014
@@ -240,8 +240,7 @@ configurations for the following contain
<div class="sect4">
<h5 id="_without_existing_as7">Without existing AS7</h5>
<div class="paragraph">
-<p><strong>Executing the Arquillian tests with JBoss AS7 (without AS7
-installation)</strong></p>
+<p><strong>Executing the Arquillian tests with JBoss AS7 (without AS7
installation)</strong></p>
</div>
<div class="listingblock">
<div class="content">
@@ -270,8 +269,7 @@ required)</strong></p>
<div class="sect4">
<h5 id="_without_existing_wf8">Without existing WF8</h5>
<div class="paragraph">
-<p><strong>Executing the Arquillian tests with JBoss-WF8 (without WF8
-installation)</strong></p>
+<p><strong>Executing the Arquillian tests with JBoss-WF8 (without WF8
installation)</strong></p>
</div>
<div class="listingblock">
<div class="content">
Modified: deltaspike/site/trunk/content/documentation/configuration.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/documentation/configuration.html?rev=1626650&r1=1626649&r2=1626650&view=diff
==============================================================================
--- deltaspike/site/trunk/content/documentation/configuration.html (original)
+++ deltaspike/site/trunk/content/documentation/configuration.html Sun Sep 21
23:48:24 2014
@@ -183,6 +183,7 @@ body {
<ul class="sectlevel2">
<li><a href="#_getpropertyvalue">getPropertyValue()</a></li>
<li><a
href="#_getprojectstageawarepropertyvalue">getProjectStageAwarePropertyValue()</a></li>
+<li><a
href="#_getpropertyawarepropertyvalue">getPropertyAwarePropertyValue()</a></li>
<li><a href="#_handling_of_default_values">handling of default values</a></li>
</ul>
</li>
@@ -254,7 +255,7 @@ rely on CDI it can for example be used t
</div>
<div class="paragraph">
<p>Currently this is e.g. used to configure the value of the current <a
href="projectstage.html">ProjectStage</a>, configured values which can be
-used in the expressions for <code>@Exclude</code>, <em>Deactivatable</em>,
etc. DeltaSpike
+used in the expressions for <code>@Exclude</code>, 'Deactivatable', etc.
DeltaSpike
needs such a low-level approach for several features internally, but
users can utilize it for their own needs as well. This is done by using
the <code>ConfigResolver</code> which resolves and caches `ConfigSource`s per
@@ -316,17 +317,16 @@ following lookup chain until we found a
<div class="ulist">
<ul>
<li>
-<p>key + <em>.</em> + projectStage , e.g.
"databaseconfig.username.Production"</p>
+<p>key + '.' + projectStage , e.g. "databaseconfig.username.Production"</p>
</li>
<li>
<p>key alone , e.g. "databaseconfig.username"</p>
</li>
</ul>
</div>
-<div class="paragraph">
-<p>getPropertyAwarePropertyValue()
-<sub>~</sub><sub>~</sub><sub>~</sub><sub>~</sub><sub>~</sub><sub>~</sub><sub>~</sub><sub>~</sub><sub>~</sub><sub>~</sub><sub>~</sub></p>
</div>
+<div class="sect2">
+<h3 id="_getpropertyawarepropertyvalue">getPropertyAwarePropertyValue()</h3>
<div class="paragraph">
<p>The method
<code>ConfigResolver#getProjectStageAwarePropertyValue(String key, String
property)</code>
@@ -349,7 +349,7 @@ resolve the value of the property:</p>
<div class="ulist">
<ul>
<li>
-<p>propertyValue = property + <em>.</em> + projectStage, e.g.
"dbvendor.Production"</p>
+<p>propertyValue = property + '.' + projectStage, e.g.
"dbvendor.Production"</p>
</li>
<li>
<p>if nothing found: propertyValue = property, e.g. "dbvendor"</p>
@@ -357,19 +357,19 @@ resolve the value of the property:</p>
</ul>
</div>
<div class="paragraph">
-<p>Let’s assume we found the value <em>mysql</em> for our dbvendor. In
this case
+<p>Let’s assume we found the value 'mysql' for our dbvendor. In this case
the following lookup chain is used until a value got found:</p>
</div>
<div class="ulist">
<ul>
<li>
-<p>key + <em>.</em> + property + projectstage, e.g.
"databaseconfig.username.mysql.Production"</p>
+<p>key + '.' + property + projectstage, e.g.
"databaseconfig.username.mysql.Production"</p>
</li>
<li>
-<p>key + <em>.</em> + property, e.g. "databaseconfig.username.mysql"</p>
+<p>key + '.' + property, e.g. "databaseconfig.username.mysql"</p>
</li>
<li>
-<p>key + <em>.</em> + projectstage, e.g.
"databaseconfig.username.Production"</p>
+<p>key + '.' + projectstage, e.g. "databaseconfig.username.Production"</p>
</li>
<li>
<p>key, e.g. "databaseconfig.username"</p>
@@ -408,7 +408,7 @@ values. The <code>ConfigResolver</code>
<code>ConfigSource</code> to lookup the property in question.</p>
</div>
<div class="paragraph">
-<p>Each <em>ConfigSource</em> has a specified <em>ordinal</em> which can be
configured
+<p>Each 'ConfigSource' has a specified 'ordinal' which can be configured
using the key <code>deltaspike_ordinal</code>. This ordinal get’s used
to determine
the importance of the values taken from the very ConfigSource. A higher
ordinal means that the values taken from this ConfigSource will override
@@ -459,7 +459,7 @@ caching.</p>
<p>To change the lookup order, you have to configure the ordinal in the
corresponding config source (e.g. to change the config ordinal of the
config source for system properties, you have to set the system property
-with the ordinal key <em>deltaspike_ordinal</em> and the new value).</p>
+with the ordinal key 'deltaspike_ordinal' and the new value).</p>
</div>
<div class="paragraph">
<p>Example with <code>/META-INF/apache-deltaspike.properties</code>: If the
properties
@@ -484,7 +484,7 @@ independent config-source, but all of th
<div class="sect2">
<h3 id="_custom_config_sources">Custom Config-Sources</h3>
<div class="paragraph">
-<p>ConfigSources are picked up using the ‘java.util.ServiceLoader’
+<p>ConfigSources are picked up using the `java.util.ServiceLoader'
mechanism.</p>
</div>
<div class="paragraph">
Added: deltaspike/site/trunk/content/documentation/container-control-test.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/documentation/container-control-test.html?rev=1626650&view=auto
==============================================================================
--- deltaspike/site/trunk/content/documentation/container-control-test.html
(added)
+++ deltaspike/site/trunk/content/documentation/container-control-test.html Sun
Sep 21 23:48:24 2014
@@ -0,0 +1,400 @@
+<!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>Container & Control</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="http://deltaspike.apache.org/resources/css/bootstrap.css";
rel="stylesheet">
+<link
href="http://deltaspike.apache.org/resources/css/bootstrap-responsive.css";
rel="stylesheet">
+
+<style type="text/css">
+/* Foundation stylesheet for CodeRay (to match GitHub theme) | MIT License |
http://foundation.zurb.com */
+table.CodeRay { border-collapse: collapse; padding: 2px; margin-bottom: 0;
border: 0; background: transparent; }
+table.CodeRay td { padding: 0 .5em; vertical-align: top; }
+table.CodeRay td.line-numbers { text-align: right; color: #999; border-right:
1px solid #e5e5e5; padding-left: 0; }
+span.line-numbers { border-right: 1px solid #E5E5E5; color: #999; display:
inline-block; margin-right: 0.5em; padding-right: 0.5em; }
+.CodeRay td.line-numbers strong, .CodeRay span.line-numbers strong {
font-weight: normal; }
+.CodeRay .debug { color: white !important; background: blue !important; }
+.CodeRay .annotation { color: #007; }
+.CodeRay .attribute-name { color: #f08; }
+.CodeRay .attribute-value { color: #700; }
+.CodeRay .binary { color: #509; }
+.CodeRay .comment { color: #999; font-style: italic; }
+.CodeRay .char { color: #04D; }
+.CodeRay .char .content { color: #04D; }
+.CodeRay .char .delimiter { color: #039; }
+.CodeRay .class { color: #458; }
+.CodeRay .complex { color: #A08; }
+.CodeRay .constant { color: teal; }
+.CodeRay .color { color: #0A0; }
+.CodeRay .class-variable { color: #369; }
+.CodeRay .decorator { color: #B0B; }
+.CodeRay .definition { color: #099; }
+.CodeRay .directive { color: #088; }
+.CodeRay .delimiter { color: black; }
+.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: #C00; }
+.CodeRay .filename { color: #099; }
+.CodeRay .function { color: #900; }
+.CodeRay .global-variable { color: teal; }
+.CodeRay .hex { color: #058; }
+.CodeRay .integer { color: #099; }
+.CodeRay .include { color: #B44; }
+.CodeRay .inline { color: black; }
+.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: #f00; }
+.CodeRay .interpreted { color: #B2B; }
+.CodeRay .instance-variable { color: teal; }
+.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: #00C; }
+.CodeRay .predefined-type { color: #074; }
+.CodeRay .reserved, .keyword { color: #000; }
+.CodeRay .key { color: #808; }
+.CodeRay .key .delimiter { color: #606; }
+.CodeRay .key .char { color: #80f; }
+.CodeRay .value { color: #088; }
+.CodeRay .regexp { background-color: #fff0ff; }
+.CodeRay .regexp .content { color: #808; }
+.CodeRay .regexp .delimiter { color: #404; }
+.CodeRay .regexp .modifier { color: #C2C; }
+.CodeRay .regexp .function { color: #404; font-weight: bold; }
+.CodeRay .string { color: #D20; }
+.CodeRay .string .string { }
+.CodeRay .string .string .string { background-color: #ffd0d0; }
+.CodeRay .string .content { color: #D14; }
+.CodeRay .string .char { color: #D14; }
+.CodeRay .string .delimiter { color: #D14; }
+.CodeRay .shell { color: #D14; }
+.CodeRay .shell .content { }
+.CodeRay .shell .delimiter { color: #D14; }
+.CodeRay .symbol { color: #990073; }
+.CodeRay .symbol .content { color: #A60; }
+.CodeRay .symbol .delimiter { color: #630; }
+.CodeRay .tag, .CodeRay .attribute-name { color: #070; }
+.CodeRay .tag-special { color: #D70; }
+.CodeRay .type { color: #339; }
+.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/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>Container & Control</h1>
+ </div>
+
+ <div id="toc" class="toc2">
+ <ul class="sectlevel1">
+<li><a href="#_introduction">Introduction</a></li>
+<li>
+<ul class="sectlevel2">
+<li><a href="#_cdicontainer">CdiContainer</a></li>
+<li><a href="#_contextcontrol_usage">ContextControl usage</a></li>
+<li><a href="#_embedded_servlet_support">Embedded Servlet Support</a></li>
+<li>
+<ul class="sectlevel3">
+<li><a href="#_jetty">Jetty</a></li>
+<li><a href="#_undertow">Undertow</a></li>
+<li><a href="#_tomcat">Tomcat</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+ <hr>
+
+ <div class="sect1">
+<h2 id="_introduction">Introduction</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>There are basically two parts:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The <code>CdiContainer</code> interface allows to boot and shutdown the CDI
container in SE applications.</p>
+</li>
+<li>
+<p>The <code>ContextControl</code> interface allows to control the life-cycle
of the built-in contexts of the CDI container.</p>
+</li>
+</ul>
+</div>
+<div class="sect2">
+<h3 id="_cdicontainer">CdiContainer</h3>
+<div class="paragraph">
+<p>You can use the <code>CdiContainerLoader</code> as a simple factory to gain
access to the underlying <code>CdiContainer</code> implementation. This is of
little interest for Java EE applications since the CDI Container
+already gets properly booted and shut down by the Servlet container
integration.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay"><code class="java language-java"><span class="comment">//
this will give you a CdiContainer for Weld or OWB, depending on the jar you
added</span>
+CdiContainer cdiContainer = CdiContainerLoader.getCdiContainer();
+<span class="comment">// now we gonna boot the CDI container. This will
trigger the classpath scan, etc</span>
+cdiContainer.boot();
+<span class="comment">// and finally we like to start all built-in
contexts</span>
+cdiContainer.getContextControl().startContexts();
+<span class="comment">// now we can use CDI in our SE application.</span>
+<span class="comment">// And there is not a single line of OWB or Weld
specific code in your project!</span>
+<span class="comment">// finally we gonna stop the container</span>
+cdiContainer.shutdown();</code></pre>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_contextcontrol_usage">ContextControl usage</h3>
+<div class="paragraph">
+<p>The <code>ContextControl</code> interface allows you to start and stop
built-in standard Contexts like <code>@RequestScoped</code>,
<code>@ConversationScoped</code>, <code>@SessionScoped</code>, etc. It is
provided as <code>@Dependent</code> bean and can get injected in the classic
CDI way. This is not only usable in Java SE projects but also very helpful in
Servlets and Java EE containers.</p>
+</div>
+<div class="paragraph">
+<p><strong>Restarting the RequestContext in unit tests</strong></p>
+</div>
+<div class="paragraph">
+<p>In unit testing it can be necessary to test with attached and also with
detached JPA entities. A very common approach for
+JPA is the link: <a
href="http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Web_Server/1.0/html/Hibernate_Entity_Manager_Reference_Guide/transactions.html";
target="_blank">entitymanager-per-request approach</a>
+and thus have a producer method which creates a <code>@RequestScoped
EntityManager</code>. Since a single unit test is usually
+treated as one ârequestâ a problem arises detaching entities.</p>
+</div>
+<div class="paragraph">
+<p>Using ContextControl to detach entities:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay"><code class="java language-java"><span
class="annotation">@Test</span>
+<span class="directive">public</span> <span class="type">void</span>
testMyBusinessLogic()
+{
+ doSomeJpaStuff()
+ MyEntity me = em.find(...);
+ ContextControl ctxCtrl =
BeanProvider.getContextualReference(ContextControl.class);
+ <span class="comment">//stopping the request context will dispose the
@RequestScoped EntityManager</span>
+ ctxCtrl.stopContext(RequestScoped.class);
+ <span class="comment">// and now immediately restart the context
again</span>
+ ctxCtrl.startContext(RequestScoped.class);
+ <span class="comment">// the entity 'em' is now in a detached state!</span>
+ doSomeStuffWithTheDetachedEntity(em);
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Attaching a Request Context to a new thread in EE</p>
+</div>
+<div class="paragraph">
+<p>Accessing the <code>@RequestScoped</code> bean in a new thread will result
in a <code>ContextNotActiveException</code>. The request-context usually gets
started for a particular thread via a simple
<code>ServletRequestListener</code>. So "no servlet-request" means that there
is no Servlet-Context for the current (/new) Thread.
+You might face such issues, if you would like to reuse business services in
e.g. a Quartz Job.</p>
+</div>
+<div class="paragraph">
+<p>Controlling the request-context for a Quartz-Job:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay"><code class="java language-java"><span
class="directive">public</span> <span class="type">class</span> <span
class="class">CdiJob</span> <span class="directive">implements</span>
org.quartz.Job
+{
+ <span class="directive">public</span> <span class="type">void</span>
execute(JobExecutionContext context) <span class="directive">throws</span>
JobExecutionException
+ {
+ ContextControl ctxCtrl =
BeanProvider.getContextualReference(ContextControl.class);
+ <span class="comment">//this will implicitly bind a new RequestContext
to the current thread</span>
+ ctxCtrl.startContext(RequestScoped.class);
+ <span class="keyword">try</span>
+ {
+ doYourWork();
+ }
+ <span class="keyword">finally</span>
+ {
+ <span class="comment">//stop the RequestContext to ensure that all
request-scoped beans get cleaned up.</span>
+ ctxCtrl.stopContext(RequestScoped.class);
+ }
+ }
+}</code></pre>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_embedded_servlet_support">Embedded Servlet Support</h3>
+<div class="paragraph">
+<p>Starting with 1.0.2, you can use DeltaSpike to power embedded Servlet
runtimes. This work is done via Servlet Listeners. The configuration is
specific to each container, below are some examples.</p>
+</div>
+<div class="paragraph">
+<p>The two main listeners are <code>CdiServletRequestListener</code> and
<code>CdiServletContextListener</code>. <code>CdiServletRequestListener</code>
is responsible for starting a <code>RequestContext</code> on each incoming
request. In most containers this is all you need. For Tomcat specifically,
you need to use <code>CdiServletContextListener</code> which registers the
<code>CdiServletRequestListener</code>.</p>
+</div>
+<div class="paragraph">
+<p>The main usecase for this feature is for lightweight embedded runtimes,
microservices. For each of these, it is assumed that you are using the
following start up code somewhere:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay"><code class="java language-java">CdiContainer
cdiContainer = CdiContainerLoader.getCdiContainer();
+cdiContainer.boot();
+cdiContainer.getContextControl().startContexts();</code></pre>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_jetty">Jetty</h4>
+<div class="paragraph">
+<p>For Jetty, you need to add an <code>EventListener</code> which will be your
<code>CdiServletRequestListener</code>. The object must be instantiated. This
must be done before the server is started.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay"><code class="java language-java">Server server = <span
class="keyword">new</span> Server(port);
+ServletContextHandler context = <span class="keyword">new</span>
ServletContextHandler(ServletContextHandler.SESSIONS);
+context.setContextPath(<span class="string"><span
class="delimiter">"</span><span class="content">/</span><span
class="delimiter">"</span></span>);
+server.setHandler(context);
+context.addEventListener(<span class="keyword">new</span>
CdiServletRequestListener());
+context.addServlet(<span class="keyword">new</span> ServletHolder(<span
class="keyword">new</span> YourServlet()),<span class="string"><span
class="delimiter">"</span><span class="content">/*</span><span
class="delimiter">"</span></span>);
+server.start();</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_undertow">Undertow</h4>
+<div class="paragraph">
+<p>For Undertow, you register the <code>CdiServletRequestListener</code> via
<code>ListenerInfo</code> by passing in the class to their builders. Then you
add the <code>ListenerInfo</code> to your deployment before starting.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay"><code class="java language-java">ServletInfo servletInfo
= Servlets.servlet(<span class="string"><span
class="delimiter">"</span><span
class="content">YourServletName</span><span
class="delimiter">"</span></span>,
YourServlet.class).setAsyncSupported(<span
class="predefined-constant">true</span>)
+ .setLoadOnStartup(<span class="integer">1</span>).addMapping(<span
class="string"><span class="delimiter">"</span><span
class="content">/*</span><span class="delimiter">"</span></span>);
+ListenerInfo listenerInfo =
Servlets.listener(CdiServletRequestListener.class); <b>(1)</b>
+DeploymentInfo di = <span class="keyword">new</span> DeploymentInfo()
+ .addListener(listenerInfo) <b>(2)</b>
+ .setContextPath(<span class="string"><span
class="delimiter">"</span><span class="content">/</span><span
class="delimiter">"</span></span>)
+ .addServlet(servletInfo).setDeploymentName(<span class="string"><span
class="delimiter">"</span><span class="content">CdiSEServlet</span><span
class="delimiter">"</span></span>)
+ .setClassLoader(<span
class="predefined-type">ClassLoader</span>.getSystemClassLoader());
+DeploymentManager deploymentManager =
Servlets.defaultContainer().addDeployment(di);
+deploymentManager.deploy();
+Undertow server = Undertow.builder()
+ .addHttpListener(port, <span class="string"><span
class="delimiter">"</span><span class="content">localhost</span><span
class="delimiter">"</span></span>)
+ .setHandler(deploymentManager.start())
+ .build();
+server.start();</code></pre>
+</div>
+</div>
+<div class="colist arabic">
+<ol>
+<li>
+<p>Register as a listener.</p>
+</li>
+<li>
+<p>Add to deployment</p>
+</li>
+</ol>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_tomcat">Tomcat</h4>
+<div class="paragraph">
+<p>For Tomcat, you need to register the <code>CdiServletContextListener</code>
instead of the <code>CdiServletRequestListener</code>. It is added as an
<code>ApplicationListener</code> by passing in the class name as a
<code>String</code>.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay"><code class="java language-java">Tomcat tomcat = <span
class="keyword">new</span> Tomcat();
+tomcat.setPort(port);
+<span class="predefined-type">File</span> base = <span
class="keyword">new</span> <span class="predefined-type">File</span>(<span
class="string"><span class="delimiter">"</span><span
class="content">...</span><span class="delimiter">"</span></span>);
+<span class="predefined-type">Context</span> ctx = tomcat.addContext(<span
class="string"><span class="delimiter">"</span><span
class="content">/</span><span
class="delimiter">"</span></span>,base.getAbsolutePath());
+StandardContext standardContext = (StandardContext)ctx;
+standardContext.addApplicationListener(CdiServletContextListener.class.getName());
+Wrapper wrapper = Tomcat.addServlet(ctx,<span class="string"><span
class="delimiter">"</span><span class="content">YourServlet</span><span
class="delimiter">"</span></span>,YourServlet.class.getName());
+wrapper.addMapping(<span class="string"><span
class="delimiter">"</span><span class="content">/*</span><span
class="delimiter">"</span></span>);
+tomcat.start();</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+</div>
+ </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/documentation/core.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/documentation/core.html?rev=1626650&r1=1626649&r2=1626650&view=diff
==============================================================================
--- deltaspike/site/trunk/content/documentation/core.html (original)
+++ deltaspike/site/trunk/content/documentation/core.html Sun Sep 21 23:48:24
2014
@@ -191,8 +191,7 @@ body {
<li><a href="#_customizing_the_message_context">Customizing the message
context</a></li>
</ul>
</li>
-<li><a href="#_injecting_resources">Injecting Resources</a></li>
-<li><a href="#_exception_control">Exception Control</a>
+<li><a href="#_injecting_resources">Injecting Resources</a>
<ul class="sectlevel3">
<li><a href="#_usage">Usage</a></li>
<li><a href="#_exception_handlers">Exception handlers</a></li>
@@ -240,7 +239,7 @@ body {
<p>The <code>BeanProvider</code> is a class which provides (static) util
methods which
allow to lookup beans if it isn’t possible to inject them via
<code>@Inject</code>
or if the lookup depends on dynamic conditions. Instead of using the
-term <em>bean</em>, the term <em>contextual instance</em> is used because
that’s the
+term 'bean', the term 'contextual instance' is used because that’s the
term used by CDI itself.</p>
</div>
<div class="paragraph">
@@ -277,7 +276,7 @@ question. CDI qualifiers are annotations
implement a corresponding literal for providing an instance.</p>
</div>
<div class="paragraph">
-<p>Literal implementation for <em>@MyQualifier</em>:</p>
+<p>Literal implementation for '@MyQualifier':</p>
</div>
<div class="listingblock">
<div class="content">
@@ -319,7 +318,7 @@ the following examples show how to do a
</div>
<div class="listingblock">
<div class="content">
-<pre>MyBean myBean = BeanProvider.getContextualReference("myBean", false,
MyBean.class);</pre>
+<pre class="CodeRay highlight"><code data-lang="java">MyBean myBean =
BeanProvider.getContextualReference(<span class="string"><span
class="delimiter">"</span><span class="content">myBean</span><span
class="delimiter">"</span></span>, <span
class="predefined-constant">false</span>, MyBean.class);</code></pre>
</div>
</div>
<div class="paragraph">
@@ -559,7 +558,7 @@ ExpressionInterpreter is needed:</p>
<h3 id="_literals">Literals</h3>
<div class="paragraph">
<p>Literals allow the instantiation of annotations by extending the
-abstract class <em>javax.enterprise.util.AnnotationLiteral</em></p>
+abstract class 'javax.enterprise.util.AnnotationLiteral'</p>
</div>
<div class="paragraph">
<p><strong>Example</strong></p>
@@ -895,9 +894,9 @@ and <code>FileResourceProvider</code>. T
the <code>InjectableResourceProvider</code> interface to allow reading from
alternate sources, if needed (e.g. database LOBs, NoSQL storage areas).</p>
</div>
+<div class="paragraph">
+<p>===Exception Control</p>
</div>
-<div class="sect2">
-<h3 id="_exception_control">Exception Control</h3>
<div class="paragraph">
<p>Exception handling in DeltaSpike is based around the CDI eventing model.
While the implementation of exception handlers may not be the same as a
Added: deltaspike/site/trunk/content/documentation/deltaspike_1.0.3.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/documentation/deltaspike_1.0.3.html?rev=1626650&view=auto
==============================================================================
--- deltaspike/site/trunk/content/documentation/deltaspike_1.0.3.html (added)
+++ deltaspike/site/trunk/content/documentation/deltaspike_1.0.3.html Sun Sep
21 23:48:24 2014
@@ -0,0 +1,338 @@
+<!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>DeltaSpike Release Notes v1.0.3</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="http://deltaspike.apache.org/resources/css/bootstrap.css";
rel="stylesheet">
+<link
href="http://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/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>DeltaSpike Release Notes v1.0.3</h1>
+ </div>
+
+ <div id="toc" class="toc">
+ <ul class="sectlevel1">
+<li><a href="#_announcement">Announcement</a></li>
+<li><a href="#_highlights">Highlights</a>
+<ul class="sectlevel2">
+<li><a href="#_code_changes">Code Changes</a></li>
+<li><a href="#_documentation_changes">Documentation Changes</a></li>
+</ul>
+</li>
+<li><a href="#_credits_thanks">Credits & Thanks</a></li>
+<li><a href="#_full_release_notes">Full Release Notes</a></li>
+</ul>
+ <hr>
+
+ <div class="sect1">
+<h2 id="_announcement">Announcement</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The DeltaSpike team is proud to announce the release of v1.0.3. See <a
href="http://apache-deltaspike-incubator-discussions.2316169.n4.nabble.com/ANNOUNCE-Release-of-Apache-DeltaSpike-1-0-2-td4658671.html";
target="_blank">our release announcement email</a> for additional
information.</p>
+</div>
+<div class="paragraph">
+<p>Please read our <a href="index.html#_getting_started">setup guide</a> to
add DeltaSpike to your application.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_highlights">Highlights</h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="_code_changes">Code Changes</h3>
+<div class="ulist">
+<ul>
+<li>
+<p>Multiple improvements and fixes to our JSF Support</p>
+</li>
+<li>
+<p>Fixes around client window handling with JSF Native & Primefaces
AJAX</p>
+</li>
+<li>
+<p>Window ID handling now works properly with lazy configuration</p>
+</li>
+<li>
+<p>Exception handling has been improved; better cross module support, JSF
integration for Exceptions is improved.</p>
+</li>
+<li>
+<p>CDI versions are no longer included directly in any profile, to help with
running applications against CDI 1.1/1.2 runtimes</p>
+</li>
+<li>
+<p><code>BeanManagerProvider</code> will automatically use a child’s
classloader for <code>BeanManager</code> detection in case none found for the
parent.</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_documentation_changes">Documentation Changes</h3>
+<div class="paragraph">
+<p>Several important documentation changes went in as well</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Scope availability in the core module</p>
+</li>
+<li>
+<p>Documentation around Security and PicketLink</p>
+</li>
+<li>
+<p>The first steps to moving our documentation to asciidoc has been
performed</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_credits_thanks">Credits & Thanks</h2>
+<div class="sectionbody">
+<div class="ulist">
+<ul>
+<li>
+<p>Thanks to all those that contributed via <a
href="https://www.openhub.net/p/DeltaSpike/contributors?query=&sort=latest_commit";
target="_blank">OpenHub</a></p>
+</li>
+<li>
+<p>Thanks to those who reviewed and <a
href="http://markmail.org/message/uvq62i4iioapkto2"; target="_blank">voted</a>
on the release</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_full_release_notes">Full Release Notes</h2>
+<div class="sectionbody">
+<h3> Bug
+</h3>
+<ul>
+<li>[<a
href='https://issues.apache.org/jira/browse/DELTASPIKE-696'>DELTASPIKE-696</a>]
- Remove unneeded dependencies on CDICtrl Servlet
+</li>
+<li>[<a
href='https://issues.apache.org/jira/browse/DELTASPIKE-706'>DELTASPIKE-706</a>]
- Multiple CDI API versions on classpath in JSF module tests (Weld)
+</li>
+<li>[<a
href='https://issues.apache.org/jira/browse/DELTASPIKE-710'>DELTASPIKE-710</a>]
- Error using clientWindow and (p|f):ajax
+</li>
+<li>[<a
href='https://issues.apache.org/jira/browse/DELTASPIKE-717'>DELTASPIKE-717</a>]
- Exception handlers not invoked when @Secured ViewConfig is violated
in an app with JSF module without a DefaultErrorView page
+</li>
+<li>[<a
href='https://issues.apache.org/jira/browse/DELTASPIKE-719'>DELTASPIKE-719</a>]
- Only one voter invoked if multiple voters are applied through a
stereotype
+</li>
+<li>[<a
href='https://issues.apache.org/jira/browse/DELTASPIKE-723'>DELTASPIKE-723</a>]
- Exception bypassing on JSF conversion errors
+</li>
+<li>[<a
href='https://issues.apache.org/jira/browse/DELTASPIKE-726'>DELTASPIKE-726</a>]
- Lazy window handling doesn't recognize new windows anymore
+</li>
+<li>[<a
href='https://issues.apache.org/jira/browse/DELTASPIKE-729'>DELTASPIKE-729</a>]
- f:viewAction is executed twice with LAZY window handling mode
+</li>
+</ul>
+
+<h3> Improvement
+</h3>
+<ul>
+<li>[<a
href='https://issues.apache.org/jira/browse/DELTASPIKE-692'>DELTASPIKE-692</a>]
- workaround for tests which don't use optional classes
+</li>
+<li>[<a
href='https://issues.apache.org/jira/browse/DELTASPIKE-699'>DELTASPIKE-699</a>]
- Signature relaxing of attribute method() in CriteriaSupport
+</li>
+<li>[<a
href='https://issues.apache.org/jira/browse/DELTASPIKE-708'>DELTASPIKE-708</a>]
- Veto the AbstractEntityRepository class
+</li>
+<li>[<a
href='https://issues.apache.org/jira/browse/DELTASPIKE-712'>DELTASPIKE-712</a>]
- BeanManagerProvider : Wrap usage in parent class loaders
+</li>
+</ul>
+
+<h3> New Feature
+</h3>
+<ul>
+<li>[<a
href='https://issues.apache.org/jira/browse/DELTASPIKE-702'>DELTASPIKE-702</a>]
- Add support to GreaterThan and LessThan in criteria to dates
+</li>
+</ul>
+
+<h3> Task
+</h3>
+<ul>
+<li>[<a
href='https://issues.apache.org/jira/browse/DELTASPIKE-640'>DELTASPIKE-640</a>]
- Document Scopes in Core module
+</li>
+<li>[<a
href='https://issues.apache.org/jira/browse/DELTASPIKE-677'>DELTASPIKE-677</a>]
- document ds-security in combination with picketlink
+</li>
+<li>[<a
href='https://issues.apache.org/jira/browse/DELTASPIKE-697'>DELTASPIKE-697</a>]
- Set the baseDir to reside in the target directory for tomcat tests.
+</li>
+<li>[<a
href='https://issues.apache.org/jira/browse/DELTASPIKE-698'>DELTASPIKE-698</a>]
- re-visit glassfish4 profile
+</li>
+<li>[<a
href='https://issues.apache.org/jira/browse/DELTASPIKE-711'>DELTASPIKE-711</a>]
- Create placeholder documentation directory
+</li>
+<li>[<a
href='https://issues.apache.org/jira/browse/DELTASPIKE-716'>DELTASPIKE-716</a>]
- Migrate documentation format to asciidoc at git repo
+</li>
+<li>[<a
href='https://issues.apache.org/jira/browse/DELTASPIKE-730'>DELTASPIKE-730</a>]
- release notes for v1.0.3
+</li>
+</ul>
+</div>
+</div>
+ </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/documentation/index.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/documentation/index.html?rev=1626650&r1=1626649&r2=1626650&view=diff
==============================================================================
--- deltaspike/site/trunk/content/documentation/index.html (original)
+++ deltaspike/site/trunk/content/documentation/index.html Sun Sep 21 23:48:24
2014
@@ -191,8 +191,8 @@ body {
<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></li>
<li><a href="#_with_java_se">With Java SE</a></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_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>
@@ -422,8 +422,7 @@ manually.</p>
<div class="sect2">
<h3 id="_project_configuration_with_maven">Project Configuration with
Maven</h3>
<div class="paragraph">
-<p><strong>Hint:</strong> In the listings below replace the placeholders for
the version
-with the version of your choice or use:</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>
<div class="listingblock">
<div class="content">
@@ -678,7 +677,7 @@ with the version of your choice or use:<
</div>
</div>
<div class="sect3">
-<h4 id="__for_apache_openwebbeans"> …​ for Apache OpenWebBeans</h4>
+<h4 id="__for_apache_openwebbeans">…​ for Apache OpenWebBeans</h4>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="xml"><span
class="tag"><dependency></span>
@@ -705,7 +704,7 @@ with the version of your choice or use:<
</div>
</div>
<div class="sect3">
-<h4 id="__for_jboss_weld_ri"> …​ for JBoss Weld (RI)</h4>
+<h4 id="__for_jboss_weld_ri">…​ for JBoss Weld (RI)</h4>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="xml"><span
class="tag"><dependency></span>
Modified: deltaspike/site/trunk/content/documentation/jpa.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/documentation/jpa.html?rev=1626650&r1=1626649&r2=1626650&view=diff
==============================================================================
--- deltaspike/site/trunk/content/documentation/jpa.html (original)
+++ deltaspike/site/trunk/content/documentation/jpa.html Sun Sep 21 23:48:24
2014
@@ -172,7 +172,6 @@ body {
<div id="toc" class="toc">
<ul class="sectlevel1">
<li><a href="#__transactional">@Transactional</a></li>
-<li><a href="#transactionscoped">@TransactionScoped</a></li>
<li><a href="#_extended_persistence_contexts">Extended Persistence
Contexts</a></li>
<li><a href="#_jta_support">JTA Support</a></li>
</ul>
@@ -508,11 +507,9 @@ a different <code>EntityManager</code>.
<code>FirstLevelTransactionBean</code> e.g. to try an optional path instead of
an
immediate rollback.</p>
</div>
+<div class="paragraph">
+<p>==@TransactionScoped</p>
</div>
-</div>
-<div class="sect1">
-<h2 id="transactionscoped">@TransactionScoped</h2>
-<div class="sectionbody">
<div class="paragraph">
<p><code>@Transactional</code> also starts a context which is available as
long as the
transaction started by <code>@Transactional</code>. Besides other beans you
can use
Modified: deltaspike/site/trunk/content/documentation/jsf.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/documentation/jsf.html?rev=1626650&r1=1626649&r2=1626650&view=diff
==============================================================================
--- deltaspike/site/trunk/content/documentation/jsf.html (original)
+++ deltaspike/site/trunk/content/documentation/jsf.html Sun Sep 21 23:48:24
2014
@@ -215,10 +215,11 @@ body {
<li><a href="#_intro_2">Intro</a></li>
<li><a href="#_motivation">Motivation</a></li>
<li><a href="#_bean_discovery_mode_annotated">Bean-discovery-mode
annotated</a></li>
-<li><a href="#basic-api-usages">Basic API usages</a>
+<li><a href="#_basic_api_usages">Basic API usages</a>
<ul class="sectlevel3">
<li><a href="#_file_view_and_folder_folder_paths">File (@View) and Folder
(@Folder) paths</a></li>
<li><a href="#_navigation_parameters">Navigation Parameters</a></li>
+<li><a href="#_static_configuration_via_navigationparameter">Static
Configuration via @NavigationParameter</a></li>
<li><a href="#_security_integration_via_secured">Security Integration via
@Secured</a></li>
<li><a
href="#_view_controller_callbacks_via_viewcontrollerref">View-Controller
Callbacks via @ViewControllerRef</a></li>
<li><a href="#_referencing_views_via_viewref">Referencing Views via
@ViewRef</a></li>
@@ -331,7 +332,7 @@ contains a method to prevent this proble
the browser window via JavaScript. Usually this is rendered and executed
in the same page as the user form. See the "Post-render window
detection" paragraph for a more detailed description. The major downside
-of this solution is that we might already pollute <em>foreign</em> beans (and
+of this solution is that we might already pollute 'foreign' beans (and
destroy their information) while rendering the page, which means this is
not feasible as general solution.</p>
</div>
@@ -366,13 +367,13 @@ windowId will be added as hidden input t
<ul>
<li>
<p>Having the windowhandler.html site rendered between requests sometimes
-leads to some <em>flickering</em> if the destination page takes some time to
+leads to some 'flickering' if the destination page takes some time to
load. The browser first renders our windowhandler and only after that
the original page will get loaded. This effect may be minimized by
branding the windowhandler.html page and providing an own one with a
bgcolor which matches your application. For html-5 aware browsers we
-also got rid of this flickering by storing away a <em>screenshot</em> of the
-first page in onclick() and immediately restore this <em>screenshot</em> on the
+also got rid of this flickering by storing away a 'screenshot' of the
+first page in onclick() and immediately restore this 'screenshot' on the
intermediate windowhandler.html page. Technically we do this by storing
away the and css information into the html5 localStorage and restore them on
the
intermediate page. We also introduced a WindowConfig which is able to
@@ -599,7 +600,7 @@ implementation, you can just do it e.g.
</div>
</div>
<div class="paragraph">
-<p>Don’t forget to set the <code>ClientWindowRenderMode</code> to
<em>CUSTOM</em> via the
+<p>Don’t forget to set the <code>ClientWindowRenderMode</code> to
'CUSTOM' via the
<code>JsfModuleConfig</code>:</p>
</div>
<div class="listingblock">
@@ -684,8 +685,8 @@ also the reason for the name @<em>View</
<div class="paragraph">
<p>Hint: @ViewAccessScoped beans are best used in conjunction with the
<code>CLIENTWINDOW</code> window handling, which ensures a clean browser-tab
-separation without touching the old windowId. Otherwise a <em>open in new
-tab</em> on a page with a @ViewAccessScoped bean might cause the termination
+separation without touching the old windowId. Otherwise a 'open in new
+tab' on a page with a @ViewAccessScoped bean might cause the termination
(and re-initialization) of that bean.</p>
</div>
</div>
@@ -855,8 +856,7 @@ more work <strong>initially</strong>?</p
<p><strong>The short answer is:</strong></p>
</div>
<div class="paragraph">
-<p>It gives a good return in case of real applications (esp. beyond simple
-demos).</p>
+<p>It gives a good return in case of real applications (esp. beyond simple
demos).</p>
</div>
<div class="paragraph">
<p><strong>The long answer is:</strong></p>
@@ -931,7 +931,7 @@ like to use the mode <code>annotated</co
</div>
</div>
<div class="sect2">
-<h3 id="basic-api-usages">Basic API usages</h3>
+<h3 id="_basic_api_usages">Basic API usages</h3>
<div class="paragraph">
<p>While reading this section keep the following simple rules in mind:
Meta-data gets inherited along the path of Java inheritance
@@ -1137,7 +1137,7 @@ Pages.Wizard1.Step1).</p>
`NameBuilder`s inline or globally).</p>
</div>
<div class="sect4">
-<h5 id="foldername">@Folder#name</h5>
+<h5 id="__folder_name">@Folder#name</h5>
<div class="paragraph">
<p>The rules are pretty simple. You will get what you write. There are only
two additional features:</p>
@@ -1145,7 +1145,7 @@ two additional features:</p>
<div class="ulist">
<ul>
<li>
-<p>You don’t have to care about duplicated <em>/</em> (e.g.
/folder1//folder2/step1.xhtml would get corrected auto. to
/folder1/folder2/step1.xhtml)</p>
+<p>You don’t have to care about duplicated '/' (e.g.
/folder1//folder2/step1.xhtml would get corrected auto. to
/folder1/folder2/step1.xhtml)</p>
</li>
<li>
<p>With "." at the beginning (e.g. "./") you can keep the path before.</p>
@@ -1293,7 +1293,7 @@ inherited along the inheritance path.</p
<div class="paragraph">
<p>Since the view-config is static, an approach to add parameters is
needed. The following part shows different possibilities to add
-parameters which end up in the final URL after <em>?</em> (in case of the
+parameters which end up in the final URL after '?' (in case of the
integration with JSF). It isn’t needed to add all (types of) parameters
that way. Some get added autom. based on special meta-data (e.g.
<code>@View#navigation</code> and <code>@View#viewParams</code>). Instead of
adding
@@ -1301,8 +1301,9 @@ that way. Some get added autom. based on
using <code>@View(navigation = REDIRECT)</code>. The same goes for
<code>"includeViewParams=true"</code> and <code>@View(viewParams =
INCLUDE)</code>.</p>
</div>
-<div class="sect4">
-<h5 id="_static_configuration_via_navigationparameter">Static Configuration
via @NavigationParameter</h5>
+</div>
+<div class="sect3">
+<h4 id="_static_configuration_via_navigationparameter">Static Configuration
via @NavigationParameter</h4>
<div class="paragraph">
<p>In some cases it’s needed to add an information in any case. So you
can
annotate the view-config class with <code>@NavigationParameter</code>.
Supported
@@ -1349,7 +1350,6 @@ them statically for particular methods:<
}</code></pre>
</div>
</div>
-</div>
<div class="sect4">
<h5 id="_dynamic_configuration_via_navigationparametercontext">Dynamic
Configuration via NavigationParameterContext</h5>
<div class="paragraph">
@@ -2544,7 +2544,7 @@ normal exceptions. This is possible via
<p>To avoid that the same content of a form gets submitted and therefore
processed multiple times, it’s possible to use the tag
<code><ds:preventDoubleSubmit/></code>. As usual for DeltaSpike
JSF-tags, the <code>ds</code>
-namespace is <code>http://deltaspike.apache.org/jsf</code>. Just add this tag
+namespace is <code><a href="http://deltaspike.apache.org/jsf";
class="bare">http://deltaspike.apache.org/jsf</a></code>. Just add this tag
within every JSF form-tag, you would like to safeguard.</p>
</div>
<div class="listingblock">
Modified: deltaspike/site/trunk/content/documentation/scheduler.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/documentation/scheduler.html?rev=1626650&r1=1626649&r2=1626650&view=diff
==============================================================================
--- deltaspike/site/trunk/content/documentation/scheduler.html (original)
+++ deltaspike/site/trunk/content/documentation/scheduler.html Sun Sep 21
23:48:24 2014
@@ -7,7 +7,7 @@
<meta name="description" content="deltaspike-generate-pages">
<meta name="author" content="chm">
-<title>Title: Scheduler Module</title>
+<title>Scheduler Module</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,7 +166,7 @@ body {
<div class="row">
<div class="span12">
<div class="page-title">
- <h1>Title: Scheduler Module</h1>
+ <h1>Scheduler Module</h1>
</div>
<div id="toc" class="toc">
@@ -236,10 +236,10 @@ Furthermore, the request- and session-sc
per job-execution. Therefore, the container-control module (of
DeltaSpike) is required. That can be controlled via
<code>@Scheduled#startScopes</code> (possible values: all scopes supported by
the
-container-control module as well as <code>{}</code> for <em>no
scopes</em>).</p>
+container-control module as well as <code>{}</code> for 'no scopes').</p>
</div>
<div class="paragraph">
-<p>With <em>false</em> for <code>@Scheduled#onStartup</code> it’s even
possible to
+<p>With 'false' for <code>@Scheduled#onStartup</code> it’s even possible
to
schedule/install jobs dynamically - e.g.:</p>
</div>
<div class="listingblock">
Modified: deltaspike/site/trunk/content/documentation/source.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/documentation/source.html?rev=1626650&r1=1626649&r2=1626650&view=diff
==============================================================================
--- deltaspike/site/trunk/content/documentation/source.html (original)
+++ deltaspike/site/trunk/content/documentation/source.html Sun Sep 21 23:48:24
2014
@@ -174,7 +174,7 @@ body {
<li><a href="#_introduction">Introduction</a></li>
<li><a href="#_scm_repository">SCM / Repository</a>
<ul class="sectlevel2">
-<li><a href="#_initial_em_checkout_em">Initial <em>checkout</em></a></li>
+<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">
@@ -188,7 +188,7 @@ body {
<li><a href="#_tools_ide">Tools / IDE</a>
<ul class="sectlevel2">
<li><a href="#_intellij">IntelliJ</a></li>
-<li><a href="#eclipse">Eclipse</a></li>
+<li><a href="#_eclipse">Eclipse</a></li>
</ul>
</li>
</ul>
@@ -209,7 +209,7 @@ 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_em_checkout_em">Initial <em>checkout</em></h3>
+<h3 id="_initial_checkout">Initial 'checkout'</h3>
<div class="listingblock">
<div class="content">
<pre>git clone https://git-wip-us.apache.org/repos/asf/deltaspike.git</pre>
@@ -284,7 +284,7 @@ Settings…​</p>
</div>
</div>
<div class="sect2">
-<h3 id="eclipse">Eclipse</h3>
+<h3 id="_eclipse">Eclipse</h3>
<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>
Modified: deltaspike/site/trunk/content/documentation/spi.html
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/documentation/spi.html?rev=1626650&r1=1626649&r2=1626650&view=diff
==============================================================================
--- deltaspike/site/trunk/content/documentation/spi.html (original)
+++ deltaspike/site/trunk/content/documentation/spi.html Sun Sep 21 23:48:24
2014
@@ -212,7 +212,7 @@ case please also <strong>contact us</str
</div>
<div class="paragraph">
<p>To deactivate a class it’s required to implement
<code>ClassDeactivator</code>.
-Returning <em>false</em> or <em>true</em> allows to de-/activate the class in
+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
