You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openwebbeans.apache.org by rm...@apache.org on 2019/02/02 18:15:23 UTC
svn commit: r1039899 [6/6] - in
/websites/production/openwebbeans/content/meecrowave: ./ meecrowave-core/
meecrowave-gradle/ meecrowave-jolokia/ meecrowave-jpa/ meecrowave-jta/
meecrowave-letsencrypt/ meecrowave-maven/ meecrowave-oauth2/ testing/
Modified: websites/production/openwebbeans/content/meecrowave/meecrowave-oauth2/index.html
==============================================================================
--- websites/production/openwebbeans/content/meecrowave/meecrowave-oauth2/index.html (original)
+++ websites/production/openwebbeans/content/meecrowave/meecrowave-oauth2/index.html Sat Feb 2 18:15:22 2019
@@ -66,310 +66,318 @@
<section class="doc-section">
- <div id="preamble">
- <div class="sectionbody">
- <div class="paragraph">
- <p>Starting with version 0.3.0.</p>
- </div>
- <div class="paragraph">
- <p>Coordinates:</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><dependency>
+ <div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>Starting with version 0.3.0.</p>
+</div>
+<div class="paragraph">
+<p>Coordinates:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><dependency>
<groupId>org.apache.meecrowave</groupId>
<artifactId>meecrowave-oauth2</artifactId>
<version>${meecrowave.version}</version>
-</dependency></code></pre>
- </div>
- </div>
- <div class="paragraph">
- <p>A small OAuth2 server based on CXF implementation.</p>
- </div>
- <div class="paragraph">
- <p>See <a href="http://cxf.apache.org/docs/jax-rs-oauth2.html" class="bare">http://cxf.apache.org/docs/jax-rs-oauth2.html</a> for more details.</p>
- </div>
- <div class="paragraph">
- <p>Here is the current configuration (mainly based on CXF one):</p>
- </div>
- <table class="tableblock frame-all grid-all spread table table-bordered">
- <colgroup>
- <col style="width: 50%;">
- <col style="width: 50%;">
- </colgroup>
- <thead>
- <tr>
- <th class="tableblock halign-left valign-top">Name</th>
- <th class="tableblock halign-left valign-top">Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-access-token-lifetime</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">How long an access token is valid, default to 3600s</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-authorization-code-support</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Is authorization code flow supported</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-block-unsecure-requests</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Should unsecured requests be blocked</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-client-force</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Is a client mandatory or can a token be issued without any client</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-default-scopes</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Comma separated list of default scopes</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-encrypted-algorithm</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">The algorithm for the key for the encrypted provider</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-encrypted-key</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">The key for encrypted provider</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-invisible-scopes</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Comma separated list of invisible to client scopes</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jcache-config</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">JCache configuration uri for the cache manager (jcache or provider)</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jcache-jmx</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Should JCache JMX MBeans be enabled</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jcache-loader</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">The loader bean or class name</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jcache-statistics</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Should JCache statistics be enabled</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jcache-store-jwt-token-key-only</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Should JCache store jwt token key only (jcache provider)</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jcache-store-value</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Should JCache store value or not</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jcache-writer</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">The writer bean or class name</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-database-driver</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">JPA database driver for jpa provider</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-database-password</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">JPA database password for jpa provider</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-database-url</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">JPA database url for jpa provider</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-database-username</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">JPA database username for jpa provider</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-max-active</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">JPA max active connections for jpa provider</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-max-idle</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">JPA max idle connections for jpa provider</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-max-wait</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">JPA max wait for connections for jpa provider</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-properties</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">JPA persistence unit properties for jpa provider</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-test-on-borrow</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">should connections be tested on borrow for jpa provider</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-test-on-return</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">should connections be tested on return for jpa provider</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-validation-interval</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">validation interval for jpa provider</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-validation-query</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">validation query for jpa provider</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jwt-access-token-claim-map</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">The jwt claims configuration</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-partial-match-scope-validation</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Is partial match for scope validation activated</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-provider</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Which provider type to use: jcache[-code], jpa[-code], encrypted[-code]</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-redirection-match-redirect-uri-with-application-uri</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">For authorization code flow, should redirect uri be matched with application one</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-redirection-max-default-session-interval</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">For authorization code flow, how long a session can be</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-redirection-scopes-requiring-no-consent</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">For authorization code flow, the scopes using no consent</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-redirection-use-registered-redirect-uri-if-possible</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">For authorization code flow, should the registered uri be used</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-refresh-token</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Is issuing of access token issuing a refreh token too</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-refresh-token-lifetime</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">How long a refresh token is valid, default to eternity (0)</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-refresh-token-recycling</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Should refresh token be recycled</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-required-scopes</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Comma separated list of required scopes</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-support-pre-authorized-tokens</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Are pre-authorized token supported</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-support-public-client</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Are public clients supported</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-token-support</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Are token flows supported</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-use-all-client-scopes</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Are all client scopes used for refresh tokens</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-use-jaas</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Should jaas be used - alternative (default) is to delegate to meecrowave/tomcat realms</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-use-jwt-format-for-access-token</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Should access token be jwt?</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-write-custom-errors</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Should custom errors be written</p></td>
- </tr>
- <tr>
- <td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-write-optional-parameters</p></td>
- <td class="tableblock halign-left valign-top"><p class="tableblock">Should optional parameters be written</p></td>
- </tr>
- </tbody>
- </table>
- <div class="paragraph">
- <p>These options are available through the CLI or through properties as usually with Meecrowave configuration.</p>
- </div>
- <div class="paragraph">
- <p>Note that meecrowave also provides a bundle which is an executable jar to run an OAuth2 server.</p>
- </div>
- <div class="paragraph">
- <p>Here is a sample usage of that bundle:</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">java -jar meecrowave-oauth2-0.3.1-bundle.jar --users test=test --roles test=test</code></pre>
- </div>
- </div>
- <div class="paragraph">
- <p>Then just test your token endpoint:</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -XPOST http://localhost:8080/oauth2/token -d username=test -d password=test -d grant_type=password</code></pre>
- </div>
- </div>
- <div class="paragraph">
- <p>And you should get something like:</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">{
+</dependency></code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>A small OAuth2 server based on CXF implementation.</p>
+</div>
+<div class="paragraph">
+<p>See <a href="http://cxf.apache.org/docs/jax-rs-oauth2.html" class="bare">http://cxf.apache.org/docs/jax-rs-oauth2.html</a> for more details.</p>
+</div>
+<div class="paragraph">
+<p>Here is the current configuration (mainly based on CXF one):</p>
+</div>
+<table class="tableblock frame-all grid-all stretch table table-bordered">
+<colgroup>
+<col style="width: 50%;">
+<col style="width: 50%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Name</th>
+<th class="tableblock halign-left valign-top">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-access-token-lifetime</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">How long an access token is valid, default to 3600s</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-authorization-code-support</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Is authorization code flow supported</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-block-unsecure-requests</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Should unsecured requests be blocked</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-client-force</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Is a client mandatory or can a token be issued without any client</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-default-scopes</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Comma separated list of default scopes</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-encrypted-algorithm</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The algorithm for the key for the encrypted provider</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-encrypted-key</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The key for encrypted provider</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-invisible-scopes</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Comma separated list of invisible to client scopes</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jcache-config</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">JCache configuration uri for the cache manager (jcache or provider)</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jcache-jmx</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Should JCache JMX MBeans be enabled</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jcache-loader</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The loader bean or class name</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jcache-statistics</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Should JCache statistics be enabled</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jcache-store-jwt-token-key-only</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Should JCache store jwt token key only (jcache provider)</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jcache-store-value</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Should JCache store value or not</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jcache-writer</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The writer bean or class name</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-database-driver</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">JPA database driver for jpa provider</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-database-password</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">JPA database password for jpa provider</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-database-url</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">JPA database url for jpa provider</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-database-username</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">JPA database username for jpa provider</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-max-active</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">JPA max active connections for jpa provider</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-max-idle</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">JPA max idle connections for jpa provider</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-max-wait</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">JPA max wait for connections for jpa provider</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-properties</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">JPA persistence unit properties for jpa provider</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-test-on-borrow</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">should connections be tested on borrow for jpa provider</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-test-on-return</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">should connections be tested on return for jpa provider</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-validation-interval</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">validation interval for jpa provider</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jpa-validation-query</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">validation query for jpa provider</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-jwt-access-token-claim-map</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The jwt claims configuration</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-partial-match-scope-validation</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Is partial match for scope validation activated</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-provider</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Which provider type to use: jcache[-code], jpa[-code], encrypted[-code]</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-redirection-match-redirect-uri-with-application-uri</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">For authorization code flow, should redirect uri be matched with application one</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-redirection-max-default-session-interval</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">For authorization code flow, how long a session can be</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-redirection-scopes-requiring-no-consent</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">For authorization code flow, the scopes using no consent</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-redirection-use-registered-redirect-uri-if-possible</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">For authorization code flow, should the registered uri be used</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-refresh-token</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Is issuing of access token issuing a refreh token too</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-refresh-token-lifetime</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">How long a refresh token is valid, default to eternity (0)</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-refresh-token-recycling</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Should refresh token be recycled</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-required-scopes</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Comma separated list of required scopes</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-support-pre-authorized-tokens</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Are pre-authorized token supported</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-support-public-client</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Are public clients supported</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-token-support</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Are token flows supported</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-use-all-client-scopes</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Are all client scopes used for refresh tokens</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-use-jaas</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Should jaas be used - alternative (default) is to delegate to meecrowave/tomcat realms</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-use-jwt-format-for-access-token</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Should access token be jwt?</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-write-custom-errors</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Should custom errors be written</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">--oauth2-write-optional-parameters</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Should optional parameters be written</p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>These options are available through the CLI or through properties as usually with Meecrowave configuration.</p>
+</div>
+<div class="paragraph">
+<p>Note that meecrowave also provides a bundle which is an executable jar to run an OAuth2 server.</p>
+</div>
+<div class="paragraph">
+<p>Here is a sample usage of that bundle:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">java -jar meecrowave-oauth2-0.3.1-bundle.jar --users test=test --roles test=test</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Then just test your token endpoint:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -XPOST http://localhost:8080/oauth2/token -d username=test -d password=test -d grant_type=password</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>And you should get something like:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">{
"access_token":"5e2f211d4b4ccaa36a11d0876597f01e",
"token_type":"Bearer",
"expires_in":3600,
"scope":"refreshToken",
"refresh_token":"7ae5dc2e25925e5514b7e2e632cfa6a"
-}</code></pre>
- </div>
- </div>
- <div class="admonitionblock important">
- <table>
- <tbody>
- <tr>
- <td class="icon"> <i class="fa icon-important" title="Important"></i> </td>
- <td class="content"> these example use inline users but you should configure a realm for a real usage. </td>
- </tr>
- </tbody>
- </table>
- </div>
- <div class="admonitionblock note">
- <table>
- <tbody>
- <tr>
- <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
- <td class="content"> this module is interesting if you plan to base your application development on Meecrowave because it shows how to use CLI configuration and wire it in your application but also how to use a 3rd party library (CXF there) and build a fatjar. </td>
- </tr>
- </tbody>
- </table>
- </div>
- </div>
-</div>
-<div class="sect1">
- <h2 id="_authorization_code_case">Authorization code case</h2>
- <div class="sectionbody">
- <div class="paragraph">
- <p>Authorization code flow is a bit more complicated but services (endpoints) can be activated (see configuration - <code>--oauth2-authorization-code-support</code>).</p>
- </div>
- <div class="paragraph">
- <p>You will need to configure CXF to point to the keystore/key to crypt/sign the token in session. It is properties based. All CXF properties (<code>rs.security.<strong></strong></code><strong>) are supported but prefixed with <code>oauth2.cxf.</code> to avoid to mix it with another configuration starting with <code>rs.</code></strong>.</p>
- </div>
- <div class="paragraph">
- <p>For instance you can use:</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties">oauth2.cxf.rs.security.keystore.type = jks
+}</code></pre>
+</div>
+</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+these example use inline users but you should configure a realm for a real usage.
+</td>
+</tr>
+</table>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+this module is interesting if you plan to base your application development
+on Meecrowave because it shows how to use CLI configuration and wire it in your application
+but also how to use a 3rd party library (CXF there) and build a fatjar.
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_authorization_code_case">Authorization code case</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Authorization code flow is a bit more complicated but services (endpoints) can be activated (see configuration - <code>--oauth2-authorization-code-support</code>).</p>
+</div>
+<div class="paragraph">
+<p>You will need to configure CXF to point to the keystore/key to crypt/sign the token in session.
+It is properties based. All CXF properties (<code>rs.security.<strong></code>) are supported but prefixed with <code>oauth2.cxf.</code> to avoid
+to mix it with another configuration starting with <code>rs.</strong></code>.</p>
+</div>
+<div class="paragraph">
+<p>For instance you can use:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties">oauth2.cxf.rs.security.keystore.type = jks
oauth2.cxf.rs.security.keystore.file = /opt/keystores/oauth2.jks
oauth2.cxf.rs.security.keystore.password = password
oauth2.cxf.rs.security.keystore.alias = alice
-oauth2.cxf.rs.security.key.password = pwd</code></pre>
- </div>
- </div>
- </div>
+oauth2.cxf.rs.security.key.password = pwd</code></pre>
+</div>
+</div>
+</div>
</div>
</section><!--//doc-section-->
Modified: websites/production/openwebbeans/content/meecrowave/meecrowave-oauth2/index.pdf
==============================================================================
--- websites/production/openwebbeans/content/meecrowave/meecrowave-oauth2/index.pdf (original)
+++ websites/production/openwebbeans/content/meecrowave/meecrowave-oauth2/index.pdf Sat Feb 2 18:15:22 2019
@@ -4,8 +4,8 @@
<< /Title (Meecrowave OAuth2)
/Creator (Asciidoctor PDF 1.5.0.alpha.16, based on Prawn 2.2.2)
/Producer (Asciidoctor PDF 1.5.0.alpha.16, based on Prawn 2.2.2)
-/ModDate (D:20171227161737+01'00')
-/CreationDate (D:20190123160053+01'00')
+/ModDate (D:20170827123118+02'00')
+/CreationDate (D:20190202191422+01'00')
>>
endobj
2 0 obj
Modified: websites/production/openwebbeans/content/meecrowave/start.html
==============================================================================
--- websites/production/openwebbeans/content/meecrowave/start.html (original)
+++ websites/production/openwebbeans/content/meecrowave/start.html Sat Feb 2 18:15:22 2019
@@ -66,73 +66,75 @@
<section class="doc-section">
- <div class="sect1">
- <h2 id="_your_first_application">Your first application</h2>
- <div class="sectionbody">
- <div class="paragraph">
- <p>Meecrowave relies on JAX-RS and CDI so to start you just need to write a JAX-RS endpoint:</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Path("kitchen")
+ <div class="sect1">
+<h2 id="_your_first_application">Your first application</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Meecrowave relies on JAX-RS and CDI so to start you just need to write a JAX-RS endpoint:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Path("kitchen")
@ApplicationScoped
public class HelloKitchen {
@GET
public String getMenu() {
return "good things";
}
-}</code></pre>
- </div>
- </div>
- <div class="paragraph">
- <p>Then booting Meecrowave is as easy as launching:</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">try (final Meecrowave meecrowave = new Meecrowave().bake()) {
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Then booting Meecrowave is as easy as launching:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">try (final Meecrowave meecrowave = new Meecrowave().bake()) {
new Scanner(System.in).nextLine();
-}</code></pre>
- </div>
- </div>
- <div class="paragraph">
- <p>You should get some output containing:</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code>[19:54:55.397][INFO][main][.meecrowave.cxf.CxfCdiAutoSetup] REST Application: / -> org.apache.cxf.cdi.DefaultApplication
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You should get some output containing:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code>[19:54:55.397][INFO][main][.meecrowave.cxf.CxfCdiAutoSetup] REST Application: / -> org.apache.cxf.cdi.DefaultApplication
[19:54:55.399][INFO][main][.meecrowave.cxf.CxfCdiAutoSetup] Service URI: /kitchen -> org.app.HelloKitchen
-[19:54:55.401][INFO][main][.meecrowave.cxf.CxfCdiAutoSetup] GET /kitchen/ -> String getMenu()</code></pre>
- </div>
- </div>
- <div class="paragraph">
- <p>And you can check it works doing:</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code>curl http://localhost:8080/kitchen</code></pre>
- </div>
- </div>
- </div>
-</div>
-<div class="sect1">
- <h2 id="_you_re_in_a_hurry_use_groovy">Youâre in a hurry? Use groovy!</h2>
- <div class="sectionbody">
- <div class="admonitionblock important">
- <table>
- <tbody>
- <tr>
- <td class="icon"> <i class="fa icon-important" title="Important"></i> </td>
- <td class="content"> this feature is supported starting from version 0.3.0 only. </td>
- </tr>
- </tbody>
- </table>
- </div>
- <div class="paragraph">
- <p>Create a file called <code>hello.groovy</code>:</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Grab('org.apache.meecrowave:meecrowave-core:0.3.0')
+[19:54:55.401][INFO][main][.meecrowave.cxf.CxfCdiAutoSetup] GET /kitchen/ -> String getMenu()</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>And you can check it works doing:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code>curl http://localhost:8080/kitchen</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_youre_in_a_hurry_use_groovy">You’re in a hurry? Use groovy!</h2>
+<div class="sectionbody">
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
+this feature is supported starting from version 0.3.0 only.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Create a file called <code>hello.groovy</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Grab('org.apache.meecrowave:meecrowave-core:0.3.0')
import org.apache.meecrowave.Meecrowave
@@ -149,42 +151,42 @@ class Hello {
}
}
-new Meecrowave().bake().await()</code></pre>
- </div>
- </div>
- <div class="paragraph">
- <p>then</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">groovy hello.groovy</code></pre>
- </div>
- </div>
- <div class="paragraph">
- <p>Finally you can test it:</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl http://localhost:8080/hello</code></pre>
- </div>
- </div>
- </div>
-</div>
-<div class="sect1">
- <h2 id="_and_my_war">And my war?</h2>
- <div class="sectionbody">
- <div class="paragraph">
- <p>See <a href="meecrowave-core/deploy-webapp.html">How to deploy a war</a> to see how to use meecrowave to deploy an existing war.</p>
- </div>
- </div>
-</div>
-<div class="sect1">
- <h2 id="_sample">Sample</h2>
- <div class="sectionbody">
- <div class="paragraph">
- <p><a href="https://github.com/apache/openwebbeans-meecrowave-examples" class="bare">https://github.com/apache/openwebbeans-meecrowave-examples</a> contains ready to use examples using meecrowave.</p>
- </div>
- </div>
+new Meecrowave().bake().await()</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>then</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">groovy hello.groovy</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Finally you can test it:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl http://localhost:8080/hello</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_and_my_war">And my war?</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>See <a href="meecrowave-core/deploy-webapp.html">How to deploy a war</a> to see how to use meecrowave to deploy an existing war.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_sample">Sample</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p><a href="https://github.com/apache/openwebbeans-meecrowave-examples" class="bare">https://github.com/apache/openwebbeans-meecrowave-examples</a> contains ready to use examples using meecrowave.</p>
+</div>
+</div>
</div>
</section><!--//doc-section-->
Modified: websites/production/openwebbeans/content/meecrowave/start.pdf
==============================================================================
--- websites/production/openwebbeans/content/meecrowave/start.pdf (original)
+++ websites/production/openwebbeans/content/meecrowave/start.pdf Sat Feb 2 18:15:22 2019
@@ -4,8 +4,8 @@
<< /Title (Quick start)
/Creator (Asciidoctor PDF 1.5.0.alpha.16, based on Prawn 2.2.2)
/Producer (Asciidoctor PDF 1.5.0.alpha.16, based on Prawn 2.2.2)
-/ModDate (D:20190123160018+01'00')
-/CreationDate (D:20190123160053+01'00')
+/ModDate (D:20190125064905+01'00')
+/CreationDate (D:20190202191422+01'00')
>>
endobj
2 0 obj
@@ -1282,7 +1282,7 @@ endobj
>>
endobj
13 0 obj
-<< /Names [(__anchor-top) 11 0 R (_and_my_war) 21 0 R (_sample) 23 0 R (_you_re_in_a_hurry_use_groovy) 17 0 R (_your_first_application) 14 0 R]
+<< /Names [(__anchor-top) 11 0 R (_and_my_war) 21 0 R (_sample) 23 0 R (_your_first_application) 14 0 R (_youre_in_a_hurry_use_groovy) 17 0 R]
>>
endobj
14 0 obj
@@ -2594,47 +2594,47 @@ xref
0000016561 00000 n
0000016605 00000 n
0000016654 00000 n
-0000016817 00000 n
-0000016861 00000 n
-0000017031 00000 n
-0000017203 00000 n
-0000017247 00000 n
-0000017414 00000 n
-0000028249 00000 n
-0000028627 00000 n
-0000028671 00000 n
-0000028848 00000 n
-0000028892 00000 n
-0000029092 00000 n
-0000029362 00000 n
-0000029632 00000 n
-0000029706 00000 n
-0000029856 00000 n
-0000030064 00000 n
-0000030304 00000 n
-0000030468 00000 n
-0000030599 00000 n
-0000030674 00000 n
-0000036655 00000 n
-0000036869 00000 n
-0000038231 00000 n
-0000039322 00000 n
-0000043722 00000 n
-0000043941 00000 n
-0000045303 00000 n
-0000046413 00000 n
-0000051237 00000 n
-0000051449 00000 n
-0000052811 00000 n
-0000053881 00000 n
-0000054876 00000 n
-0000055083 00000 n
-0000055385 00000 n
+0000016816 00000 n
+0000016860 00000 n
+0000017030 00000 n
+0000017202 00000 n
+0000017246 00000 n
+0000017413 00000 n
+0000028248 00000 n
+0000028626 00000 n
+0000028670 00000 n
+0000028847 00000 n
+0000028891 00000 n
+0000029091 00000 n
+0000029361 00000 n
+0000029631 00000 n
+0000029705 00000 n
+0000029855 00000 n
+0000030063 00000 n
+0000030303 00000 n
+0000030467 00000 n
+0000030598 00000 n
+0000030673 00000 n
+0000036654 00000 n
+0000036868 00000 n
+0000038230 00000 n
+0000039321 00000 n
+0000043721 00000 n
+0000043940 00000 n
+0000045302 00000 n
+0000046412 00000 n
+0000051236 00000 n
+0000051448 00000 n
+0000052810 00000 n
+0000053880 00000 n
+0000054875 00000 n
+0000055082 00000 n
+0000055384 00000 n
trailer
<< /Size 50
/Root 2 0 R
/Info 1 0 R
>>
startxref
-56299
+56298
%%EOF
Modified: websites/production/openwebbeans/content/meecrowave/testing/index.html
==============================================================================
--- websites/production/openwebbeans/content/meecrowave/testing/index.html (original)
+++ websites/production/openwebbeans/content/meecrowave/testing/index.html Sat Feb 2 18:15:22 2019
@@ -66,32 +66,34 @@
<section class="doc-section">
- <div class="sect1">
- <h2 id="_junit">JUnit</h2>
- <div class="sectionbody">
- <div class="paragraph">
- <p>Coordinates:</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><dependency>
+ <div class="sect1">
+<h2 id="_junit">JUnit</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Coordinates:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><dependency>
<groupId>org.apache.meecrowave</groupId>
<artifactId>meecrowave-junit</artifactId>
<version>${meecrowave.version}</version>
-</dependency></code></pre>
- </div>
- </div>
- <div class="sect2">
- <h3 id="_rules_and_runners">Rules and Runners</h3>
- <div class="paragraph">
- <p>Meecrowave provides two flavors of JUnit integration: standalone or runners/rules. The standalone one will ensure there is a single container for the whole JVM. It also fits standalone environments where you want to control the lifecycle. The other one will follow the JUnit lifecycle (per class or test rule).</p>
- </div>
- <div class="paragraph">
- <p>Here how to use the standalone flavor:</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(MonoMeecrowave.Runner.class)
+</dependency></code></pre>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_rules_and_runners">Rules and Runners</h3>
+<div class="paragraph">
+<p>Meecrowave provides two flavors of JUnit integration: standalone or runners/rules. The standalone one will
+ensure there is a single container for the whole JVM. It also fits standalone environments where you want to control the lifecycle.
+The other one will follow the JUnit lifecycle (per class or test rule).</p>
+</div>
+<div class="paragraph">
+<p>Here how to use the standalone flavor:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@RunWith(MonoMeecrowave.Runner.class)
public class MonoMeecrowaveRuleTest {
/* or
@ClassRule
@@ -105,21 +107,23 @@ public class MonoMeecrowaveRuleTest {
public void test() throws IOException {
// use "http://localhost:" + config.getHttpPort()
}
-}</code></pre>
- </div>
- </div>
- <div class="paragraph">
- <p>When using the standalone, <code>@MonoMeecrowave.Runner.ConfigurationInject</code> allows to still access the configuration and random HTTP port.</p>
- </div>
- <div class="paragraph">
- <p>For the configuration, the standalone runner will use a global configuration shared by all tests. To load it it will use a standard <code>ServiceLoader</code> on type <code>org.apache.meecrowave.Meecrowave$ConfigurationCustomizer</code>.</p>
- </div>
- <div class="paragraph">
- <p>And here is the one bound to the JUnit lifecycle</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">public class MeecrowaveRuleTest {
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>When using the standalone, <code>@MonoMeecrowave.Runner.ConfigurationInject</code> allows to still
+access the configuration and random HTTP port.</p>
+</div>
+<div class="paragraph">
+<p>For the configuration, the standalone runner will use a global configuration shared by all tests. To load it
+it will use a standard <code>ServiceLoader</code> on type <code>org.apache.meecrowave.Meecrowave$ConfigurationCustomizer</code>.</p>
+</div>
+<div class="paragraph">
+<p>And here is the one bound to the JUnit lifecycle</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">public class MeecrowaveRuleTest {
@ClassRule // started once for the class, @Rule would be per method
public static final MeecrowaveRule RULE = new MeecrowaveRule();
@@ -127,24 +131,27 @@ public class MonoMeecrowaveRuleTest {
public void test() throws IOException {
// use "http://localhost:" + RULE.getConfiguration().getHttpPort()
}
-}</code></pre>
- </div>
- </div>
- <div class="paragraph">
- <p>As usual with JUnit rules, you can decide whereas the Meecrowave instance is bound to the entire test class or a method by using @ClassRule or @Rule.</p>
- </div>
- </div>
- <div class="sect2">
- <h3 id="_junit_5">JUnit 5</h3>
- <div class="paragraph">
- <p>JUnit 5 integrates a new <code>Extension</code> system. It is not yet very well supported by IDEs but you can already use it with Gradle and Maven (see <a href="http://junit.org/junit5/docs/current/user-guide/#running-tests" class="bare">http://junit.org/junit5/docs/current/user-guide/#running-tests</a>).</p>
- </div>
- <div class="paragraph">
- <p>The usage has two annotations: <code>@MeecrowaveConfig</code> which remaps most of the configuration of Meecrowave and <code>@MonoMeecrowaveConfig</code> which is close to <code>MonoMeecrowave.Runner</code> in term of usage.</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@MeecrowaveConfig /*(some config)*/
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>As usual with JUnit rules, you can decide whereas the Meecrowave instance is bound to the entire test class
+or a method by using @ClassRule or @Rule.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_junit_5">JUnit 5</h3>
+<div class="paragraph">
+<p>JUnit 5 integrates a new <code>Extension</code> system. It is not yet very well supported by IDEs but you can already use it with
+Gradle and Maven (see <a href="http://junit.org/junit5/docs/current/user-guide/#running-tests" class="bare">http://junit.org/junit5/docs/current/user-guide/#running-tests</a>).</p>
+</div>
+<div class="paragraph">
+<p>The usage has two annotations: <code>@MeecrowaveConfig</code> which remaps most of the configuration of Meecrowave and <code>@MonoMeecrowaveConfig</code>
+which is close to <code>MonoMeecrowave.Runner</code> in term of usage.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@MeecrowaveConfig /*(some config)*/
public class MeecrowaveConfigTest {
@ConfigurationInject
private Meecrowave.Builder config;
@@ -154,57 +161,61 @@ public class MeecrowaveConfigTest {
final String base = "http://localhost:" + config.getHttpPort();
// asserts
}
-}</code></pre>
- </div>
- </div>
- <div class="paragraph">
- <p>Or</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@MonoMeecrowaveConfig
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Or</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@MonoMeecrowaveConfig
public class MeecrowaveConfigTest {
// ...
-}</code></pre>
- </div>
- </div>
- <div class="admonitionblock tip">
- <table>
- <tbody>
- <tr>
- <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td>
- <td class="content"> JUnit 5 integration provides an <code>@AfterFirstInjection</code> method and <code>@AfterLastTest</code> which can be used to setup/reset some environment using injections once for a set of test methods. The methods must not have any parameter. </td>
- </tr>
- </tbody>
- </table>
- </div>
- </div>
- </div>
-</div>
-<div class="sect1">
- <h2 id="_arquillian_container">Arquillian Container</h2>
- <div class="sectionbody">
- <div class="paragraph">
- <p>Container dependency:</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><dependency>
+}</code></pre>
+</div>
+</div>
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
+JUnit 5 integration provides an <code>@AfterFirstInjection</code> method and <code>@AfterLastTest</code>
+which can be used to setup/reset some environment using injections once for a set of test methods.
+The methods must not have any parameter.
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_arquillian_container">Arquillian Container</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Container dependency:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><dependency>
<groupId>org.apache.meecrowave</groupId>
<artifactId>meecrowave-arquillian</artifactId>
<version>${meecrowave.version}</version>
-</dependency></code></pre>
- </div>
- </div>
- <div class="paragraph">
- <p>For the configuration check <a href="/meecrowave/meecrowave-core/configuration.html">Core configuration</a>.</p>
- </div>
- <div class="paragraph">
- <p>Here is a sample:</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><?xml version="1.0" encoding="UTF-8"?>
+</dependency></code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>For the configuration check <a href="/meecrowave/meecrowave-core/configuration.html">Core configuration</a>.</p>
+</div>
+<div class="paragraph">
+<p>Here is a sample:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<arquillian xmlns="http://jboss.org/schema/arquillian"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://jboss.org/schema/arquillian http://jboss.org/schema/arquillian/arquillian_1_0.xsd">
@@ -274,7 +285,7 @@ public class MeecrowaveConfigTest {
<property name="ssl">false</property>
<property name="sslProtocol"></property>
<property name="stopPort">-1</property>
- <property name="tempDir">/tmp/meecrowave_1838634382589715</property>
+ <property name="tempDir">/tmp/meecrowave_7260055997980</property>
<property name="tomcatAccessLogPattern"></property>
<property name="tomcatAutoSetup">true</property>
<property name="tomcatFilter"></property>
@@ -295,10 +306,10 @@ public class MeecrowaveConfigTest {
<property name="webXml"></property>
</configuration>
</container>
-</arquillian></code></pre>
- </div>
- </div>
- </div>
+</arquillian></code></pre>
+</div>
+</div>
+</div>
</div>
</section><!--//doc-section-->
Modified: websites/production/openwebbeans/content/meecrowave/testing/index.pdf
==============================================================================
--- websites/production/openwebbeans/content/meecrowave/testing/index.pdf (original)
+++ websites/production/openwebbeans/content/meecrowave/testing/index.pdf Sat Feb 2 18:15:22 2019
@@ -4,8 +4,8 @@
<< /Title (Meecrowave Testing)
/Creator (Asciidoctor PDF 1.5.0.alpha.16, based on Prawn 2.2.2)
/Producer (Asciidoctor PDF 1.5.0.alpha.16, based on Prawn 2.2.2)
-/ModDate (D:20180905120213+02'00')
-/CreationDate (D:20190123160053+01'00')
+/ModDate (D:20180904224110+02'00')
+/CreationDate (D:20190202191422+01'00')
>>
endobj
2 0 obj
@@ -7023,7 +7023,7 @@ endobj
>>
endobj
28 0 obj
-<< /Length 57720
+<< /Length 57714
>>
stream
q
@@ -10778,7 +10778,7 @@ ET
BT
229.74 221.57 Td
/F3.0 11 Tf
-<2f746d702f6d656563726f776176655f31383338363334333832353839373135> Tj
+<2f746d702f6d656563726f776176655f37323630303535393937393830> Tj
ET
0.0 0.0 0.0 SCN
@@ -10787,7 +10787,7 @@ ET
0.1843 0.4353 0.6235 SCN
BT
-405.74 221.57 Td
+389.24 221.57 Td
/F3.0 11 Tf
<3c2f70726f70657274793e> Tj
ET
@@ -13113,39 +13113,39 @@ xref
0000084512 00000 n
0000084556 00000 n
0000084777 00000 n
-0000142551 00000 n
-0000142892 00000 n
-0000150301 00000 n
-0000150642 00000 n
-0000150912 00000 n
-0000151182 00000 n
-0000151256 00000 n
-0000151434 00000 n
-0000151601 00000 n
-0000151776 00000 n
-0000151911 00000 n
-0000152098 00000 n
-0000152218 00000 n
-0000158834 00000 n
-0000159048 00000 n
-0000160410 00000 n
-0000161494 00000 n
-0000164855 00000 n
-0000165074 00000 n
-0000166436 00000 n
-0000167555 00000 n
-0000173214 00000 n
-0000173426 00000 n
-0000174788 00000 n
-0000175843 00000 n
-0000176945 00000 n
-0000177152 00000 n
-0000177452 00000 n
+0000142545 00000 n
+0000142886 00000 n
+0000150295 00000 n
+0000150636 00000 n
+0000150906 00000 n
+0000151176 00000 n
+0000151250 00000 n
+0000151428 00000 n
+0000151595 00000 n
+0000151770 00000 n
+0000151905 00000 n
+0000152092 00000 n
+0000152212 00000 n
+0000158828 00000 n
+0000159042 00000 n
+0000160404 00000 n
+0000161488 00000 n
+0000164849 00000 n
+0000165068 00000 n
+0000166430 00000 n
+0000167549 00000 n
+0000173208 00000 n
+0000173420 00000 n
+0000174782 00000 n
+0000175837 00000 n
+0000176939 00000 n
+0000177146 00000 n
+0000177446 00000 n
trailer
<< /Size 57
/Root 2 0 R
/Info 1 0 R
>>
startxref
-178366
+178360
%%EOF