deltaspike-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r1023218 - in /websites/staging/deltaspike/trunk/content: ./ documentation/build.html documentation/configure.html documentation/core.html documentation/scheduler.html documentation/snapshots.html documentation/test-control.html
Date Wed, 03 Jan 2018 18:02:19 GMT
Author: buildbot
Date: Wed Jan  3 18:02:19 2018
New Revision: 1023218

Log:
Staging update by buildbot for deltaspike

Modified:
    websites/staging/deltaspike/trunk/content/   (props changed)
    websites/staging/deltaspike/trunk/content/documentation/build.html
    websites/staging/deltaspike/trunk/content/documentation/configure.html
    websites/staging/deltaspike/trunk/content/documentation/core.html
    websites/staging/deltaspike/trunk/content/documentation/scheduler.html
    websites/staging/deltaspike/trunk/content/documentation/snapshots.html
    websites/staging/deltaspike/trunk/content/documentation/test-control.html

Propchange: websites/staging/deltaspike/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Jan  3 18:02:19 2018
@@ -1 +1 @@
-1797503
+1819992

Modified: websites/staging/deltaspike/trunk/content/documentation/build.html
==============================================================================
--- websites/staging/deltaspike/trunk/content/documentation/build.html (original)
+++ websites/staging/deltaspike/trunk/content/documentation/build.html Wed Jan  3 18:02:19
2018
@@ -277,7 +277,7 @@ table.CodeRay td.code>pre{padding:0}
 <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</a>
<code>deltaspike-project-1.8.0-source-release.zip</code> 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-1.8.1-source-release.zip</code> and extract the contents.</p>
 </div>
 <div class="admonitionblock note">
 <table>
@@ -301,7 +301,7 @@ You can also obtain the DeltaSpike sourc
 </div>
 <div class="listingblock">
 <div class="content">
-<pre class="CodeRay highlight"><code data-lang="shell">$ cd /path/to/deltaspike-project-1.8.0/
+<pre class="CodeRay highlight"><code data-lang="shell">$ cd /path/to/deltaspike-project-1.8.1/
 $ mvn clean install</code></pre>
 </div>
 </div>

Modified: websites/staging/deltaspike/trunk/content/documentation/configure.html
==============================================================================
--- websites/staging/deltaspike/trunk/content/documentation/configure.html (original)
+++ websites/staging/deltaspike/trunk/content/documentation/configure.html Wed Jan  3 18:02:19
2018
@@ -309,7 +309,7 @@ You can also opt to use the lastest Delt
 <div class="listingblock">
 <div class="content">
 <pre class="CodeRay highlight"><code data-lang="xml"><span class="tag">&lt;properties&gt;</span>
-    <span class="tag">&lt;deltaspike.version&gt;</span>1.8.0<span
class="tag">&lt;/deltaspike.version&gt;</span>
+    <span class="tag">&lt;deltaspike.version&gt;</span>1.8.1<span
class="tag">&lt;/deltaspike.version&gt;</span>
 <span class="tag">&lt;/properties&gt;</span></code></pre>
 </div>
 </div>
@@ -418,7 +418,7 @@ repositories {
 }
 dependencyManagement {
     imports {
-        mavenBom 'org.apache.deltaspike.distribution:distributions-bom:1.8.0'
+        mavenBom 'org.apache.deltaspike.distribution:distributions-bom:1.8.1'
     }
 }
 dependencies {

Modified: websites/staging/deltaspike/trunk/content/documentation/core.html
==============================================================================
--- websites/staging/deltaspike/trunk/content/documentation/core.html (original)
+++ websites/staging/deltaspike/trunk/content/documentation/core.html Wed Jan  3 18:02:19
2018
@@ -1785,6 +1785,106 @@ The following example shows how it would
 </div>
 </div>
 <div class="sect1">
+<h2 id="__futureable_configuration">@Futureable configuration</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The strategy to find the <code>ExecutorService</code> associated to
the <code>@Futureable</code> name is the following one:</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Check if there is a CDI bean of type <code>ExecutorService</code> with
the name of the pool, if not try 2</p>
+</li>
+<li>
+<p>Check if there is a JNDI entry matching the pool name directly or prefixed with
<code>java:app/</code>, <code>java:global/</code>, <code>java:global/threads/</code>,
<code>java:global/deltaspike/</code>, <code>java:</code>, if not try
3</p>
+</li>
+<li>
+<p>Read the configuration and create a <code>ThreadPoolExecutor</code></p>
+</li>
+</ol>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+the instance is looked up only once so from the first time it was read you can&#8217;t
change any configuration anymore.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>If you rely on the last option (configured executor) here are the keys you can set
in DeltaSpike configuration:</p>
+</div>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 33%;">
+<col style="width: 33%;">
+<col style="width: 33%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Key</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Description</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Default</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">futurable.pool.&lt;pool
name&gt;.coreSize</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The core
size of the pool.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number of
available processors</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">futurable.pool.&lt;pool
name&gt;.maxSize</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The max size
of the pool.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">coreSize
value</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">futurable.pool.&lt;pool
name&gt;.keepAlive.value</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Pool keep
alive (when a thread is released).</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">0</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">futurable.pool.&lt;pool
name&gt;.keepAlive.unit</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Unit of keepAlive.value.
It must match a <code>TIMEUNIT</code> name.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">MILLISECONDS</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">futurable.pool.&lt;pool
name&gt;.queue.type</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The task
queue type of the executor. Can be <code>ARRAY</code> to use an <code>ArrayBlockingQueue</code>,
<code>LINKED</code> for a <code>LinkedBlockingQueue</code> or <code>SYNCHRONOUS</code>
for a <code>SynchronousQueue</code>.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">LINKED</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">futurable.pool.&lt;pool
name&gt;.queue.fair</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">For synchronous
and array queue types, if the queue is fair.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">false</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">futurable.pool.&lt;pool
name&gt;.queue.size</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">For array
queue type, the size of the queue.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">1024</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">futurable.pool.&lt;pool
name&gt;.queue.capacity</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">For linked
queue type, the capacity of the queue.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Integer.MAX_VALUE</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">futurable.pool.&lt;pool
name&gt;.threadFactory.name</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">If set a
CDI bean matching the value will be looked up and used as <code>ThreadFactory</code>.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">none, <code>Executors.defaultThreadFactory()</code>
is used</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">futurable.pool.&lt;pool
name&gt;.rejectedExecutionHandler.name</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">If set a
CDI bean matching the value will be looked up and used as <code>RejectedExecutionHandler</code>.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">none, <code>ThreadPoolExecutor.AbortPolicy</code>
is used</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+<div class="sect1">
 <h2 id="_utilities">Utilities</h2>
 <div class="sectionbody">
 <div class="paragraph">
@@ -2043,6 +2143,7 @@ objects, the last object in the array wi
 </ul>
 </li>
 <li><a href="#_asynchronous_operations">Asynchronous Operations</a></li>
+<li><a href="#__futureable_configuration">@Futureable configuration</a></li>
 <li><a href="#_utilities">Utilities</a>
 <ul class="sectlevel2">
 <li><a href="#_annotationutils">AnnotationUtils</a></li>

Modified: websites/staging/deltaspike/trunk/content/documentation/scheduler.html
==============================================================================
--- websites/staging/deltaspike/trunk/content/documentation/scheduler.html (original)
+++ websites/staging/deltaspike/trunk/content/documentation/scheduler.html Wed Jan  3 18:02:19
2018
@@ -609,7 +609,7 @@ Such an adapter just needs to implement
 <div class="sectionbody">
 <div class="paragraph">
 <p>It is possible to replace the default integration with Quartz. Any scheduler that
supports cron-expressions for job-classes can be used.
-For more information, see <a href="https://deltaspike.apache.org/javadoc/1.8.0/org/apache/deltaspike/scheduler/spi/Scheduler.html">Scheduler
javadoc</a>.</p>
+For more information, see <a href="https://deltaspike.apache.org/javadoc/1.8.1/org/apache/deltaspike/scheduler/spi/Scheduler.html">Scheduler
javadoc</a>.</p>
 </div>
 </div>
 </div>

Modified: websites/staging/deltaspike/trunk/content/documentation/snapshots.html
==============================================================================
--- websites/staging/deltaspike/trunk/content/documentation/snapshots.html (original)
+++ websites/staging/deltaspike/trunk/content/documentation/snapshots.html Wed Jan  3 18:02:19
2018
@@ -343,7 +343,7 @@ Snapshots provide previews of DeltaSpike
 <div class="listingblock">
 <div class="content">
 <pre class="CodeRay highlight"><code data-lang="xml"><span class="tag">&lt;properties&gt;</span>
-    <span class="tag">&lt;deltaspike.version&gt;</span>1.8.1-SNAPSHOT<span
class="tag">&lt;/deltaspike.version&gt;</span>
+    <span class="tag">&lt;deltaspike.version&gt;</span>1.8.2-SNAPSHOT<span
class="tag">&lt;/deltaspike.version&gt;</span>
 <span class="tag">&lt;/properties&gt;</span></code></pre>
 </div>
 </div>

Modified: websites/staging/deltaspike/trunk/content/documentation/test-control.html
==============================================================================
--- websites/staging/deltaspike/trunk/content/documentation/test-control.html (original)
+++ websites/staging/deltaspike/trunk/content/documentation/test-control.html Wed Jan  3 18:02:19
2018
@@ -956,6 +956,31 @@ jar {
 <h2 id="_spi">SPI</h2>
 <div class="sectionbody">
 <div class="sect2">
+<h3 id="_mockfilter">MockFilter</h3>
+<div class="paragraph">
+<p>Please make sure that you are aware of <a href="#__MockFrameworks">Integration
of Mock Frameworks</a> before you continue with this section.</p>
+</div>
+<div class="paragraph">
+<p>If you would like to exclude some parts of your application- and/or test-code
+so that they aren’t eligible for the mocking mechanism,
+you can provide an own implementation of <code>org.apache.deltaspike.testcontrol.spi.mock.MockFilter</code>
and
+register it in <code>/META-INF/services/org.apache.deltaspike.testcontrol.spi.mock.MockFilter</code>.</p>
+</div>
+<div class="paragraph">
+<p>That&#8217;s quite special and you need to know the CDI-SPI a bit.
+To get an idea about the required steps, you can have a look at the default implementation
used by DeltaSpike-Test itself.</p>
+</div>
+<div class="paragraph">
+<p>Such a filter is also needed in case you would like to customize DeltaSpike-Test.
+For example to provide an <code>@Alternative</code> implementation for DynamicMockManager,
+you need to implement <code>org.apache.deltaspike.testcontrol.api.mock.DynamicMockManager</code>,
annotate it with <code>@Alternative</code>,
+ensure that you keep the type-information with <code>@Typed</code>,
+configure the alternative bean in <code>/META-INF/beans.xml</code> (in the test-classpath)
and
+provide a custom <code>MockFilter</code> (as described above) which excludes
the custom mock-manager.
+(Otherwise DeltaSpike-Test will try to mock the custom mock-manager.)</p>
+</div>
+</div>
+<div class="sect2">
 <h3 id="_externalcontainer">ExternalContainer</h3>
 <div class="paragraph">
 <p>org.apache.deltaspike.testcontrol.spi.ExternalContainer allows to
@@ -1053,6 +1078,7 @@ Currently DeltaSpike provides:</p>
 </li>
 <li><a href="#_spi">SPI</a>
 <ul class="sectlevel2">
+<li><a href="#_mockfilter">MockFilter</a></li>
 <li><a href="#_externalcontainer">ExternalContainer</a></li>
 </ul>
 </li>



Mime
View raw message