svn commit: r1794542 - in /deltaspike/site/trunk/content/documentation: configuration.html data.html

[johndament]

Author: johndament
Date: Tue May  9 11:36:19 2017
New Revision: 1794542

URL: http://svn.apache.org/viewvc?rev=1794542&view=rev
Log:
Site checkin for project Apache DeltaSpike Documentation

Modified:
    deltaspike/site/trunk/content/documentation/configuration.html
    deltaspike/site/trunk/content/documentation/data.html

Modified: deltaspike/site/trunk/content/documentation/configuration.html
URL: 
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/documentation/configuration.html?rev=1794542&r1=1794541&r2=1794542&view=diff
==============================================================================
--- deltaspike/site/trunk/content/documentation/configuration.html (original)
+++ deltaspike/site/trunk/content/documentation/configuration.html Tue May  9 
11:36:19 2017
@@ -635,6 +635,27 @@ If you use different <code>TypedResolver
 </table>
 </div>
 </div>
+<div class="sect3">
+<h4 id="_list_values_handling">List Values handling</h4>
+<div class="paragraph">
+<p>As of DeltaSpike-1.8.0, the <code>Typed Resolver</code> is also able to 
handle list values.
+Resolve a list of e.g. retry interval values via:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span 
class="predefined-type">List</span>&lt;<span 
class="predefined-type">Integer</span>&gt; retryIntervals
+    = ConfigResolver.resolve(<span class="string"><span 
class="delimiter">&quot;</span><span 
class="content">myapp.retry.intervalls</span><span 
class="delimiter">&quot;</span></span>)
+        .as(<span class="predefined-type">Integer</span>.class)
+        .asList()
+        .getValue();</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The values get configured as comma (<code>','</code>) separated value 
String.
+A Comma inside a value can be escaped with a backslash (<code>\,</code>), 
backslashes should be escaped with double-backslash (<code>\\</code>).
+Trailing and leading whitespaces get trimmed for each value.</p>
+</div>
+</div>
 </div>
 <div class="sect2">
 <h3 
id="_injection_of_configured_values_into_beans_using_configproperty">Injection 
of configured values into beans using @ConfigProperty</h3>
@@ -981,6 +1002,10 @@ classpath to get picked up as ConfigSour
 class which implements the <code>PropertyFileConfig</code> interface.</p>
 </div>
 <div class="paragraph">
+<p>If <code>getPropertyFileName()</code> returns an URL, e.g. <code><a 
href="file:///var/opt/myapp/my.properties"" 
class="bare">file:///var/opt/myapp/my.properties"</a></code> then this will be 
used to pick up the configured values.
+In other words: with using <code>file://</code> you can specify a file on the 
file system.</p>
+</div>
+<div class="paragraph">
 <p>The method <code>isOptional</code> indicates whether your custom property 
file is mandatory.
 If a mandatory property file is not found during deployment, DeltaSpike throws
 an <code>IllegalStateException</code> and stops the deployment.</p>
@@ -1114,6 +1139,7 @@ you can&#8217;t use this source in an <c
 <ul class="sectlevel3">
 <li><a href="#_supported_types">Supported types</a></li>
 <li><a href="#_dynamic_reloading">Dynamic Reloading</a></li>
+<li><a href="#_list_values_handling">List Values handling</a></li>
 </ul>
 </li>
 <li><a 
href="#_injection_of_configured_values_into_beans_using_configproperty">Injection
 of configured values into beans using @ConfigProperty</a>

Modified: deltaspike/site/trunk/content/documentation/data.html
URL: 
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/documentation/data.html?rev=1794542&r1=1794541&r2=1794542&view=diff
==============================================================================
--- deltaspike/site/trunk/content/documentation/data.html (original)
+++ deltaspike/site/trunk/content/documentation/data.html Tue May  9 11:36:19 
2017
@@ -815,7 +815,7 @@ generate the query implementation out of
 </div>
 <div class="listingblock">
 <div class="content">
-<pre>(Entity|List&lt;Entity&gt;) (prefix)(Property[Comparator]){Operator 
Property [Comparator]}</pre>
+<pre>(Entity|Optional&lt;Entity&gt;|List&lt;Entity&gt;|Stream&lt;Entity&gt;) 
(prefix)(Property[Comparator]){Operator Property [Comparator]}</pre>
 </div>
 </div>
 <div class="paragraph">