You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cxf.apache.org by dk...@apache.org on 2017/09/12 19:09:50 UTC
svn commit: r1018074 [27/31] - in /websites/production/cxf/content: ./
2008/04/28/ 2008/06/20/ 2008/10/23/ 2009/02/10/ 2009/08/04/ cache/ docs/
Modified: websites/production/cxf/content/docs/wsdl-to-java.html
==============================================================================
--- websites/production/cxf/content/docs/wsdl-to-java.html (original)
+++ websites/production/cxf/content/docs/wsdl-to-java.html Tue Sep 12 19:09:41 2017
@@ -32,8 +32,9 @@
<link type="text/css" rel="stylesheet" href="/resources/highlighter/styles/shThemeCXF.css">
<script src='/resources/highlighter/scripts/shCore.js'></script>
-<script src='/resources/highlighter/scripts/shBrushJava.js'></script>
+<script src='/resources/highlighter/scripts/shBrushBash.js'></script>
<script src='/resources/highlighter/scripts/shBrushXml.js'></script>
+<script src='/resources/highlighter/scripts/shBrushJava.js'></script>
<script>
SyntaxHighlighter.defaults['toolbar'] = false;
SyntaxHighlighter.all();
@@ -132,7 +133,7 @@ Apache CXF -- WSDL to Java
-mark-generated -h|-?|-help -version|-v -verbose|-V -quiet|-q|-Q -wsdlList <wsdlurl>
</pre>
</div></div><h3 id="WSDLtoJava-Description">Description</h3><p><strong>wsdl2java</strong> takes a WSDL document and generates fully annotated Java code from which to implement a service. The WSDL document must have a valid <code>portType</code> element, but it does not need to contain a binding element or a service element. Using the optional arguments you can customize the generated code. In addition, wsdl2java can generate an Ant based makefile to build your application.</p><h3 id="WSDLtoJava-Options">Options</h3><p>The options used to validate WSDL file are reviewed in the following table.</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Option</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Interpretation</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-?</code>,<code>-h</code>,<code>-help</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Displays the o
nline help for this utility and exits.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-fe frontend-name</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies the frontend. Default is JAXWS. Currently supports only JAXWS frontend and a "jaxws21" frontend to generate JAX-WS 2.1 compliant code.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-db databinding-name</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies the databinding. Default is jaxb. Currently supports jaxb, xmlbeans, sdo (sdo-static and sdo-dynamic), and jibx.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-wv wsdl-version</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies the wsdl version .Default is WSDL1.1. Currently suppports only WSDL1.1 version.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-p [ wsdl-namespace= ] PackageName</code></
p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies zero, or more, package names to use for the generated code. Optionally specifies the WSDL namespace to package name mapping.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-sn service-name</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>The WSDL service name to use for the generated code.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-b binding-name</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies JAXWS or JAXB binding files or XMLBeans context files. Use multiple -b flags to specify multiple entries.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-catalog catalog-file-name</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specify catalog file to map the imported wsdl/schema</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-d output-directory<
/code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies the directory into which the generated code files are written.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-compile</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Compiles generated Java files.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-classdir compile-class-dir</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies the directory into which the compiled class files are written.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-client</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Generates starting point code for a client mainline.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-clientjar jar-file-name</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Generates the jar file which contains all the client classes a
nd wsdl;the specified wsdlLocation won't work when the -clientJar is defined.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-server</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Generates starting point code for a server mainline.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-impl</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Generates starting point code for an implementation object.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-all</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Generates all starting point code: types, service proxy, service interface, server mainline, client mainline, implementation object, and an Ant <code>build.xml</code> file.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-ant</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specify to generate an Ant <code>build.xm
l</code> script.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-autoNameResolution</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Automatically resolve naming conflicts without requiring the use of binding customizations.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-defaultValues=[DefaultValueProvider impl]</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies that default values are generated for the impl and client. You can also provide a custom default value provider. The default provider is <code>RandomValueProvider</code></p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-nexclude schema-namespace [=java-packagename]</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Ignore the specified WSDL schema namespace when generating code. This option may be specified multiple times. Also, optionally specifies the Java package name used by types
described in the excluded namespace(s).</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-exsh (true/false)</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Enables or disables processing of implicit SOAP headers (i.e. SOAP headers defined in the wsdl:binding but not wsdl:portType section.) Processing the SOAP headers requires the SOAP binding jars available on the classpath which was not the default in CXF 2.4.x and older. You may need to add a dependency to cxf-rt-binding-soap for this flag to work. Default is false.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-dns (true/false)</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Enables or disables the loading of the default namespace package name mapping. Default is true and <a shape="rect" class="external-link" href="http://www.w3.org/2005/08/addressing=org.apache.cxf.ws.addressing" rel="nofollow">http://www.w3.org/2005/08/addressing=org.a
pache.cxf.ws.addressing</a> namespace package mapping will be enabled.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-dex (true/false)</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Enables or disables the loading of the default excludes namespace mapping. Default is true.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-validate</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Enables validating the WSDL before generating the code.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-keep</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies that the code generator will not overwrite any preexisting files. You will be responsible for resolving any resulting compilation issues.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-wsdlLocation wsdlLocation</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>S
pecifies the value of the @WebServiceClient annotation's wsdlLocation property.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-xjc<xjc args></code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies a comma separated list of <a shape="rect" class="external-link" href="https://jaxb.dev.java.net/nonav/2.2/docs/xjc.html" rel="nofollow">arguments</a> that are passed directly to the XJC processor when using the JAXB databinding. A list of available XJC plugins can be obtained using <code>-xjc-X</code>.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-noAddressBinding</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>For compatibility with CXF 2.0, this flag directs the code generator to generate the older CXF proprietary WS-Addressing types instead of the JAX-WS 2.1 compliant WS-Addressing types.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-v</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Displays the version number for the tool.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-verbose</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Displays comments during the code generation process.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-quiet</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Suppresses comments during the code generation process.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-exceptionSuper</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>superclass for fault beans generated from wsdl:fault elements (defaults to java.lang.Exception)</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-reserveClass classname</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Used with -autoNameResolution, defines a class names for wsdl-to-java <stron
g>not</strong> to use when generating classes. Use this option multiple times for multiple classes.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-allowElementReferences<=true></code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>(or -aer) If true, disregards the rule given in section 2.3.1.2(v) of the JAX-WS 2.2 specification disallowing element references when using wrapper-style mapping.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-asyncMethods=foo,bar,...</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>List of subsequently generated Java class methods to allow for client-side asynchronous calls, similar to enableAsyncMapping in a JAX-WS binding file.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-bareMethods=foo,bar,...</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>List of subsequently generated Java class methods to have wrapper st
yle (see below), similar to enableWrapperStyle in JAX-WS binding file.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-mimeMethods=foo,bar,...</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>List of subsequently generated Java class methods to enable mime:content mapping, similar to enableMIMEContent in JAX-WS binding file.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-faultSerialVersionUID <fault-serialVersionUID></code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>How to generate suid of fault exceptions. Use NONE, TIMESTAMP, FQCN, or a specific number. Default is NONE.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><code>-mark-generated</code></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Adds the <a shape="rect" class="external-link" href="http://docs.oracle.com/javase/6/docs/api/javax/annotation/Generated.html" rel="nofollow">@Generated</a> annot
ation to classes generated.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><em>wsdlurl</em></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>The path and name of the WSDL file to use in generating the code.</p></td></tr></tbody></table></div><p>You must specify the absolute or relative path to the WSDL document as the last argument.</p><p><span class="confluence-anchor-link" id="WSDLtoJava-usingant"></span></p><h3 id="WSDLtoJava-Examples">Examples</h3><p><code>wsdl2java HelloWorld.wsdl</code></p><p><code>wsdl2java -p com.mycompany.greeting Greeting.wsdl</code></p><p><code>wsdl2java -client HelloWorld.wsdl</code></p><p>(See below for usage with Apache <a shape="rect" href="wsdl-to-java.html">Ant</a> and <a shape="rect" href="wsdl-to-java.html">Maven</a>.)</p><h3 id="WSDLtoJava-Usingwsdl2javawithAnt">Using wsdl2java with Ant</h3><p>The wsdl2java command can be wrapped inside an Ant target as shown below:</p><div class="code panel pdl" style="border-wid
th: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"><?xml version="1.0"?>
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"><?xml version="1.0"?>
<project name="cxf wsdl2java" basedir=".">
<property name="cxf.home" location ="/usr/myapps/cxf-2.5.1"/>
@@ -156,7 +157,7 @@ Apache CXF -- WSDL to Java
</project>
</pre>
</div></div><p>Make sure you set the "fork=true" attribute for the <java/> task as shown above. Also, remember to keep each word or flag within the command line options in its own <arg/> element (e.g., do not use <arg value="-d src"/>, but split them up into two <arg/> elements as done here.)</p><p>Although we would recommend using Maven, see the <a shape="rect" class="external-link" href="http://svn.apache.org/viewvc/cxf/trunk/distribution/src/main/release/samples/antbuild/">antbuild sample</a> in the CXF distribution for an example of using Ant to create a CXF project.</p><h2 id="WSDLtoJava-JAXWSCustomization">JAXWS Customization</h2><p>The default JAX-WS frontend created by wsdl2java can be customized by using a customization binding file. For an example, see the <a shape="rect" class="external-link" href="http://svn.apache.org/viewvc/cxf/trunk/distribution/src/main/release/samples/jaxws_async/wsdl/async_binding.xml?view=markup">async_binding.xml</a> file
in samples/jaxws_async – if specified when running wsdl2java, it will generate asynchronous methods in the SEI.</p><p><strong>Q: What if I want to change the generated SEI name?</strong></p><p>A: We don't have a command-line option to do this, but you can have a binding file like the following snippet to achieve this goal</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"><bindings
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"><bindings
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
wsdlLocation="hello_world.wsdl"
@@ -167,7 +168,7 @@ Apache CXF -- WSDL to Java
</bindings>
</pre>
</div></div><p><strong>Q: How do I pass the binding file to wsdl2java?</strong></p><p>A: If you are using wsdl2java via command line tool:</p><p>wsdl2java HelloWorld.wsdl -b my_binding.xml</p><p>For Ant, follow the example above on how to add "-b" and "my_binding.xml" as arg elements.</p><p>For Maven see <a shape="rect" href="maven-cxf-codegen-plugin-wsdl-to-java.html">cxf-codegen-plugin</a></p><p><strong>Q: How to map xsd:dateTime to java.util.Date?</strong><br clear="none"> Well, people don't like the XMLGregorianCalendar which is the default mapping from the xsd:dateTime (xsd:time and xsd:date as well),<br clear="none"> We can use the jaxws customization to change the default mapping, here are some sample binding files<br clear="none"> If you have schema inside the wsdl, here is the binding file you can use:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;"><jaxws:bindings wsdlLocation="YOUR_WSDL_LOCATION"
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"><jaxws:bindings wsdlLocation="YOUR_WSDL_LOCATION"
xmlns:jaxws="http://java.sun.com/xml/ns/jaxws"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:jxb="http://java.sun.com/xml/ns/jaxb"
@@ -182,13 +183,13 @@ Apache CXF -- WSDL to Java
</jaxws:bindings>
</pre>
</div></div><p>This requires an additional dependency:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;"><dependency>
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"><dependency>
<groupId>org.apache.cxf.xjc-utils</groupId>
<artifactId>cxf-xjc-runtime</artifactId>
</dependency>
</pre>
</div></div><p> </p><p>If you want to use java.util.Calendar, just change the org.apache.cxf.xjc.runtime.DataTypeAdapter to javax.xml.bind.DatatypeConverter, and change the name value to "java.util.Calendar"</p><p>If your schema is out of wsdl, here is an example you can try:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;"><jxb:bindings version="2.0"
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"><jxb:bindings version="2.0"
xmlns:jxb="http://java.sun.com/xml/ns/jaxb"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<jxb:bindings schemaLocation="file:<path><name>.xsd" node="/xs:schema">
@@ -201,7 +202,7 @@ Apache CXF -- WSDL to Java
</jxb:bindings>
</pre>
</div></div><p><span class="confluence-anchor-link" id="WSDLtoJava-wrapperstyle"></span><br clear="none"> <strong>Q: How can I switch my generated web service method calls from wrapper style to non wrapper-style (or vice-versa)?</strong></p><p>A: Create an external binding file and set the value of <enableWrapperStyle/> to true or false as desired:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;"><jaxws:bindings
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"><jaxws:bindings
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
wsdlLocation="your.wsdl"
@@ -211,7 +212,7 @@ Apache CXF -- WSDL to Java
</jaxws:bindings>
</pre>
</div></div><p>Alternatively you can embed this instruction within the WSDL file directly, as the immediate child of the wsdl:portType:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;"><wsdl:portType name="MyWebServicePortType">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"><wsdl:portType name="MyWebServicePortType">
<jaxws:bindings xmlns:jaxws="http://java.sun.com/xml/ns/jaxws">
<jaxws:enableWrapperStyle>false</jaxws:enableWrapperStyle>
... other binding settings if needed ...
Modified: websites/production/cxf/content/docs/wspconfiguration.html
==============================================================================
--- websites/production/cxf/content/docs/wspconfiguration.html (original)
+++ websites/production/cxf/content/docs/wspconfiguration.html Tue Sep 12 19:09:41 2017
@@ -136,7 +136,7 @@ Apache CXF -- WSPConfiguration
<p>For example, to apply this feature to the bus and prevent exceptions being thrown when encountering unknown assertions:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;">
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:cxf="http://cxf.apache.org/core"
xmlns:p="http://cxf.apache.org/policy"
@@ -164,7 +164,7 @@ http://www.springframework.org/schema/be
<p>The following configuration achieves the same as in the example above:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;">
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:cxf="http://cxf.apache.org/core"
xmlns:p="http://cxf.apache.org/policy"
@@ -192,7 +192,7 @@ http://www.springframework.org/schema/be
<p>Example:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;">
<p:externalAttachment location="classpath:org/apache/cxf/systest/ws/policy/addr-external.xml"/>
</pre>
</div></div>
Modified: websites/production/cxf/content/docs/wsrmconfiguration.html
==============================================================================
--- websites/production/cxf/content/docs/wsrmconfiguration.html (original)
+++ websites/production/cxf/content/docs/wsrmconfiguration.html Tue Sep 12 19:09:41 2017
@@ -117,14 +117,14 @@ Apache CXF -- WSRMConfiguration
<!-- Content -->
<div class="wiki-content">
<div id="ConfluenceContent"><h1 id="WSRMConfiguration-UsingWS-ReliableMessaging">Using WS-Reliable Messaging</h1><p>To make a message exchange between two endpoints reliable, you need to ensure that the RM interceptors and (as WS-Reliable messaging has a dependency on WS-Addressing) the addressing interceptors are added to the interceptor chains. This can be achieved in one of the following ways:</p><h2 id="WSRMConfiguration-UsingtheRMAssertionandtheCXFWS-PolicyFramework">Using the RMAssertion and the CXF WS-Policy Framework</h2><p>If</p><ol><li>A Policy with an RMAssertion element is attached to the wsdl:service element (or any other wsdl element that according to the rules for WS-Policy Attachment is an attachment point for Policy or PolicyReference elements)</li><li>The CXF WS-Policy Framework is enabled</li></ol><p>the RM interceptors will be automatically added to their respective interceptor chains by the policy framework. The assertion attributes control the behavior of the s
ource/destination.</p><p>For example, to enable the WS-Policy Framework on the server side, you configuration file could look like this:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"><jaxws:endpoint ...>
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"><jaxws:endpoint ...>
<jaxws:features>
<p:policies/>
</jaxws:features>
</jaxws:endpoint>
</pre>
</div></div><p>and your wsdl:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"><wsp:Policy wsu:Id="RM" xmlns:wsp="http://www.w3.org/2006/07/ws-policy"
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"><wsp:Policy wsu:Id="RM" xmlns:wsp="http://www.w3.org/2006/07/ws-policy"
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<wsam:Addressing xmlns:wsam="http://www.w3.org/2007/02/addressing/metadata">
<wsp:Policy/>
@@ -142,7 +142,7 @@ xmlns:wsu="http://docs.oasis-open.org/ws
</wsdl:service>
</pre>
</div></div><p>Instead of attaching the PolicyReference attached to the wsdl:port element, you can also specify it as a child element of the policies features, e.g. for the server endpoint:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"><wsp:Policy wsu:Id="RM" xmlns:wsp="http://www.w3.org/2006/07/ws-policy" ...>
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"><wsp:Policy wsu:Id="RM" xmlns:wsp="http://www.w3.org/2006/07/ws-policy" ...>
</wsp:Policy>
<jaxws:endpoint ...>
@@ -154,7 +154,7 @@ xmlns:wsu="http://docs.oasis-open.org/ws
</jaxws:endpoint>
</pre>
</div></div><p>As of CXF 3.0.0 both the older WS-ReliableMessagingPolicy 1.0 (submission version) and the official WS-ReliableMessagingPolicy 1.2 are supported. WS-ReliableMessagingPolicy 1.2 must be used in the policy if you want WS-ReliableMessaging 1.2 support at runtime.</p><h2 id="WSRMConfiguration-UsingtheReliableMessagingFeature">Using the Reliable Messaging Feature</h2><p>If you don't want to involve the WS-Policy Framework, or want to configure additional parameters such as the sequence termination policy or the persistent store, you can use the reliableMessaging feature. It is defined in namespace <a shape="rect" href="http://cxf.apache.org/ws/rm/manager">http://cxf.apache.org/ws/rm/manager</a> and supports the following child elements:</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Name</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Value</p></th></tr><tr><td colspan="1" rowspan="1" cla
ss="confluenceTd"><p>RMAssertion</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>An element of type RMAssertion.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>deliveryAssurance</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>An element of type DeliveryAssuranceType that describes the delivery assurance that should apply (AtMostOnce, AtLeastOnce, InOrder).</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>sourcePolicy</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>An element of type SourcePolicyType that allows you to configure details of the RM source, such as whether an offer should always be included in a CreateSequence request, or the sequence termination policy.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>destinationPolicy</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>An element of type DestinationPolicyType that allows you to configure details of the RM destinat
ion, such as whether inbound offers should be accepted.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>store</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>The store to use (default: null). This must be an element of type jdbcStore (in the same namespace), or a bean or a reference to a bean that implements the RMStore interface.</p></td></tr></tbody></table></div><p>For details about the element types used in this namespace please refer to the schemas for the <a shape="rect" href="http://cxf.apache.org/ws/rm/manager">http://cxf.apache.org/ws/rm/manager</a> namespace (<a shape="rect" href="http://cxf.apache.org/schemas/configuration/wsrm-manager.xsd">http://cxf.apache.org/schemas/configuration/wsrm-manager.xsd</a> and <a shape="rect" href="http://cxf.apache.org/schemas/configuration/wsrm-manager-types.xsd">http://cxf.apache.org/schemas/configuration/wsrm-manager-types.xsd</a>). The jbdcStore element type is described below.</p><p>Example (feature ap
plied at bus level):</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"><cxf:bus>
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"><cxf:bus>
<cxf:features>
<wsa:addressing/>
<wsrm-mgr:reliableMessaging>
@@ -174,13 +174,13 @@ xmlns:wsu="http://docs.oasis-open.org/ws
</cxf:bus>
</pre>
</div></div><h2 id="WSRMConfiguration-ConfiguringtheReliableMessagingStore">Configuring the Reliable Messaging Store</h2><p>To enable persistence, you must specify the object implementing the persistent store for RM. You can develop your own, or use the JDBC based store that comes with CXF (class org.apache.cxf.ws.rm.persistence.jdbc.RMTxStore). You can configure the latter using a custom jdbcStore bean (namespace <a shape="rect" href="http://cxf.apache.org/ws/rm/manager">http://cxf.apache.org/ws/rm/manager</a>) inside the wsrm-mgr:reliableMessaging element. The jdbcStore bean supports the attributes:</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Attribute Name</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Type</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Default</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>dataSource</p></td><td colspan="1" rowspan="1" cla
ss="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>null</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>driverClassName</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>org.apache.derby.jdbc.EmbeddedDriver</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>initialReconnectDelay</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>long</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>0</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>keepConnection</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>boolean</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>false</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>maxReconnectAttempts</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>int</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>0</p>
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>passWord</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>null</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>tableExistsCode</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>int</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>0</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>tableExistsState</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>null</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>schemaName</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>null</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>userName</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>String</p><
/td><td colspan="1" rowspan="1" class="confluenceTd"><p>null</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>url</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>String</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>jdbc:derby:rmdb;create=true</p></td></tr></tbody></table></div><p>Example:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"><wsrm-mgr:jdbcStore xmlns:wsrm-mgr="http://cxf.apache.org/ws/rm/manager" id="myStore"
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"><wsrm-mgr:jdbcStore xmlns:wsrm-mgr="http://cxf.apache.org/ws/rm/manager" id="myStore"
driverClassName="org.apache.derby.jdbc.ClientDriver"
url="jdbc:derby://localhost:1527/rmdb;create=true"
password="password"/>
</pre>
</div></div><p>See the jdbcStore element definition in the <a shape="rect" href="http://cxf.apache.org/schemas/configuration/wsrm-manager.xsd">RM Manager schema</a> for more details of the attribute usages.</p><h2 id="WSRMConfiguration-AddingtheReliableMessagingInterceptorsManually">Adding the Reliable Messaging Interceptors Manually</h2><p>To ensure that the Reliable Messaging interceptors are added to the appropriate interceptor chains, e.g. for all client and server endpoints:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"><bean id="rmLogicalOut" class="org.apache.cxf.ws.rm.RMOutInterceptor">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"><bean id="rmLogicalOut" class="org.apache.cxf.ws.rm.RMOutInterceptor">
<property name="bus" ref="cxf"/>
</bean>
<bean id="rmLogicalIn" class="org.apache.cxf.ws.rm.RMInInterceptor">
@@ -208,7 +208,7 @@ xmlns:wsu="http://docs.oasis-open.org/ws
</cxf:bus>
</pre>
</div></div><p>The RetransmissionIntercepor will be added on the fly by the RMOutInterceptor so need not appear in your configuration file.</p><h2 id="WSRMConfiguration-ConfiguringtheReliableMessagingManagerManually">Configuring the Reliable Messaging Manager Manually</h2><p>To configure properties of the RM Manager, you can use the rmManager element from the <a shape="rect" href="http://cxf.apache.org/ws/rm/manager">http://cxf.apache.org/ws/rm/manager</a> namespace. It supports the same child elements as the reliableMessaging feature element above. For example, without using features, you can determine that seuences should have a maximum length of 5 as follows:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"><wsrm-mgr:rmManager xmlns:wsrm-mgr="http://cxf.apache.org/ws/rm/manager">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"><wsrm-mgr:rmManager xmlns:wsrm-mgr="http://cxf.apache.org/ws/rm/manager">
<wsrm-mgr:sourcePolicy>
<wsrm-mgr:sequenceTerminationPolicy maxLength="5"/>
</wsrm-mgr:sourcePolicy>
Modified: websites/production/cxf/content/docs/xfire-migration-guide.html
==============================================================================
--- websites/production/cxf/content/docs/xfire-migration-guide.html (original)
+++ websites/production/cxf/content/docs/xfire-migration-guide.html Tue Sep 12 19:09:41 2017
@@ -32,8 +32,8 @@
<link type="text/css" rel="stylesheet" href="/resources/highlighter/styles/shThemeCXF.css">
<script src='/resources/highlighter/scripts/shCore.js'></script>
-<script src='/resources/highlighter/scripts/shBrushJava.js'></script>
<script src='/resources/highlighter/scripts/shBrushXml.js'></script>
+<script src='/resources/highlighter/scripts/shBrushJava.js'></script>
<script>
SyntaxHighlighter.defaults['toolbar'] = false;
SyntaxHighlighter.all();
@@ -118,11 +118,11 @@ Apache CXF -- XFire Migration Guide
<!-- Content -->
<div class="wiki-content">
<div id="ConfluenceContent"><style type="text/css">/*<![CDATA[*/
-div.rbtoc1435780173861 {padding: 0px;}
-div.rbtoc1435780173861 ul {list-style: disc;margin-left: 0px;padding-left: 20px;}
-div.rbtoc1435780173861 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1505243037126 {padding: 0px;}
+div.rbtoc1505243037126 ul {list-style: disc;margin-left: 0px;padding-left: 20px;}
+div.rbtoc1505243037126 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style><div class="toc-macro rbtoc1435780173861">
+/*]]>*/</style><div class="toc-macro rbtoc1505243037126">
<ul class="toc-indentation"><li><a shape="rect" href="#XFireMigrationGuide-CompletedFunctionalityandCXFanalogues">Completed Functionality and CXF analogues</a></li><li><a shape="rect" href="#XFireMigrationGuide-ShouldIMigrateYet?">Should I Migrate Yet?</a>
<ul class="toc-indentation"><li><a shape="rect" href="#XFireMigrationGuide-Whoshouldnotmigrate">Who should not migrate</a></li></ul>
</li><li><a shape="rect" href="#XFireMigrationGuide-ServiceFactories">Service Factories</a>
@@ -170,7 +170,7 @@ div.rbtoc1435780173861 li {margin-left:
<div class="sectionMacroRow"><div class="columnMacro" style="width:50%;min-width:50%;max-width:50%;">
<p>Here is an example of using the ObjectServiceFactory in XFire:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;">
ObjectServiceFactory osf = new ObjectServiceFactory();
Service service = osf.create(MyServiceInterface.class);
service.setInvoker(new BeanInvoker(new MyServiceImpl());
@@ -179,7 +179,7 @@ service.setInvoker(new BeanInvoker(new M
<div class="columnMacro">
<p>This would be the CXF equivalent:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;">
ServerFactoryBean sf = new ServerFactoryBean();
sf.getServiceFactory().setDataBinding(new AegisDatabinding();
sf.setServiceBean(new MyServiceImpl());
@@ -195,7 +195,7 @@ sf.create();
<div class="sectionMacroRow"><div class="columnMacro" style="width:50%;min-width:50%;max-width:50%;">
<p>Here is an example of using the AnnotationServiceFactory in XFire:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;">
AnnotationServiceFactory osf = new AnnotationServiceFactory();
Service service = osf.create(MyServiceInterface.class);
service.setInvoker(new BeanInvoker(new MyServiceImpl());
@@ -204,7 +204,7 @@ service.setInvoker(new BeanInvoker(new M
<div class="columnMacro">
<p>This would be the CXF equivalent:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;">
JaxWsServerFactoryBean sf = new JaxWsServerFactoryBean ();
sf.getServiceFactory().setDataBinding(new AegisDatabinding());
sf.setServiceClass(MyServiceImpl.class);
@@ -219,7 +219,7 @@ sf.create();
<div class="sectionMacroRow"><div class="columnMacro" style="width:50%;min-width:50%;max-width:50%;">
<p>Here is an example of using the JAXWSServiceFactory in XFire:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;">
JAXWSServiceFactory sf = new JAXWSServiceFactory();
Service service = sf.create(MyServiceImpl.class);
service.setInvoker(new BeanInvoker(new MyServiceImpl());
@@ -228,7 +228,7 @@ service.setInvoker(new BeanInvoker(new M
<div class="columnMacro">
<p>This would be the CXF equivalent:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;">
JaxWsServerFactoryBean sf = new JaxWsServerFactoryBean();
sf.setServiceClass(MyServiceImpl.class);
sf.setAddress("http://localhost:8080/myservice");
@@ -253,7 +253,7 @@ sf.create();
<div class="sectionMacroRow"><div class="columnMacro" style="width:50%;min-width:50%;max-width:50%;">
<p>XFire services.xml example:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;">
<beans xmlns="http://xfire.codehaus.org/config/1.0">
<service xmlns:t="urn:my:namespace">
@@ -279,7 +279,7 @@ sf.create();
<div class="columnMacro">
<p>CXF example:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;">
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:jaxws="http://cxf.apache.org/jaxws"
@@ -315,7 +315,7 @@ http://cxf.apache.org/schemas/jaxws.xsd"
<p>The above sample is for JAX-WS/JSR181 services. For those developing services without annotations, here's an example for the <a shape="rect" href="simple-frontend.html">Simple Frontend</a>"</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;">
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:simple="http://cxf.apache.org/simple"
Modified: websites/production/cxf/content/docs/xml-key-management-service-xkms.html
==============================================================================
--- websites/production/cxf/content/docs/xml-key-management-service-xkms.html (original)
+++ websites/production/cxf/content/docs/xml-key-management-service-xkms.html Tue Sep 12 19:09:41 2017
@@ -117,7 +117,7 @@ Apache CXF -- XML Key Management Service
<!-- Content -->
<div class="wiki-content">
<div id="ConfluenceContent"><h1 id="XMLKeyManagementService(XKMS)-XMLKeyManagementService(XKMS)">XML Key Management Service (XKMS)</h1><p>Available since CXF 2.7.7.</p><h2 id="XMLKeyManagementService(XKMS)-Usecase">Use case</h2><p>CXF uses asymmetric algorithms for different purposes: encryption of symmetric keys and payloads, signing security tokens and messages, proof of possession, etc.<br clear="none"> Normally the public keys (in the form of X509 certificates) are stored in java keystores.</p><p>For example, if the sender encrypts the message payload sending to the receiver, he should have access to the receiver certificate saved in the local keystore. <br clear="none"> The sender uses this certificate for message encryption and receiver decrypts the request with the corresponding private key:</p><p><span class="confluence-embedded-file-wrapper"><img class="confluence-embedded-image" src="xml-key-management-service-xkms.data/classic-message-encryption.jpg"></span></p><p>Seems t
o be OK? Imagine now that you have a production environment with 100 different clients of this service and the service certificate is expired. You should reissue and replace the certificate in ALL client keystores! Even more, if keystores are packaged into war files or OSGi bundles – they should be unpackaged and updated. Not really acceptable for enterprise environments.</p><p>Therefore large service landscapes support central certificates management. It means that X509 certificates are not stored locally in keystores, but are provided and administrated centrally.</p><p>Normally it is a responsibility of <a shape="rect" class="external-link" href="http://en.wikipedia.org/wiki/Public-key_infrastructure" rel="nofollow">Public Key Infrastructure</a> (PKI) established in the organization. PKI is responsible to create, manage, store, distribute, synchronize and revoke public certificates and certification authorities (CAs).</p><h2 id="XMLKeyManagementService(XKMS)-XKMSSpecificatio
n">XKMS Specification</h2><p>W3C specifies a protocol to distribute and register public keys, certificates and CAs that can be used for XML-based cryptography, including signature and encryption: <a shape="rect" class="external-link" href="http://www.w3.org/TR/xkms2/" rel="nofollow">XML Key Management Specification</a> (XKMS 2.0). <br clear="none"> The XKMS Specification comprises two parts – the XML Key Information Service Specification (XKISS) describing the runtime aspects of key lookup and certificate validation, and the XML Key Registration Service Specification (XKRSS) describing the administrative aspects of registering, renewing, revoking and recovering certificates. <br clear="none"> The XKMS Service implements both parts of specification.</p><p>The XKMS SOAP interface can be used as a standard frontend to access the Public Key Infrastructure (PKI). Using XKMS message encryption scenario, the message encryption picture will change in the following way:</p><p><span cla
ss="confluence-embedded-file-wrapper"><img class="confluence-embedded-image" src="xml-key-management-service-xkms.data/classic-message-encryption-PKI-XKMS.jpg"></span></p><p>Receiver X509 certificate is not saved into sender's local keystore anymore. Instead, certificate is stored into central PKI and can be located, validated and administrated using standard XKMS interface. This essentially improves the control on certificates in large services landscape.</p><p>Administrator can update, renew and revoke certificates, manage certification authorities and revocation lists.</p><h3 id="XMLKeyManagementService(XKMS)-IntegratingtheXKMSclientintotheCXFruntime">Integrating the XKMS client into the CXF runtime</h3><p>The XKMS client can be integrated into CXF and WSS4J in pretty elegant way using a custom Crypto provider implementation. In this case, the XKMS service will be automatically invoked when WSS4J asks for the certificates or validates them. Details are described in this <a shape=
"rect" class="external-link" href="http://ashakirin.blogspot.de/2013/04/cxf-security-getting-certificates-from.html" rel="nofollow">blog</a>. A basic XKMS implementation of WSS4J Crypto interface is available in XKMS Client component (XKMSCryptoProvider and XKMSCryptoProviderFactory). Implementation uses Ehcache to cache certificates received from XKMS service.</p><h3 id="XMLKeyManagementService(XKMS)-XKMSServiceDesign">XKMS Service Design</h3><p>Internal structure of XKMS service is represented in the following figure:</p><p><span class="confluence-embedded-file-wrapper"><img class="confluence-embedded-image" src="xml-key-management-service-xkms.data/XKMS-cxf.jpg"></span></p><p>The XKMS Service exposes a SOAP interface specified in <a shape="rect" class="external-link" href="http://www.w3.org/TR/xkms2/" rel="nofollow">XKMS 2.0</a>. <br clear="none"> The XKMS implementation realizes <a shape="rect" class="external-link" href="http://en.wikipedia.org/wiki/Chain-of-responsibility_patt
ern" rel="nofollow">chain of responsibility design pattern </a>.<br clear="none"> Each XKMS operation defines a handler interface and provides one or more implementations of this interface. Handler implementations are connected into a chain. <br clear="none"> Operation implementation invokes handlers one after another from the pre-configured chain until either all handlers will be processed or a critical error will occur. <br clear="none"> This design makes the XKMS internal implementation quite flexible: it is easy to add/remove handlers, change their order, introduce handlers supporting new backends, etc. <br clear="none"> For example, a certificate can be searched firstly in the LDAP repository by LDAP lookup handler and, if it is not found there, additionally looked for in a remote PKI using an appropriate lookup handler. Validation operation logic is organized in a chain is well: first validation handler checks format and expiry date of the X509 certificate, next one checks the
certificate trust chain.</p><p>Currently the XKMS Service supports simple file based and LDAP backends.<br clear="none"> Sample spring configuration of XKMS handlers looks like:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"><beans xmlns="http://www.springframework.org/schema/beans"
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"><beans xmlns="http://www.springframework.org/schema/beans"
xmlns:cxf="http://cxf.apache.org/core" xmlns:jaxws="http://cxf.apache.org/jaxws"
xmlns:test="http://apache.org/hello_world_soap_http" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:util="http://www.springframework.org/schema/util"
@@ -190,7 +190,7 @@ Apache CXF -- XML Key Management Service
</beans>
</pre>
</div></div><p>The dateValidator and trustedAuthorityValidator beans are implementations of the Validator interface for date and trusted chain validation. <br clear="none"> x509Locator and x509Register are implementations of Locator and Register interfaces for X509 certificates.<br clear="none"> certificateRepo is the repository implementation for LDAP backend. LdapSearch and LdapSchemaConfig contain LDAP configuration described in the following table:</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Property</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Sample Value</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>ldapServerConfig arguments</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>URL, baseDN and credentials of LDAP Server
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>certObjectClass</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>inetOrgPerson</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>LDAP object class used to store certificates</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>attrUID</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>uid</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Attribute containing X509 subject DN</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>attrIssuerID</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>manager</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>LDAP attribute containing X509 issuer DN</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>attrSerialNumber</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>employeeNumber</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>LDAP attribute contain
ing X509 serial number</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">attrEndpoint</td><td colspan="1" rowspan="1" class="confluenceTd">labeledURI</td><td colspan="1" rowspan="1" class="confluenceTd">LDAP attribute containing service endpoint (used in case of endpoint based lookup)</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>attrCrtBinary</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>userCertificate</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>LDAP attribute containing X509 certificate content</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>constAttrNamesCSV</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>sn</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Comma separated list of mandatory LDAP attributes</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>constAttrValuesCSV</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>X509 certificate</p><
/td><td colspan="1" rowspan="1" class="confluenceTd"><p>Comma separated list of mandatory LDAP attributes values</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>serviceCertRDNTemplate</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>cn=%s,ou=services</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Relative distinguished name for service certificates</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>serviceCertUIDTemplate</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>cn=%s</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Template to transform service QName to DN for storing into attrUID</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>trustedAuthorityFilter</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>(&(objectClass=inetOrgPerson)(ou:dn:=CAs))</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Filter to determine trusted CAs for trusted chain validat
ion</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>intermediateFilter</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>(objectClass=inetOrgPerson)</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Filter to determine intermediate certificates for trusted chain validation</p></td></tr></tbody></table></div><h4 id="XMLKeyManagementService(XKMS)-Supportedcertificatestypes.">Supported certificates types.</h4><p>XKMS distinguishes between the following types of X509 certificates:</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Type</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>User</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Normal user X509 certificate</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Service</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Certificate identifies service. Required application "urn:apache:cxf:service:soap" by lookup and registration. Identified as {SERVICE_ NAMESPACE}SERVICE_NAME</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Trusted CA</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>CAs used as trusted anchor by certificates validations. Trusted CAs can be retrieved using trustedAuthorityFilter property</p></td></tr></tbody></table></div><p>XKMS service endpoint is configured in the following way:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"> <bean id="xkmsProviderBean" class="org.apache.cxf.xkms.service.XKMSService">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"> <bean id="xkmsProviderBean" class="org.apache.cxf.xkms.service.XKMSService">
<property name="validators">
<list>
<ref bean="dateValidator" />
@@ -216,7 +216,7 @@ Apache CXF -- XML Key Management Service
</jaxws:endpoint>
</pre>
</div></div><h4 id="XMLKeyManagementService(XKMS)-DataFormats">Data Formats</h4><p>Input and output data formats are specified in XML Key Management Service Specification Version 2.0 (see <a shape="rect" class="external-link" href="http://www.w3.org/TR/xkms2/" rel="nofollow">XKMS 2.0</a>). The XKMS service supports only a subset of the specified requests and responses.<br clear="none"> Restrictions of formats for request and responses are described in the following table:</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Element XPath</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Supporting values</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1" rowspan="3" class="confluenceTd"><p>RootElement/QueryKeyBinding/UseKeyWith@Application</p><p> </p><p> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>urn:ietf:rfc:2459</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Application specifies X509 SubjectDN in Identifier attribute. Used for normal users certificates</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>urn:apache:cxf:service:name</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Application specifies service name in Identifier attribute as {SERVICE_ NAMESPACE}SERVICE_NAME. Used for service certificates</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">urn:apache:cxf:service:endpoint</td><td colspan="1" rowspan="1" class="confluenceTd">Application specifies service endpoint in Identifier attribute</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>RootElement/QueryKeyBinding/UseKeyWith@Identifier</p></td><td colspan="1" rowspan="1" class="confluenceTd"><ul><li>X509 Subject DN;</li><li>Service name as {SERVICE_ NAMESPACE}SERVICE_NAME</li><li>Service endpoint</li></ul></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Depending
on Application attribute public key is identified as X509 Subject DN or Service nameservice certificates</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>RootElement/UnverifiedKeyBinding/KeyInfo</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>X509Data/X509Certificate</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Only X509Data with X509Certificate is supported</p></td></tr></tbody></table></div><h4 id="XMLKeyManagementService(XKMS)-ErrorHandling">Error Handling</h4><p>Success and Fault Response formats are specified in <a shape="rect" class="external-link" href="http://www.w3.org/TR/xkms2/" rel="nofollow">XKMS 2.0</a>. Error conditions in XKMS service are reported using ResultMajor and ResultMinor attributes in the root response element.<br clear="none"> The XKMS Service uses the following values for response codes:</p><p>ResultMajor</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="c
onfluenceTh"><p>Value</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Success</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>The operation succeeded.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Receiver</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>An error occurred at the receiver.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Sender</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>An error occurred that was due to the message sent by the sender.</p></td></tr></tbody></table></div><p>ResultMinor</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Value</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Failure</p></td><td colspan="1" rowspan="1" clas
s="confluenceTd"><p>The service attempted to perform the request but the operation failed.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>NoMatch</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>No match was found for the search prototype provided.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>TooManyResponses</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>The request resulted in the number of responses that exceeded limit determined by the service.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>TimeInstantNotSupported</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>The receiver has refused the operation because it does not support the TimeInstant element.</p></td></tr></tbody></table></div><h4 id="XMLKeyManagementService(XKMS)-Deployment">Deployment</h4><p>The XKMS Service can be deployed into web and OSGi containers. The Service implementation was tested with Tomcat and Karaf.</p
><h4 id="XMLKeyManagementService(XKMS)-SampleRequestsandResponses">Sample Requests and Responses</h4><p>Sample request for Locate operation:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"><soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"><soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:LocateRequest xmlns="http://www.w3.org/2000/09/xmldsig#"
xmlns:ns2="http://www.w3.org/2002/03/xkms#"
@@ -232,7 +232,7 @@ O=Sample Client -- NOT FOR PRODUCTION, L
</soap:Envelope>
</pre>
</div></div><p>Sample response for Locate operation:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"><soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"><soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:LocateResult ResultMajor="http://www.w3.org/2002/03/xkms#Success"
RequestId="I047257513d19456687e6b4f4a2a72606" Id="I0758390284847918129574923948"
@@ -253,7 +253,7 @@ O=Sample Client -- NOT FOR PRODUCTION, L
</soap:Envelope>
</pre>
</div></div><p>Sample error message:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"><soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"><soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:LocateResult ResultMajor="http://www.w3.org/2002/03/xkms#Receiver"
ResultMinor="http://www.w3.org/2002/03/xkms#Failure"
Modified: websites/production/cxf/content/docs/xmlbeans.html
==============================================================================
--- websites/production/cxf/content/docs/xmlbeans.html (original)
+++ websites/production/cxf/content/docs/xmlbeans.html Tue Sep 12 19:09:41 2017
@@ -32,8 +32,8 @@
<link type="text/css" rel="stylesheet" href="/resources/highlighter/styles/shThemeCXF.css">
<script src='/resources/highlighter/scripts/shCore.js'></script>
-<script src='/resources/highlighter/scripts/shBrushJava.js'></script>
<script src='/resources/highlighter/scripts/shBrushXml.js'></script>
+<script src='/resources/highlighter/scripts/shBrushJava.js'></script>
<script>
SyntaxHighlighter.defaults['toolbar'] = false;
SyntaxHighlighter.all();
@@ -132,7 +132,7 @@ Apache CXF -- XMLBeans
<p>For the server side, your spring configuration would contain something like:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;">
<jaxws:server serviceClass="demo.hw.server.HelloWorld" address="/hello_world">
<jaxws:dataBinding>
<bean class="org.apache.cxf.xmlbeans.XmlBeansDataBinding" />
@@ -142,7 +142,7 @@ Apache CXF -- XMLBeans
</div></div>
<p>or</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;">
<jaxws:endpoint
id="helloWorld"
implementor="demo.spring.HelloWorldImpl"
@@ -156,7 +156,7 @@ Apache CXF -- XMLBeans
<p>The client side is very similar:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;">
<jaxws:client id="helloClient"
serviceClass="demo.spring.HelloWorld"
address="http://localhost:9002/HelloWorld">
@@ -173,7 +173,7 @@ Apache CXF -- XMLBeans
<p>If using programmatic factory beans instead of spring configuration, the databinding can be set on the ClientProxyFactoryBean (and subclasses) and the ServerFactoryBean (and subclasses) via:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;">
factory.getServiceFactory().setDataBinding(new org.apache.cxf.xmlbeans.XmlBeansDataBinding());
</pre>
</div></div></div>
Modified: websites/production/cxf/content/docs/xslt-feature.html
==============================================================================
--- websites/production/cxf/content/docs/xslt-feature.html (original)
+++ websites/production/cxf/content/docs/xslt-feature.html Tue Sep 12 19:09:41 2017
@@ -32,8 +32,8 @@
<link type="text/css" rel="stylesheet" href="/resources/highlighter/styles/shThemeCXF.css">
<script src='/resources/highlighter/scripts/shCore.js'></script>
-<script src='/resources/highlighter/scripts/shBrushJava.js'></script>
<script src='/resources/highlighter/scripts/shBrushXml.js'></script>
+<script src='/resources/highlighter/scripts/shBrushJava.js'></script>
<script>
SyntaxHighlighter.defaults['toolbar'] = false;
SyntaxHighlighter.all();
@@ -118,20 +118,20 @@ Apache CXF -- XSLT Feature
<!-- Content -->
<div class="wiki-content">
<div id="ConfluenceContent"><h1 id="XSLTFeature-XSLTFeature">XSLT Feature</h1><p><style type="text/css">/*<![CDATA[*/
-div.rbtoc1435780133690 {padding: 0px;}
-div.rbtoc1435780133690 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1435780133690 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1505242988766 {padding: 0px;}
+div.rbtoc1505242988766 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1505242988766 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1435780133690">
+/*]]>*/</style></p><div class="toc-macro rbtoc1505242988766">
<ul class="toc-indentation"><li><a shape="rect" href="#XSLTFeature-XSLTFeature">XSLT Feature</a></li><li><a shape="rect" href="#XSLTFeature-WhenshouldIuseTransformationFeatureandwhenXSLTFeature?">When should I use Transformation Feature and when XSLT Feature?</a></li><li><a shape="rect" href="#XSLTFeature-Springconfiguration">Spring configuration</a></li><li><a shape="rect" href="#XSLTFeature-ConfiguringtheXSLTFeaturefromtheSpring/Bluepring">Configuring the XSLT Feature from the Spring/Bluepring</a></li><li><a shape="rect" href="#XSLTFeature-ConfiguringtheXSLTinterceptorsincode">Configuring the XSLT interceptors in code</a></li><li><a shape="rect" href="#XSLTFeature-XSLTinterceptorsandphases">XSLT interceptors and phases</a></li><li><a shape="rect" href="#XSLTFeature-Supportedmessagecontents">Supported message contents</a></li></ul>
</div><p>The CXF XSLT Feature is alternative to <a shape="rect" href="http://cxf.apache.org/docs/transformationfeature.html">CXF Transformation Feature</a> providing flexible way to do the dynamic transformations of XML messages. <br clear="none"> XSLT Feature applies custom XSL transformations to inbound and/or outbound messages.</p><h1 id="XSLTFeature-WhenshouldIuseTransformationFeatureandwhenXSLTFeature?">When should I use Transformation Feature and when XSLT Feature?</h1><p>If only trivial transformations must be done, it is recommended to use lightweight and fast Transformation Feature. It covers the most use cases as:</p><ul><li>dropping the namespace of the outbound messages;</li><li>qualifying the incoming message;</li><li>changing namespaces;</li><li>appending or dropping elements;</li><li>converting attributes to elements.</li></ul><p>Transformation Feature is completely stream oriented and work fast especially for large messages.</p><p>If you should apply non-trivial tran
sformation, not supported by Transformation Feature - it is use case for XSLT Feature. Here you can write any custom XSL Transformation and apply it to inbound and/or outbound messages.<br clear="none"> As far as Xalan XSLT engine is actually not completely stream oriented, XSLT Feature breaks streaming. However it uses high-performance DTM (Document Table Model) instead complete DOM model.<br clear="none"> Performance can be improved in the future by using further versions of Xalan or other XSLT engines (like Saxon or STX oriented Joost).</p><h1 id="XSLTFeature-Springconfiguration">Spring configuration</h1><p>It is necessary to configure XSLT script for inbound or/and outbound transformation. Example:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"> <bean id="xsltFeature" class="org.apache.cxf.feature.transform.XSLTFeature">
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"> <bean id="xsltFeature" class="org.apache.cxf.feature.transform.XSLTFeature">
<property name="inXSLTPath" value="requestTransformation.xsl" />
<property name="outXSLTPath" value="responseTransformation.xsl" />
</bean>
</pre>
</div></div><p>The XSLT scripts should be available from the classpath. If XSLT path is not specified, no transformation will be done.</p><h1 id="XSLTFeature-ConfiguringtheXSLTFeaturefromtheSpring/Bluepring">Configuring the XSLT Feature from the Spring/Bluepring</h1><p>The feature can be configured from the code for JAX-WS or JAX-RS clients and endpoints. Example:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"> <jaxws:client id="customerService" serviceName="customer:CustomerServiceService"
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"> <jaxws:client id="customerService" serviceName="customer:CustomerServiceService"
endpointName="customer:CustomerServiceEndpoint" address="http://localhost:9091/CustomerServicePort"
serviceClass="com.example.customerservice.CustomerService">
<jaxws:features>
@@ -149,7 +149,7 @@ div.rbtoc1435780133690 li {margin-left:
</jaxws:endpoint>
</pre>
</div></div><h1 id="XSLTFeature-ConfiguringtheXSLTinterceptorsincode">Configuring the XSLT interceptors in code</h1><p>Here is how a JAX-WS client can be configured:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;"> CustomerServiceService service = new CustomerServiceService();
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;"> CustomerServiceService service = new CustomerServiceService();
CustomerService customerService = service.getCustomerServicePort();
Client client = ClientProxy.getClient(customerService);
XSLTOutInterceptor outInterceptor = new XSLTOutInterceptor(Phase.PRE_STREAM, StaxOutInterceptor.class, null,
Modified: websites/production/cxf/content/dosgi-apache-karaf-feature.html
==============================================================================
--- websites/production/cxf/content/dosgi-apache-karaf-feature.html (original)
+++ websites/production/cxf/content/dosgi-apache-karaf-feature.html Tue Sep 12 19:09:41 2017
@@ -109,15 +109,15 @@ Apache CXF -- DOSGi Apache Karaf Feature
<!-- Content -->
<div class="wiki-content">
<div id="ConfluenceContent"><h1 id="DOSGiApacheKarafFeature-CXFDOSGiinApacheKaraf">CXF DOSGi in Apache Karaf</h1><p>Using the descriptions below a working demo should be up in less than 10 minutes.</p><h2 id="DOSGiApacheKarafFeature-DownloadandunpackApacheKaraf">Download and unpack Apache Karaf</h2><ul><li><a shape="rect" class="external-link" href="http://karaf.apache.org/index/community/download.html">Download apache karaf</a> 4</li><li>Unpack and start it</li></ul><h2 id="DOSGiApacheKarafFeature-InstallationofCXF-DOSGi">Installation of CXF-DOSGi</h2><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: bash; gutter: false; theme: Default" style="font-size:12px;">feature:repo-add aries-rsa 1.9.0
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;">feature:repo-add aries-rsa 1.9.0
feature:repo-add cxf-dosgi 1.8.0
feature:install cxf-dosgi-provider-cxf</pre>
</div></div><h2 id="DOSGiApacheKarafFeature-Testinstallationwithgreeterdemo">Test installation with greeter demo</h2><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: bash; gutter: false; theme: Default" style="font-size:12px;">install -s mvn:org.apache.cxf.dosgi.samples/cxf-dosgi-ri-samples-greeter-interface/1.8.0
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;">install -s mvn:org.apache.cxf.dosgi.samples/cxf-dosgi-ri-samples-greeter-interface/1.8.0
install -s mvn:org.apache.cxf.dosgi.samples/cxf-dosgi-ri-samples-greeter-impl/1.8.0
</pre>
</div></div><p>endpoints should show the greeter service being exported:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: bash; gutter: false; theme: Default" style="font-size:12px;">Endpoints for framework 346376f5-ef56-4bda-b238-0a905ce99342
+<pre class="brush: bash; gutter: false; theme: Confluence" style="font-size:12px;">Endpoints for framework 346376f5-ef56-4bda-b238-0a905ce99342
id | interfaces | framework | comp name
----------------------------------------------------------------------------------------------------------------------------------------
http://localhost:9090/greeter | [org.apache.cxf.dosgi.samples.greeter.GreeterService] | 346376f5-ef56-4bda-b238-0a905ce99342 |
Modified: websites/production/cxf/content/dosgi-architecture.html
==============================================================================
--- websites/production/cxf/content/dosgi-architecture.html (original)
+++ websites/production/cxf/content/dosgi-architecture.html Tue Sep 12 19:09:41 2017
@@ -111,13 +111,13 @@ Apache CXF -- DOSGi Architecture
-<span class="gliffy-container" id="gliffy-container-30965906-2038" data-fullwidth="900" data-ceoid="30739778" data-edit="${diagramEditLink.getLinkUrl()}" data-full="${diagramZoomLink.getLinkUrl()}" data-filename="remote-services-spec">
+<span class="gliffy-container" id="gliffy-container-30965906-8123" data-fullwidth="900" data-ceoid="30739778" data-edit="${diagramEditLink.getLinkUrl()}" data-full="${diagramZoomLink.getLinkUrl()}" data-filename="remote-services-spec">
- <map id="gliffy-map-30965906-9867" name="gliffy-map-30965906-9867"></map>
+ <map id="gliffy-map-30965906-8027" name="gliffy-map-30965906-8027"></map>
- <img class="gliffy-image" id="gliffy-image-30965906-2038" width="900" height="480" data-full-width="900" data-full-height="480" src="https://cwiki.apache.org/confluence/download/attachments/30739778/remote-services-spec.png?version=4&modificationDate=1362365433000&api=v2" alt="remote-services-spec" usemap="#gliffy-map-30965906-9867">
+ <img class="gliffy-image" id="gliffy-image-30965906-8123" width="900" height="480" data-full-width="900" data-full-height="480" src="https://cwiki.apache.org/confluence/download/attachments/30739778/remote-services-spec.png?version=4&modificationDate=1362365433000&api=v2" alt="remote-services-spec" usemap="#gliffy-map-30965906-8027">
- <map class="gliffy-dynamic" id="gliffy-dynamic-map-30965906-2038" name="gliffy-dynamic-map-30965906-2038"></map>
+ <map class="gliffy-dynamic" id="gliffy-dynamic-map-30965906-8123" name="gliffy-dynamic-map-30965906-8123"></map>
</span>
@@ -129,13 +129,13 @@ Apache CXF -- DOSGi Architecture
-<span class="gliffy-container" id="gliffy-container-30965903-3681" data-fullwidth="897" data-ceoid="30739778" data-edit="${diagramEditLink.getLinkUrl()}" data-full="${diagramZoomLink.getLinkUrl()}" data-filename="remote-service-admin-spec">
+<span class="gliffy-container" id="gliffy-container-30965903-5616" data-fullwidth="897" data-ceoid="30739778" data-edit="${diagramEditLink.getLinkUrl()}" data-full="${diagramZoomLink.getLinkUrl()}" data-filename="remote-service-admin-spec">
- <map id="gliffy-map-30965903-4542" name="gliffy-map-30965903-4542"></map>
+ <map id="gliffy-map-30965903-519" name="gliffy-map-30965903-519"></map>
- <img class="gliffy-image" id="gliffy-image-30965903-3681" width="897" height="600" data-full-width="897" data-full-height="600" src="https://cwiki.apache.org/confluence/download/attachments/30739778/remote-service-admin-spec.png?version=2&modificationDate=1362365400000&api=v2" alt="remote-service-admin-spec" usemap="#gliffy-map-30965903-4542">
+ <img class="gliffy-image" id="gliffy-image-30965903-5616" width="897" height="600" data-full-width="897" data-full-height="600" src="https://cwiki.apache.org/confluence/download/attachments/30739778/remote-service-admin-spec.png?version=2&modificationDate=1362365400000&api=v2" alt="remote-service-admin-spec" usemap="#gliffy-map-30965903-519">
- <map class="gliffy-dynamic" id="gliffy-dynamic-map-30965903-3681" name="gliffy-dynamic-map-30965903-3681"></map>
+ <map class="gliffy-dynamic" id="gliffy-dynamic-map-30965903-5616" name="gliffy-dynamic-map-30965903-5616"></map>
</span>
@@ -167,13 +167,13 @@ Apache CXF -- DOSGi Architecture
-<span class="gliffy-container" id="gliffy-container-30965962-1623" data-fullwidth="1217" data-ceoid="30739778" data-edit="${diagramEditLink.getLinkUrl()}" data-full="${diagramZoomLink.getLinkUrl()}" data-filename="cxf-dosgi-topology-manager">
+<span class="gliffy-container" id="gliffy-container-30965962-8725" data-fullwidth="1217" data-ceoid="30739778" data-edit="${diagramEditLink.getLinkUrl()}" data-full="${diagramZoomLink.getLinkUrl()}" data-filename="cxf-dosgi-topology-manager">
- <map id="gliffy-map-30965962-2294" name="gliffy-map-30965962-2294"></map>
+ <map id="gliffy-map-30965962-6885" name="gliffy-map-30965962-6885"></map>
- <img class="gliffy-image" id="gliffy-image-30965962-1623" width="1217" height="773" data-full-width="1217" data-full-height="773" src="https://cwiki.apache.org/confluence/download/attachments/30739778/cxf-dosgi-topology-manager.png?version=4&modificationDate=1368712288000&api=v2" alt="cxf-dosgi-topology-manager" usemap="#gliffy-map-30965962-2294">
+ <img class="gliffy-image" id="gliffy-image-30965962-8725" width="1217" height="773" data-full-width="1217" data-full-height="773" src="https://cwiki.apache.org/confluence/download/attachments/30739778/cxf-dosgi-topology-manager.png?version=4&modificationDate=1368712288000&api=v2" alt="cxf-dosgi-topology-manager" usemap="#gliffy-map-30965962-6885">
- <map class="gliffy-dynamic" id="gliffy-dynamic-map-30965962-1623" name="gliffy-dynamic-map-30965962-1623"></map>
+ <map class="gliffy-dynamic" id="gliffy-dynamic-map-30965962-8725" name="gliffy-dynamic-map-30965962-8725"></map>
</span>
@@ -186,13 +186,13 @@ Apache CXF -- DOSGi Architecture
-<span class="gliffy-container" id="gliffy-container-30966000-2549" data-fullwidth="1191" data-ceoid="30739778" data-edit="${diagramEditLink.getLinkUrl()}" data-full="${diagramZoomLink.getLinkUrl()}" data-filename="cxf-dosgi-discovery-distributed">
+<span class="gliffy-container" id="gliffy-container-30966000-5255" data-fullwidth="1191" data-ceoid="30739778" data-edit="${diagramEditLink.getLinkUrl()}" data-full="${diagramZoomLink.getLinkUrl()}" data-filename="cxf-dosgi-discovery-distributed">
- <map id="gliffy-map-30966000-3449" name="gliffy-map-30966000-3449"></map>
+ <map id="gliffy-map-30966000-8586" name="gliffy-map-30966000-8586"></map>
- <img class="gliffy-image" id="gliffy-image-30966000-2549" width="1191" height="1229" data-full-width="1191" data-full-height="1229" src="https://cwiki.apache.org/confluence/download/attachments/30739778/cxf-dosgi-discovery-distributed.png?version=3&modificationDate=1362365313000&api=v2" alt="cxf-dosgi-discovery-distributed" usemap="#gliffy-map-30966000-3449">
+ <img class="gliffy-image" id="gliffy-image-30966000-5255" width="1191" height="1229" data-full-width="1191" data-full-height="1229" src="https://cwiki.apache.org/confluence/download/attachments/30739778/cxf-dosgi-discovery-distributed.png?version=3&modificationDate=1362365313000&api=v2" alt="cxf-dosgi-discovery-distributed" usemap="#gliffy-map-30966000-8586">
- <map class="gliffy-dynamic" id="gliffy-dynamic-map-30966000-2549" name="gliffy-dynamic-map-30966000-2549"></map>
+ <map class="gliffy-dynamic" id="gliffy-dynamic-map-30966000-5255" name="gliffy-dynamic-map-30966000-5255"></map>
</span>
@@ -205,13 +205,13 @@ Apache CXF -- DOSGi Architecture
-<span class="gliffy-container" id="gliffy-container-30966005-5619" data-fullwidth="200" data-ceoid="30739778" data-edit="${diagramEditLink.getLinkUrl()}" data-full="${diagramZoomLink.getLinkUrl()}" data-filename="cxf-dosgi-remote-service-admin">
+<span class="gliffy-container" id="gliffy-container-30966005-9956" data-fullwidth="200" data-ceoid="30739778" data-edit="${diagramEditLink.getLinkUrl()}" data-full="${diagramZoomLink.getLinkUrl()}" data-filename="cxf-dosgi-remote-service-admin">
- <map id="gliffy-map-30966005-8659" name="gliffy-map-30966005-8659"></map>
+ <map id="gliffy-map-30966005-3123" name="gliffy-map-30966005-3123"></map>
- <img class="gliffy-image" id="gliffy-image-30966005-5619" width="200" height="200" data-full-width="200" data-full-height="200" src="https://cwiki.apache.org/confluence/download/attachments/30739778/cxf-dosgi-remote-service-admin.png?version=2&modificationDate=1362364251000&api=v2" alt="cxf-dosgi-remote-service-admin" usemap="#gliffy-map-30966005-8659">
+ <img class="gliffy-image" id="gliffy-image-30966005-9956" width="200" height="200" data-full-width="200" data-full-height="200" src="https://cwiki.apache.org/confluence/download/attachments/30739778/cxf-dosgi-remote-service-admin.png?version=2&modificationDate=1362364251000&api=v2" alt="cxf-dosgi-remote-service-admin" usemap="#gliffy-map-30966005-3123">
- <map class="gliffy-dynamic" id="gliffy-dynamic-map-30966005-5619" name="gliffy-dynamic-map-30966005-5619"></map>
+ <map class="gliffy-dynamic" id="gliffy-dynamic-map-30966005-9956" name="gliffy-dynamic-map-30966005-9956"></map>
</span>
</div>
Modified: websites/production/cxf/content/dosgi-build.html
==============================================================================
--- websites/production/cxf/content/dosgi-build.html (original)
+++ websites/production/cxf/content/dosgi-build.html Tue Sep 12 19:09:41 2017
@@ -32,6 +32,7 @@
<link type="text/css" rel="stylesheet" href="/resources/highlighter/styles/shThemeCXF.css">
<script src='/resources/highlighter/scripts/shCore.js'></script>
+<script src='/resources/highlighter/scripts/shBrushBash.js'></script>
<script src='/resources/highlighter/scripts/shBrushJava.js'></script>
<script>
SyntaxHighlighter.defaults['toolbar'] = false;