You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openwebbeans.apache.org by bu...@apache.org on 2018/07/06 08:51:57 UTC
svn commit: r1032163 [3/5] - in
/websites/staging/openwebbeans/trunk/content: ./ meecrowave/
meecrowave/meecrowave-core/ meecrowave/meecrowave-gradle/
meecrowave/meecrowave-jolokia/ meecrowave/meecrowave-jpa/
meecrowave/meecrowave-jta/ meecrowave/meecr...
Modified: websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-core/configuration.html
==============================================================================
--- websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-core/configuration.html (original)
+++ websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-core/configuration.html Fri Jul 6 08:51:56 2018
@@ -47,7 +47,7 @@
<div class="doc-wrapper">
<div class="container">
<div id="doc-header" class="doc-header text-center">
- <h1 class="doc-title"><span aria-hidden="true" class="icon icon_lifesaver"></span> Meecrowave Configuration</h1>
+ <h1 class="doc-title"><span aria-hidden="true" class="icon icon icon_puzzle_alt"></span> Meecrowave Configuration</h1>
</div><!--//doc-header-->
<div class="doc-body">
@@ -66,327 +66,339 @@
<section class="doc-section">
- <div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>Meecrowave configuration is centralized in <code>org.apache.meecrowave.Meecrowave$Builder</code> class.</p>
-</div>
-<div class="paragraph">
-<p>Here are the main properties:</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">cdiConversation</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should CDI conversation be activated</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">clientAuth</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">HTTPS keystore client authentication</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">conf</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Conf folder to synchronize</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">connectors</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Custom connectors</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">cxfServletParams</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Init parameters passed to CXF servlet</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">deleteBaseOnStartup</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should the directory be cleaned on startup if existing</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">dir</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Root folder if provided otherwise a fake one is created in tmp-dir</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">host</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Default host</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">http2</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Activate HTTP 2</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">httpPort</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">HTTP port</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">httpsPort</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">HTTPS port</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">injectServletContainerInitializer</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should ServletContainerInitialize support injections.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jaxrsAutoActivateBeanValidation</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should bean validation be activated on JAX-RS endpoint if present in the classpath.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jaxrsDefaultProviders</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">If jaxrsProviderSetup is true the list of default providers to load (or defaulting to johnson jsonb and jsonp ones)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jaxrsLogProviders</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should JAX-RS providers be logged</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jaxrsMapping</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Default jaxrs mapping</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jaxrsProviderSetup</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should default JAX-RS provider be configured</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jaxwsSupportIfAvailable</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should @WebService CDI beans be deployed if cxf-rt-frontend-jaxws is in the classpath.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jsonbBinaryStrategy</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should JSON-B provider prettify the output</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jsonbEncoding</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Which encoding provider JSON-B should use</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jsonbIJson</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should JSON-B provider comply to I-JSON</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jsonbNamingStrategy</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should JSON-B provider prettify the output</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jsonbNulls</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should JSON-B provider serialize nulls</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jsonbOrderStrategy</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should JSON-B provider prettify the output</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jsonbPrettify</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should JSON-B provider prettify the output</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jsonpBufferStrategy</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">JSON-P JAX-RS provider buffer strategy (see johnzon)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jsonpMaxReadBufferLen</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">JSON-P JAX-RS provider read buffer limit size (see johnzon)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jsonpMaxStringLen</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">JSON-P JAX-RS provider max string limit size (see johnzon)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jsonpMaxWriteBufferLen</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">JSON-P JAX-RS provider write buffer limit size (see johnzon)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jsonpPrettify</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should JSON-P JAX-RS provider prettify the outputs (see johnzon)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">jsonpSupportsComment</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should JSON-P JAX-RS provider support comments (see johnzon)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">keepServerXmlAsThis</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Don’t replace ports in server.xml</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">keyAlias</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">HTTPS keystore alias</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">keystoreFile</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">HTTPS keystore location</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">keystorePass</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">HTTPS keystore password</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">keystoreType</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">HTTPS keystore type</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">loggingGlobalSetup</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should logging be configured to use log4j2 (it is global)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">loginConfig</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">web.xml login config</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">meecrowaveProperties</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Loads a meecrowave properties, defaults to meecrowave.properties.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">pidFile</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A file path to write the process id if the server starts</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">properties</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Passthrough properties</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">quickSession</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should an unsecured but fast session id generator be used</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">realm</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">realm</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">roles</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">In memory roles</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">scanningExcludes</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A forced exclude list of jar names (comma separated values)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">scanningIncludes</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A forced include list of jar names (comma separated values)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">scanningPackageExcludes</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A forced exclude list of packages names (comma separated values)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">scanningPackageIncludes</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A forced include list of packages names (comma separated values)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">securityConstraints</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">web.xml security constraint</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">serverXml</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Provided server.xml</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">sharedLibraries</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A folder containing shared libraries.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">skipHttp</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Skip HTTP connector</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ssl</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Use HTTPS</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">sslProtocol</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">HTTPS protocol</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">stopPort</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Shutdown port if used or -1</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tempDir</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Temporary directory</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tomcatAccessLogPattern</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Activates and configure the access log valve. Value example: '%h %l %u %t "%r" %s %b "%{Referer}i" "%{User-Agent}i"'</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tomcatAutoSetup</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Add default servlet</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tomcatFilter</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">A Tomcat JarScanFilter</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tomcatNoJmx</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">(Experimental) Should Tomcat MBeans be skipped.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tomcatScanning</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should Tomcat scanning be used (@HandleTypes, @WebXXX)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">tomcatWrapLoader</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">(Experimental) When deploying a classpath (current classloader), should meecrowave wrap the loader to define another loader identity but still use the same classes and resources.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">useLog4j2JulLogManager</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should JUL logs be redirected to Log4j2 - only works before JUL usage.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">useShutdownHook</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Use shutdown hook to automatically stop the container on Ctrl+C</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">useTomcatDefaults</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Should Tomcat default be set (session timeout, mime mapping etc…​)</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">users</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">In memory users</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">watcherBouncing</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Activate redeployment on directories update using this bouncing.</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">webResourceCached</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Cache web resources</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">webXml</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Global web.xml</p></td>
-</tr>
-</tbody>
-</table>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-the class also provides some helper methods for programamtic use case like <code>randomHttpPort()</code>
-to automatically set an available port to <code>httpPort</code>.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>You can also write a <code>Consumer<Builder></code> to configure programmatically the <code>Builder</code>
-and make it active using <code>addCustomizer(Consumer<Builder>)</code>.</p>
-</div>
-<div class="paragraph">
-<p>Example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">new Meecrowave(new Builder() {{
+ <div id="preamble">
+ <div class="sectionbody">
+ <div class="paragraph">
+ <p>Meecrowave configuration is centralized in <code>org.apache.meecrowave.Meecrowave$Builder</code> class.</p>
+ </div>
+ <div class="paragraph">
+ <p>Here are the main properties:</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">cdiConversation</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should CDI conversation be activated</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">clientAuth</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">HTTPS keystore client authentication</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">conf</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Conf folder to synchronize</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">connectors</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Custom connectors</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">cxfServletParams</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Init parameters passed to CXF servlet</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">defaultSSLHostConfigName</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">The name of the default SSLHostConfig that will be used for secure https connections.</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">deleteBaseOnStartup</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should the directory be cleaned on startup if existing</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">dir</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Root folder if provided otherwise a fake one is created in tmp-dir</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">host</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Default host</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">http2</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Activate HTTP 2</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">httpPort</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">HTTP port</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">httpsPort</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">HTTPS port</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">initializeClientBus</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should the client bus be set. If false the server one will likely be reused.</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">injectServletContainerInitializer</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should ServletContainerInitialize support injections.</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">jaxrsAutoActivateBeanValidation</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should bean validation be activated on JAX-RS endpoint if present in the classpath.</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">jaxrsDefaultProviders</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">If jaxrsProviderSetup is true the list of default providers to load (or defaulting to johnson jsonb and jsonp ones)</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">jaxrsLogProviders</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should JAX-RS providers be logged</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">jaxrsMapping</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Default jaxrs mapping</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">jaxrsProviderSetup</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should default JAX-RS provider be configured</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">jaxwsSupportIfAvailable</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should @WebService CDI beans be deployed if cxf-rt-frontend-jaxws is in the classpath.</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">jsonbBinaryStrategy</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should JSON-B provider prettify the output</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">jsonbEncoding</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Which encoding provider JSON-B should use</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">jsonbIJson</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should JSON-B provider comply to I-JSON</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">jsonbNamingStrategy</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should JSON-B provider prettify the output</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">jsonbNulls</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should JSON-B provider serialize nulls</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">jsonbOrderStrategy</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should JSON-B provider prettify the output</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">jsonbPrettify</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should JSON-B provider prettify the output</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">jsonpBufferStrategy</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">JSON-P JAX-RS provider buffer strategy (see johnzon)</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">jsonpMaxReadBufferLen</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">JSON-P JAX-RS provider read buffer limit size (see johnzon)</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">jsonpMaxStringLen</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">JSON-P JAX-RS provider max string limit size (see johnzon)</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">jsonpMaxWriteBufferLen</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">JSON-P JAX-RS provider write buffer limit size (see johnzon)</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">jsonpPrettify</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should JSON-P JAX-RS provider prettify the outputs (see johnzon)</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">jsonpSupportsComment</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should JSON-P JAX-RS provider support comments (see johnzon)</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">keepServerXmlAsThis</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Donât replace ports in server.xml</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">keyAlias</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">HTTPS keystore alias</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">keystoreFile</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">HTTPS keystore location</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">keystorePass</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">HTTPS keystore password</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">keystoreType</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">HTTPS keystore type</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">loggingGlobalSetup</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should logging be configured to use log4j2 (it is global)</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">loginConfig</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">web.xml login config</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">meecrowaveProperties</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Loads a meecrowave properties, defaults to meecrowave.properties.</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">pidFile</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">A file path to write the process id if the server starts</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">properties</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Passthrough properties</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">quickSession</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should an unsecured but fast session id generator be used</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">realm</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">realm</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">roles</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">In memory roles</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">scanningExcludes</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">A forced exclude list of jar names (comma separated values)</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">scanningIncludes</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">A forced include list of jar names (comma separated values)</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">scanningPackageExcludes</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">A forced exclude list of packages names (comma separated values)</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">scanningPackageIncludes</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">A forced include list of packages names (comma separated values)</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">securityConstraints</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">web.xml security constraint</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">serverXml</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Provided server.xml</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">sharedLibraries</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">A folder containing shared libraries.</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">skipHttp</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Skip HTTP connector</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">ssl</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Use HTTPS</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">sslProtocol</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">HTTPS protocol</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">stopPort</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Shutdown port if used or -1</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">tempDir</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Temporary directory</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">tomcatAccessLogPattern</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Activates and configure the access log valve. Value example: '%h %l %u %t "%r" %s %b "%{Referer}i" "%{User-Agent}i"'</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">tomcatAutoSetup</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Add default servlet</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">tomcatFilter</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">A Tomcat JarScanFilter</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">tomcatNoJmx</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">(Experimental) Should Tomcat MBeans be skipped.</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">tomcatScanning</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should Tomcat scanning be used (@HandleTypes, @WebXXX)</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">tomcatWrapLoader</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">(Experimental) When deploying a classpath (current classloader), should meecrowave wrap the loader to define another loader identity but still use the same classes and resources.</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">useLog4j2JulLogManager</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should JUL logs be redirected to Log4j2 - only works before JUL usage.</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">useShutdownHook</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Use shutdown hook to automatically stop the container on Ctrl+C</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">useTomcatDefaults</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Should Tomcat default be set (session timeout, mime mapping etcâ¦â)</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">users</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">In memory users</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">watcherBouncing</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Activate redeployment on directories update using this bouncing.</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">webResourceCached</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Cache web resources</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">webSessionCookieConfig</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Force the cookie-config, it uses a properties syntax with the keys being the web.xml tag names.</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">webSessionTimeout</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Force the session timeout for webapps</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">webXml</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Global web.xml</p></td>
+ </tr>
+ </tbody>
+ </table>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> the class also provides some helper methods for programmatic use case like <code>randomHttpPort()</code> to automatically set an available port to <code>httpPort</code>. </td>
+ </tr>
+ </tbody>
+ </table>
+ </div>
+ <div class="paragraph">
+ <p>You can also write a <code>Consumer<Builder></code> to configure programmatically the <code>Builder</code> and make it active using <code>addCustomizer(Consumer<Builder>)</code>.</p>
+ </div>
+ <div class="paragraph">
+ <p>Example:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">new Meecrowave(new Builder() {{
randomHttpPort();
setTomcatScanning(false);
setTomcatAutoSetup(false);
@@ -394,36 +406,36 @@ and make it active using <code>addCustom
user("admin", "secret");
}})
.bake()
- .await();</code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_cdi_se_api">CDI SE API</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>CDI 2.0 introduces a "SE API" for CDI. It looks like:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">try (final SeContainer container = SeContainerInitializer.newInstance()
+ .await();</code></pre>
+ </div>
+ </div>
+ </div>
+</div>
+<div class="sect1">
+ <h2 id="_cdi_se_api">CDI SE API</h2>
+ <div class="sectionbody">
+ <div class="paragraph">
+ <p>CDI 2.0 introduces a "SE API" for CDI. It looks like:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">try (final SeContainer container = SeContainerInitializer.newInstance()
.disableDiscovery()
.addBeanClasses(Configured.class)
.initialize()) {
// your main
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Meecrowave inherits from OpenWebBeans SE API implementation and therefore this SE API will work out of the box.</p>
-</div>
-<div class="paragraph">
-<p>It is implemented as a <code>bake()</code> and you can still access the <code>Builder</code> configuration or even <code>Meecrowave</code> itself if needed:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">try (final SeContainer container = SeContainerInitializer.newInstance()
+}</code></pre>
+ </div>
+ </div>
+ <div class="paragraph">
+ <p>Meecrowave inherits from OpenWebBeans SE API implementation and therefore this SE API will work out of the box.</p>
+ </div>
+ <div class="paragraph">
+ <p>It is implemented as a <code>bake()</code> and you can still access the <code>Builder</code> configuration or even <code>Meecrowave</code> itself if needed:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">try (final SeContainer container = SeContainerInitializer.newInstance()
.disableDiscovery()
.addBeanClasses(Configured.class)
.initialize()) {
@@ -435,130 +447,95 @@ and make it active using <code>addCustom
// default wait implementation relying on tomcat one
container.select(Meecrowave.class).get().await(); // wait for the program to be killed (tomcat.await() equivalent)
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>All the configuration of meecrowave is still available using properties:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">try (final SeContainer container = SeContainerInitializer.newInstance()
+}</code></pre>
+ </div>
+ </div>
+ <div class="paragraph">
+ <p>All the configuration of meecrowave is still available using properties:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">try (final SeContainer container = SeContainerInitializer.newInstance()
.addProperty("nameOfTheProperty", instanceInTheRightType)
.initialize()) {
container.select(Meecrowave.class).get().await();
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The type should match the type expected by the <code>Builder</code> instance. Note you can also just pass directly a <code>Builder</code> instance as value
-(the property name is not important) if you want something preconfigured:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">try (final SeContainer container = SeContainerInitializer.newInstance()
+}</code></pre>
+ </div>
+ </div>
+ <div class="paragraph">
+ <p>The type should match the type expected by the <code>Builder</code> instance. Note you can also just pass directly a <code>Builder</code> instance as value (the property name is not important) if you want something preconfigured:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">try (final SeContainer container = SeContainerInitializer.newInstance()
.addProperty("meecrowaveConfiguration", new Meecrowave.Builder().randomPort())
.initialize()) {
container.select(Meecrowave.class).get().await();
-}</code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_automatic_configuration">Automatic configuration</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The <code>org.apache.meecrowave.Meecrowave$Builder</code> class also provides <code>loadFromProperties(Properties)</code>
-and <code>loadFrom(String)</code>. The last one uses the parameter to locate a propertiers file (file path or at classpath)
-and delegate the processing to the first one.</p>
-</div>
-<div class="paragraph">
-<p><code>loadFromProperties(Propertiers)</code> loads the configuraton from the properties. The matching is alsmot
-1-1 with previous table excepted for these entries:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>if <code>httpPort</code> is <code>-1</code> then <code>randomHttpPort</code> is called</p>
-</li>
-<li>
-<p><code>properties.x=y</code> will set the property (<code>properties</code> entry) <code>x</code> with the value <code>y</code></p>
-</li>
-<li>
-<p><code>users.x=y</code> will create the user <code>x</code> with the password <code>y</code></p>
-</li>
-<li>
-<p><code>roles.x=y</code> will create the role <code>x</code> with the users <code>y</code> (comma separated if multiple users)</p>
-</li>
-<li>
-<p><code>cxf.servlet.params.x=y</code> will force the CXF servlet init parameter <code>x</code> to be <code>y</code></p>
-</li>
-<li>
-<p><code>connector.x=y</code> will pass the property <code>x</code> to be <code>y</code> on the connector</p>
-</li>
-<li>
-<p><code>connector.attributes.x=y</code> will use the property <code>x</code> with value <code>y</code> to create the connector (set a property on the instance of Ì`org.apache.catalina.connector.Connector`)</p>
-</li>
-<li>
-<p><code>realm=y</code> will create an instance of <code>y</code> (qualified name of the class) as <code>realm</code></p>
-</li>
-<li>
-<p><code>realm.x=y</code> will set <code>x</code> property to <code>y</code> - needs previous property to be set</p>
-</li>
-<li>
-<p><code>login=</code> will create a custom <code>org.apache.meecrowave.Meecrowave$LoginConfigBuilder</code></p>
-</li>
-<li>
-<p><code>login.x=y</code> will customize previous instance with <code>x</code> property</p>
-</li>
-<li>
-<p><code>securityConstraint=</code> will create a custom <code>org.apache.meecrowave.Meecrowave$SecurityConstaintBuilder</code></p>
-</li>
-<li>
-<p><code>securityConstraint.x=y</code> will customize previous instance with <code>x</code> property</p>
-</li>
-<li>
-<p><code>configurationCustomizer=y</code> will create an instance of <code>y</code> to customize the configuration</p>
-</li>
-<li>
-<p><code>configurationCustomizer.x=y</code> will set <code>x</code> to <code>y</code> for the customizer</p>
-</li>
-</ul>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-out of the box, any <code>Builder</code> instance will read <code>meecrowave.properties</code>. <code>meecrowave.properties</code> uses CLI
-names (without the leading <code>--</code>). See <a href="/meecrowave/meecrowave-core/cli.html">CLI</a> page for the list.
-</td>
-</tr>
-</table>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_logging">Logging</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Meecrowave relies by default on Log4j2 (see <a href="http://logging.apache.org/log4j/2.x/" class="bare">http://logging.apache.org/log4j/2.x/</a>). By default it uses an internal
-configuration which is overriden by standard log4j mecanism.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_passwords_secrets">Passwords/Secrets</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>For the configuration requiring to be ciphered you can implement <code>org.apache.meecrowave.service.ValueTransformer</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code>public class MyTransformer implements ValueTransformer {
+}</code></pre>
+ </div>
+ </div>
+ </div>
+</div>
+<div class="sect1">
+ <h2 id="_automatic_configuration">Automatic configuration</h2>
+ <div class="sectionbody">
+ <div class="paragraph">
+ <p>The <code>org.apache.meecrowave.Meecrowave$Builder</code> class also provides <code>loadFromProperties(Properties)</code> and <code>loadFrom(String)</code>. The last one uses the parameter to locate a propertiers file (file path or at classpath) and delegate the processing to the first one.</p>
+ </div>
+ <div class="paragraph">
+ <p><code>loadFromProperties(Propertiers)</code> loads the configuraton from the properties.</p>
+ </div>
+ <div class="paragraph">
+ <p>The matching is alsmot 1-1 with previous table excepted for these entries:</p>
+ </div>
+ <div class="ulist">
+ <ul>
+ <li> <p>if <code>httpPort</code> is <code>-1</code> then <code>randomHttpPort</code> is called</p> </li>
+ <li> <p><code>properties.x=y</code> will set the property (<code>properties</code> entry) <code>x</code> with the value <code>y</code></p> </li>
+ <li> <p><code>users.x=y</code> will create the user <code>x</code> with the password <code>y</code></p> </li>
+ <li> <p><code>roles.x=y</code> will create the role <code>x</code> with the users <code>y</code> (comma separated if multiple users)</p> </li>
+ <li> <p><code>cxf.servlet.params.x=y</code> will force the CXF servlet init parameter <code>x</code> to be <code>y</code></p> </li>
+ <li> <p><code>connector.x=y</code> will pass the property <code>x</code> to be <code>y</code> on the connector. See the <a href="https://tomcat.apache.org/tomcat-9.0-doc/config/http.html">Apache Tomcat 9 Connector Documentation</a></p> </li>
+ <li> <p><code>connector.attributes.x=y</code> will use the property <code>x</code> with value <code>y</code> to create the connector (set a property on the instance of Ì`org.apache.catalina.connector.Connector`) See the Connector attributes referenced in the <a href="https://tomcat.apache.org/tomcat-9.0-doc/config/http.html">Apache Tomcat 9 Connector Documentation</a></p> </li>
+ <li> <p><code>realm=y</code> will create an instance of <code>y</code> (qualified name of the class) as <code>realm</code></p> </li>
+ <li> <p><code>realm.x=y</code> will set <code>x</code> property to <code>y</code> - needs previous property to be set</p> </li>
+ <li> <p><code>login=</code> will create a custom <code>org.apache.meecrowave.Meecrowave$LoginConfigBuilder</code></p> </li>
+ <li> <p><code>login.x=y</code> will customize previous instance with <code>x</code> property</p> </li>
+ <li> <p><code>securityConstraint=</code> will create a custom <code>org.apache.meecrowave.Meecrowave$SecurityConstaintBuilder</code></p> </li>
+ <li> <p><code>securityConstraint.x=y</code> will customize previous instance with <code>x</code> property</p> </li>
+ <li> <p><code>configurationCustomizer=y</code> will create an instance of <code>y</code> to customize the configuration</p> </li>
+ <li> <p><code>configurationCustomizer.x=y</code> will set <code>x</code> to <code>y</code> for the customizer</p> </li>
+ </ul>
+ </div>
+ <div class="admonitionblock tip">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td>
+ <td class="content"> Out of the box, any <code>Builder</code> instance will read <code>meecrowave.properties</code>. <code>meecrowave.properties</code> uses CLI names (without the leading <code>--</code>). See <a href="/meecrowave/meecrowave-core/cli.html">CLI</a> page for the list. </td>
+ </tr>
+ </tbody>
+ </table>
+ </div>
+ </div>
+</div>
+<div class="sect1">
+ <h2 id="_logging">Logging</h2>
+ <div class="sectionbody">
+ <div class="paragraph">
+ <p>Meecrowave relies by default on Log4j2 (see <a href="http://logging.apache.org/log4j/2.x/" class="bare">http://logging.apache.org/log4j/2.x/</a>). By default it uses an internal configuration which is overridden by standard log4j mechanism.</p>
+ </div>
+ </div>
+</div>
+<div class="sect1">
+ <h2 id="_passwords_secrets">Passwords/Secrets</h2>
+ <div class="sectionbody">
+ <div class="paragraph">
+ <p>For the configuration requiring to be ciphered you can implement <code>org.apache.meecrowave.service.ValueTransformer</code>:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlightjs highlight"><code>public class MyTransformer implements ValueTransformer {
@Override
public String name() {
return "mine";
@@ -568,48 +545,43 @@ configuration which is overriden by stan
public String apply(final String encodedPassword) {
return ....;
}
-}</code></pre>
-</div>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-this code being executed before the container starts you can’t use CDI there.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>To register your implementation just put the fully qualified name of your transformer in <code>META-INF/services/org.apache.meecrowave.service.ValueTransformer</code>.</p>
-</div>
-<div class="paragraph">
-<p>Then to use it set the value to <code>decode:mine:encodedvalue</code>. General pattern is: <code>decode:<transformer name>:<value before decryption></code>.</p>
-</div>
-<div class="paragraph">
-<p>Note that by default the same ciphering algorithm than in TomEE is available (Static3DES).</p>
-</div>
-<div class="paragraph">
-<p>This syntax is usable on the command line and in <code>meecrowave.properties</code>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_programmatic_customization">Programmatic customization</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p><code>org.apache.meecrowave.Meecrowave$ConfigurationCustomizer</code> can be used to customize the configuration
-programmatically before startup. It will take the <code>Builder</code> as parameter and you can change it at that moment.</p>
-</div>
-<div class="paragraph">
-<p><code>org.apache.meecrowave.Meecrowave$InstanceCustomizer</code> can be used to customize the configuration
-programmatically before startup. It will take the <code>Tomcat</code> as parameter and you can change it at that moment. This
-is very useful to automatically add valves and things like that.</p>
-</div>
-</div>
+}</code></pre>
+ </div>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> this code being executed before the container starts you canât use CDI there. </td>
+ </tr>
+ </tbody>
+ </table>
+ </div>
+ <div class="paragraph">
+ <p>To register your implementation just put the fully qualified name of your transformer in <code>META-INF/services/org.apache.meecrowave.service.ValueTransformer</code>.</p>
+ </div>
+ <div class="paragraph">
+ <p>Then to use it set the value to <code>decode:mine:encodedvalue</code>. General pattern is: <code>decode:<transformer name>:<value before decryption></code>.</p>
+ </div>
+ <div class="paragraph">
+ <p>Note that by default the same ciphering algorithm than in TomEE is available (Static3DES).</p>
+ </div>
+ <div class="paragraph">
+ <p>This syntax is usable on the command line and in <code>meecrowave.properties</code>.</p>
+ </div>
+ </div>
+</div>
+<div class="sect1">
+ <h2 id="_programmatic_customization">Programmatic customization</h2>
+ <div class="sectionbody">
+ <div class="paragraph">
+ <p><code>org.apache.meecrowave.Meecrowave$ConfigurationCustomizer</code> can be used to customize the configuration programmatically before startup. It will take the <code>Builder</code> as parameter and you can change it at that moment.</p>
+ </div>
+ <div class="paragraph">
+ <p><code>org.apache.meecrowave.Meecrowave$InstanceCustomizer</code> can be used to customize the configuration programmatically before startup. It will take the <code>Tomcat</code> as parameter and you can change it at that moment. This is very useful to automatically add valves and things like that.</p>
+ </div>
+ </div>
</div>
</section><!--//doc-section-->
Modified: websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-core/configuration.pdf
==============================================================================
Binary files - no diff available.
Modified: websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-gradle/index.html
==============================================================================
--- websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-gradle/index.html (original)
+++ websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-gradle/index.html Fri Jul 6 08:51:56 2018
@@ -47,7 +47,7 @@
<div class="doc-wrapper">
<div class="container">
<div id="doc-header" class="doc-header text-center">
- <h1 class="doc-title"><span aria-hidden="true" class="icon icon_lifesaver"></span> Meecrowave Gradle</h1>
+ <h1 class="doc-title"><span aria-hidden="true" class="icon icon icon_puzzle_alt"></span> Meecrowave Gradle</h1>
</div><!--//doc-header-->
<div class="doc-body">
@@ -66,9 +66,9 @@
<section class="doc-section">
- <div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">buildscript {
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">buildscript {
repositories {
mavenCentral()
}
@@ -86,11 +86,11 @@ apply plugin: 'org.apache.meecrowave.mee
meecrowave {
httpPort = 9090
// most of the meecrowave core configuration
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>More coming soon, for now use gradle IDE integration or configuration documentation please.</p>
+}</code></pre>
+ </div>
+</div>
+<div class="paragraph">
+ <p>More coming soon, for now use gradle IDE integration or configuration documentation please.</p>
</div>
</section><!--//doc-section-->
Modified: websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-gradle/index.pdf
==============================================================================
Binary files - no diff available.
Modified: websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-jolokia/index.html
==============================================================================
--- websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-jolokia/index.html (original)
+++ websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-jolokia/index.html Fri Jul 6 08:51:56 2018
@@ -47,7 +47,7 @@
<div class="doc-wrapper">
<div class="container">
<div id="doc-header" class="doc-header text-center">
- <h1 class="doc-title"><span aria-hidden="true" class="icon icon_lifesaver"></span> Meecrowave Jolokia</h1>
+ <h1 class="doc-title"><span aria-hidden="true" class="icon icon icon_puzzle_alt"></span> Meecrowave Jolokia</h1>
</div><!--//doc-header-->
<div class="doc-body">
@@ -66,62 +66,58 @@
<section class="doc-section">
- <div id="preamble">
-<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 id="preamble">
+ <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-jolokia</artifactId>
<version>${meecrowave.version}</version>
-</dependency></code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_jolokia_only">Jolokia only</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>If Hawt.io is not setup (not there or inactive) the module will set up jolokia alone.</p>
-</div>
-<div class="paragraph">
-<p>It will deploy the jolokia servlet on <code>/jolokia/*</code> or the property <code>jolokia.web.mapping</code> set
-on the <code>Meecrowave.Builder</code>.</p>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-don’t forget to secure this endpoint cause it let you access all the JMX MBeans. See
-Meecrowave core configuration for more details.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>More on <a href="https://jolokia.org/reference/html/" class="bare">https://jolokia.org/reference/html/</a></p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_hawt_io">Hawt.io</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>By default hawt.io will be deployed and activated on <code>/hawtio/</code> endpoint.</p>
-</div>
-<div class="paragraph">
-<p>To activate it you need to add these dependencies:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><dependency>
+</dependency></code></pre>
+ </div>
+ </div>
+ </div>
+</div>
+<div class="sect1">
+ <h2 id="_jolokia_only">Jolokia only</h2>
+ <div class="sectionbody">
+ <div class="paragraph">
+ <p>If Hawt.io is not setup (not there or inactive) the module will set up jolokia alone.</p>
+ </div>
+ <div class="paragraph">
+ <p>It will deploy the jolokia servlet on <code>/jolokia/*</code> or the property <code>jolokia.web.mapping</code> set on the <code>Meecrowave.Builder</code>.</p>
+ </div>
+ <div class="admonitionblock important">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-important" title="Important"></i> </td>
+ <td class="content"> donât forget to secure this endpoint cause it let you access all the JMX MBeans. See Meecrowave core configuration for more details. </td>
+ </tr>
+ </tbody>
+ </table>
+ </div>
+ <div class="paragraph">
+ <p>More on <a href="https://jolokia.org/reference/html/" class="bare">https://jolokia.org/reference/html/</a></p>
+ </div>
+ </div>
+</div>
+<div class="sect1">
+ <h2 id="_hawt_io">Hawt.io</h2>
+ <div class="sectionbody">
+ <div class="paragraph">
+ <p>By default hawt.io will be deployed and activated on <code>/hawtio/</code> endpoint.</p>
+ </div>
+ <div class="paragraph">
+ <p>To activate it you need to add these dependencies:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><dependency>
<groupId>io.hawt</groupId>
<artifactId>hawtio-springboot</artifactId>
<version>1.4.67</version>
@@ -138,97 +134,90 @@ Meecrowave core configuration for more d
<artifactId>log4j-slf4j-impl</artifactId>
<version>${log4j2.version}</version>
<optional>true</optional>
-</dependency></code></pre>
-</div>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-we don’t need spring boot but we reuse hawt.io spring boot module which packages web resources in a jar.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>By default it will setup the security to use the Servlet security which means you can use meecrowave options:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code>./meecrowave-runner --users=admin=admin --roles=admin=admin</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>And log with admin/admin user.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_running_hawtio_war">Running HawtIO war</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>To run <a href="http://hawt.io" class="bare">http://hawt.io</a>, the easiest is to setup jaas and run the hawt.io war:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code>java -Djava.security.auth.login.config=login.config \
+</dependency></code></pre>
+ </div>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> we donât need spring boot but we reuse hawt.io spring boot module which packages web resources in a jar. </td>
+ </tr>
+ </tbody>
+ </table>
+ </div>
+ <div class="paragraph">
+ <p>By default it will setup the security to use the Servlet security which means you can use meecrowave options:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlightjs highlight"><code>./meecrowave-runner --users=admin=admin --roles=admin=admin</code></pre>
+ </div>
+ </div>
+ <div class="paragraph">
+ <p>And log with admin/admin user.</p>
+ </div>
+ </div>
+</div>
+<div class="sect1">
+ <h2 id="_running_hawtio_war">Running HawtIO war</h2>
+ <div class="sectionbody">
+ <div class="paragraph">
+ <p>To run <a href="http://hawt.io" class="bare">http://hawt.io</a>, the easiest is to setup jaas and run the hawt.io war:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlightjs highlight"><code>java -Djava.security.auth.login.config=login.config \
-jar meecrowave-runner.jar \
- -webapp hawtio-default-offline-1.4.67.war</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This assumes you created a <code>login.config</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code>karaf {
+ -webapp hawtio-default-offline-1.4.67.war</code></pre>
+ </div>
+ </div>
+ <div class="paragraph">
+ <p>This assumes you created a <code>login.config</code>:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlightjs highlight"><code>karaf {
org.apache.catalina.realm.JAASMemoryLoginModule required
pathname="/path/to/tomcat-users.xml";
-};</code></pre>
-</div>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-the JAAS login module is named <code>karaf</code> because it is the default of hawt.io (check <code>io.hawt.web.AuthenticationFilter.init()</code>).
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>And if you use - as in previous snippet - tomcat-users.xml you need to create an admin (role) user:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><tomcat-users>
+};</code></pre>
+ </div>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> the JAAS login module is named <code>karaf</code> because it is the default of hawt.io (check <code>io.hawt.web.AuthenticationFilter.init()</code>). </td>
+ </tr>
+ </tbody>
+ </table>
+ </div>
+ <div class="paragraph">
+ <p>And if you use - as in previous snippet - tomcat-users.xml you need to create an admin (role) user:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><tomcat-users>
<user username="admin" password="admin" role="hawtio" roles="admin" />
-</tomcat-users></code></pre>
-</div>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-don’t try to use <code>io.hawt.web.tomcat.TomcatUserDatabaseLoginContext</code> of hawt.io which does the same as <code>JAASMemoryLoginModule</code>
-excepted it doesn’t handle absolute paths which enforce you to use a <code>catalina.base</code>.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>Using hawt.io war you don’t need to run jolokia servlet by yourself, it is already done.</p>
-</div>
-</div>
+</tomcat-users></code></pre>
+ </div>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> donât try to use <code>io.hawt.web.tomcat.TomcatUserDatabaseLoginContext</code> of hawt.io which does the same as <code>JAASMemoryLoginModule</code> excepted it doesnât handle absolute paths which enforce you to use a <code>catalina.base</code>. </td>
+ </tr>
+ </tbody>
+ </table>
+ </div>
+ <div class="paragraph">
+ <p>Using hawt.io war you donât need to run jolokia servlet by yourself, it is already done.</p>
+ </div>
+ </div>
</div>
</section><!--//doc-section-->
Modified: websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-jolokia/index.pdf
==============================================================================
Binary files - no diff available.
Modified: websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-jpa/index.html
==============================================================================
--- websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-jpa/index.html (original)
+++ websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-jpa/index.html Fri Jul 6 08:51:56 2018
@@ -47,7 +47,7 @@
<div class="doc-wrapper">
<div class="container">
<div id="doc-header" class="doc-header text-center">
- <h1 class="doc-title"><span aria-hidden="true" class="icon icon_lifesaver"></span> Meecrowave JPA</h1>
+ <h1 class="doc-title"><span aria-hidden="true" class="icon icon icon_puzzle_alt"></span> Meecrowave JPA</h1>
</div><!--//doc-header-->
<div class="doc-body">
@@ -66,19 +66,17 @@
<section class="doc-section">
- <div id="preamble">
-<div class="sectionbody">
-<div class="paragraph">
-<p>The overall idea behind this module is to propose a CDI integration of JPA
-allowing to programmatically control its persistence units.</p>
-</div>
-<div class="paragraph">
-<p>Concretely you will create a persistence unit from a <code>PersistenceUnitBuilder</code>
-allowing you to fully configure your unit from CDI context including the datasource:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@ApplicationScoped
+ <div id="preamble">
+ <div class="sectionbody">
+ <div class="paragraph">
+ <p>The overall idea behind this module is to propose a CDI integration of JPA allowing to programmatically control its persistence units.</p>
+ </div>
+ <div class="paragraph">
+ <p>Concretely you will create a persistence unit from a <code>PersistenceUnitBuilder</code> allowing you to fully configure your unit from CDI context including the datasource:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@ApplicationScoped
public class JpaConfig {
@Produces
public PersistenceUnitInfoBuilder unit(final DataSource ds) {
@@ -90,28 +88,25 @@ public class JpaConfig {
.addProperty("openjpa.RuntimeUnenhancedClasses", "supported")
.addProperty("openjpa.jdbc.SynchronizeMappings", "buildSchema");
}
-}</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">
-if your application uses a single persistence unit this is optional and
-a default one will be created if a single DataSource bean is available as Bean<?>.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>The datasource can be produces as you wish using your own configuration mecanism:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@ApplicationScoped
+}</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"> if your application uses a single persistence unit this is optional and a default one will be created if a single DataSource bean is available as Bean<?>. </td>
+ </tr>
+ </tbody>
+ </table>
+ </div>
+ <div class="paragraph">
+ <p>The datasource can be produces as you wish using your own configuration mecanism:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@ApplicationScoped
public class JpaConfig {
@Produces // dbcp2 datasource for instance
@ApplicationScoped
@@ -121,29 +116,25 @@ public class JpaConfig {
source.setUrl("jdbc:h2:mem:jpaextensiontest");
return source;
}
-}</code></pre>
-</div>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-it is recommanded to ensure the <code>DataSource</code> is normal-scoped to not get surprises in term of behavior.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>Finally you can inject your entity manager using <code>@Unit</code>. Ensure to
-decorate with <code>@Jpa</code> a class/method before using the entity manager to activate
-the jpa CDI context:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@ApplicationScoped
+}</code></pre>
+ </div>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> it is recommanded to ensure the <code>DataSource</code> is normal-scoped to not get surprises in term of behavior. </td>
+ </tr>
+ </tbody>
+ </table>
+ </div>
+ <div class="paragraph">
+ <p>Finally you can inject your entity manager using <code>@Unit</code>. Ensure to decorate with <code>@Jpa</code> a class/method before using the entity manager to activate the jpa CDI context:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@ApplicationScoped
@Jpa(transactional = false)
public class JPADao {
@Inject
@@ -160,28 +151,25 @@ public class JPADao {
public User find(final long id) {
return em.find(User.class, id);
}
-}</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">
-this integration is 100% based on <code>RESOURCE_LOCAL</code> units for now.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>Not that if a bean get injected an <code>EntityManager</code> it gets automatically <code>@Jpa(transactional=true)</code>
-so previous bean is equivalent to:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@ApplicationScoped
+}</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"> this integration is 100% based on <code>RESOURCE_LOCAL</code> units for now. </td>
+ </tr>
+ </tbody>
+ </table>
+ </div>
+ <div class="paragraph">
+ <p>Not that if a bean get injected an <code>EntityManager</code> it gets automatically <code>@Jpa(transactional=true)</code> so previous bean is equivalent to:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@ApplicationScoped
public class JPADao {
@Inject
@Unit(name = "test")
@@ -196,19 +184,18 @@ public class JPADao {
public User find(final long id) {
return em.find(User.class, id);
}
-}</code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_integration_with_bean_validation">Integration with Bean Validation</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The extension will try to find a <code>ValidatorFactory</code> in CDI context and will provide ir to the JPA provider
-if the <code>ValidationMode</code> is not <code>NONE</code> and a <code>Bean<ValidatorFactory></code> exists.</p>
-</div>
-</div>
+}</code></pre>
+ </div>
+ </div>
+ </div>
+</div>
+<div class="sect1">
+ <h2 id="_integration_with_bean_validation">Integration with Bean Validation</h2>
+ <div class="sectionbody">
+ <div class="paragraph">
+ <p>The extension will try to find a <code>ValidatorFactory</code> in CDI context and will provide ir to the JPA provider if the <code>ValidationMode</code> is not <code>NONE</code> and a <code>Bean<ValidatorFactory></code> exists.</p>
+ </div>
+ </div>
</div>
</section><!--//doc-section-->
Modified: websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-jpa/index.pdf
==============================================================================
Binary files - no diff available.
Modified: websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-jta/index.html
==============================================================================
--- websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-jta/index.html (original)
+++ websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-jta/index.html Fri Jul 6 08:51:56 2018
@@ -47,7 +47,7 @@
<div class="doc-wrapper">
<div class="container">
<div id="doc-header" class="doc-header text-center">
- <h1 class="doc-title"><span aria-hidden="true" class="icon icon_lifesaver"></span> Meecrowave JTA</h1>
+ <h1 class="doc-title"><span aria-hidden="true" class="icon icon icon_puzzle_alt"></span> Meecrowave JTA</h1>
</div><!--//doc-header-->
<div class="doc-body">
@@ -66,20 +66,20 @@
<section class="doc-section">
- <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="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-jta</artifactId>
<version>${meecrowave.version}</version>
-</dependency></code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>This allows to use <code>@Transactional</code> and <code>@TransactionScoped</code> features of JTA 1.2.</p>
+</dependency></code></pre>
+ </div>
+</div>
+<div class="paragraph">
+ <p>This allows to use <code>@Transactional</code> and <code>@TransactionScoped</code> features of JTA 1.2.</p>
</div>
</section><!--//doc-section-->
Modified: websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-jta/index.pdf
==============================================================================
Binary files - no diff available.
Added: websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-letsencrypt/index.html
==============================================================================
--- websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-letsencrypt/index.html (added)
+++ websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-letsencrypt/index.html Fri Jul 6 08:51:56 2018
@@ -0,0 +1,185 @@
+<!DOCTYPE html>
+<!--[if IE 8]> <html lang="en" class="ie8"> <![endif]-->
+<!--[if IE 9]> <html lang="en" class="ie9"> <![endif]-->
+<!--[if !IE]><!--> <html lang="en"> <!--<![endif]-->
+<head>
+ <title>Meecrowave :: the customizable server</title>
+ <!-- Meta -->
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+ <meta name="description" content="">
+ <meta name="author" content="">
+ <link rel="shortcut icon" href="/meecrowave/favicon.ico">
+ <link href='http://fonts.googleapis.com/css?family=Open+Sans:300italic,400italic,600italic,700italic,800italic,400,300,600,700,800' rel='stylesheet' type='text/css'>
+ <!-- Global CSS -->
+ <link rel="stylesheet" href="/meecrowave/assets/plugins/bootstrap/css/bootstrap.min.css">
+ <!-- Plugins CSS -->
+ <link rel="stylesheet" href="/meecrowave/assets/plugins/font-awesome/css/font-awesome.min.css">
+ <link rel="stylesheet" href="/meecrowave/assets/plugins/elegant_font/css/style.css?version=1">
+ <!-- highlighting -->
+ <link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.9.0/styles/idea.min.css">
+
+ <!-- Theme CSS -->
+ <link id="theme-style" rel="stylesheet" href="/meecrowave/assets/css/styles.css">
+ <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
+ <!--[if lt IE 9]>
+ <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
+ <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
+ <![endif]-->
+</head>
+
+<body class="body-blue">
+ <div class="page-wrapper">
+ <!-- TODO: google analytics -->
+<header class="header text-center">
+ <div class="container">
+ <div class="branding">
+ <h1 class="doc-title">
+ <span aria-hidden="true" class="icon icon_shield icon"></span>
+ <a href="/meecrowave/index.html">
+ Meecrowave
+ </a>
+ </h1>
+ </div>
+ </div><!--//container-->
+</header><!--//header-->
+<div class="doc-wrapper">
+ <div class="container">
+ <div id="doc-header" class="doc-header text-center">
+ <h1 class="doc-title"><span aria-hidden="true" class="icon icon icon_shield"></span> Meecrowave Let’s Encrypt Extension</h1>
+ </div><!--//doc-header-->
+
+<div class="doc-body">
+ <div class="doc-content">
+ <div class="content-inner">
+
+
+
+
+<div class='btn-toolbar pull-right' style="z-index: 2000;">
+ <div class='btn-group'>
+ <a class="btn" href="/meecrowave/meecrowave-letsencrypt/index.pdf"><i class="fa fa-file-pdf-o"></i> Download as PDF</a>
+ </div>
+</div>
+
+
+
+ <section class="doc-section">
+ <div class="paragraph">
+ <p>Meecrowave provides a Letâs Encrypt integration which will grab the default tomcat connector and reload regularly its certificate based on Letâs Encrypt protocol.</p>
+</div>
+<div class="paragraph">
+ <p>You must configure the domain(s) to include during Letâs Encrypt discussion to activate that feature.</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">--letsencrypt-certificate-domain-location</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Where the domain certificate must be stored</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">--letsencrypt-chain-domain-location</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Where the domain chain must be stored</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">--letsencrypt-key-domain-location</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Where the domain key must be stored</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">--letsencrypt-key-domain-size</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Domain key size</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">--letsencrypt-domains</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Comma separated list of domains to manage</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">--letsencrypt-endpoint</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Endpoint to use to get the certificates</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">--letsencrypt-refresh-interval</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Number of second between letâsencrypt refreshes</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">--letsencrypt-retry-count</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">How many retries to do</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">--letsencrypt-retry-timeout-ms</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">How long to wait before retrying to get the certificate, default is 3s</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">--letsencrypt-endpoint-staging</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Ignore if endpoint is set, otherwise it set the endpoint accordingly</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">--letsencrypt-key-user-location</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">Where the user key must be stored</p></td>
+ </tr>
+ <tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">--letsencrypt-key-user-size</p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock">User key size</p></td>
+ </tr>
+ </tbody>
+</table>
+ </section><!--//doc-section-->
+
+
+
+
+ </div><!--//content-inner-->
+ </div><!--//doc-content-->
+
+ <div class="doc-sidebar">
+ <nav id="doc-nav">
+ <ul id="doc-menu" class="nav doc-menu hidden-xs affix-top" data-spy="affix">
+ <li><a href="/meecrowave/index.html">Home</a></li>
+ <li><a href="/meecrowave/start.html">Quick Start</a></li>
+ <li><a href="/meecrowave/components.html">Components</a></li>
+ <li><a href="/meecrowave/download.html">Download</a></li>
+ <li><a href="/meecrowave/community.html">Community</a></li>
+ </ul><!--//doc-menu-->
+ </nav>
+ </div>
+</div>
+
+</div><!--//page-wrapper-->
+
+ <footer class="footer text-center">
+ <div class="container">
+ <div class="row">
+ <p >Copyright © 2016
+ <a href="http://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.
+ </p>
+ </div>
+ </div>
+
+ <div class="container"><!-- don't remove it otherwise theme is no more creative common -->
+ <small class="copyright">Designed with <i class="fa fa-heart"></i> by <a href="http://themes.3rdwavemedia.com/" target="_blank">Xiaoying Riley</a> for developers</small>
+ </div><!--//container-->
+ </footer><!--//footer-->
+
+
+ <!-- Main Javascript -->
+ <script type="text/javascript" src="/meecrowave/assets/plugins/jquery-1.12.3.min.js"></script>
+ <script type="text/javascript" src="/meecrowave/assets/plugins/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript" src="/meecrowave/assets/plugins/jquery-match-height/jquery.matchHeight-min.js"></script>
+ <script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.9.0/highlight.min.js"></script>
+ <script type="text/javascript" src="/meecrowave/assets/js/main.js?version=1"></script>
+
+</body>
+</html>
+
+
Added: websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-letsencrypt/index.pdf
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/openwebbeans/trunk/content/meecrowave/meecrowave-letsencrypt/index.pdf
------------------------------------------------------------------------------
svn:mime-type = application/pdf