Author: asoldano Date: 2013-10-21 08:16:07 -0400 (Mon, 21 Oct 2013) New Revision: 18027 Modified: stack/cxf/tags/jbossws-cxf-4.2.2.Final/modules/dist/src/main/doc/Revision_History.xml stack/cxf/tags/jbossws-cxf-4.2.2.Final/modules/dist/src/main/doc/chapter-5-Advanced_User_Guide.xml Log: Updating documentation Modified: stack/cxf/tags/jbossws-cxf-4.2.2.Final/modules/dist/src/main/doc/Revision_History.xml =================================================================== --- stack/cxf/tags/jbossws-cxf-4.2.2.Final/modules/dist/src/main/doc/Revision_History.xml 2013-10-21 11:56:08 UTC (rev 18026) +++ stack/cxf/tags/jbossws-cxf-4.2.2.Final/modules/dist/src/main/doc/Revision_History.xml 2013-10-21 12:16:07 UTC (rev 18027) @@ -88,6 +88,20 @@ </simplelist> </revdescription> </revision> + <revision> + <revnumber>4.2.2</revnumber> + <date>Mon Oct 21 2013</date> + <author> + <firstname>Alessio</firstname> + <surname>Soldano</surname> + <email&gt;alessio.soldano(a)jboss.com&lt;/email&gt; + </author> + <revdescription> + <simplelist> + <member>JBossWS-CXF 4.2.2 documentation</member> + </simplelist> + </revdescription> + </revision> </revhistory> </simpara> </appendix> Modified: stack/cxf/tags/jbossws-cxf-4.2.2.Final/modules/dist/src/main/doc/chapter-5-Advanced_User_Guide.xml =================================================================== --- stack/cxf/tags/jbossws-cxf-4.2.2.Final/modules/dist/src/main/doc/chapter-5-Advanced_User_Guide.xml 2013-10-21 11:56:08 UTC (rev 18026) +++ stack/cxf/tags/jbossws-cxf-4.2.2.Final/modules/dist/src/main/doc/chapter-5-Advanced_User_Guide.xml 2013-10-21 12:16:07 UTC (rev 18027) @@ -438,15 +438,56 @@ <section id="sid-41713670_Predefinedclientandendpointconfigurations-Clientconfigurationassignment"> <title>Client configuration assignment</title> - <para>JBossWS API comes with facility classes for assigning configurations when building up a client; JAXWS handlers can be read from client configurations as follows:</para> - <informalexample> - <programlisting>import org.jboss.ws.api.configuration.ClientConfigUtil; + <section id="sid-41713670_Predefinedclientandendpointconfigurations-JAXWSFeature"> + + <title>JAXWS Feature</title> + <para> + The most practical way of setting a configuration is using + <code>org.jboss.ws.api.configuration.ClientConfigFeature</code> + , a JAXWS + <code>Feature</code> + extension provided by JBossWS: + </para> + <informalexample> + <programlisting> +import org.jboss.ws.api.configuration.ClientConfigFeature; + +... + +Service service = Service.create(wsdlURL, serviceName); +Endpoint port = service.getPort(Endpoint.class, new ClientConfigFeature("META-INF/jaxws-client-config.xml", "Custom Client Config")); +port.echo("Kermit"); + +... or .... + +port = service.getPort(Endpoint.class, new ClientConfigFeature("META-INF/jaxws-client-config.xml", "Custom Client Config"), true); //setup properties too from the configuration +port.echo("Kermit"); +... or ... + +port = service.getPort(Endpoint.class, new ClientConfigFeature(null, testConfigName)); //reads from current container configurations if available +port.echo("Kermit"); +</programlisting> + </informalexample> + <para> + JBossWS internally parses the specified configuration file, if any, after having resolved it as a resources using the current thread context classloader. The + <ulink url="http://anonsvn.jboss.org/repos/jbossws/spi/tags/jbossws-spi-2.1... schema</ulink> + defines the descriptor contents and is included in the + <emphasis role="italics">jbossws-spi</emphasis> + artifact. + </para> + </section> + <section id="sid-41713670_Predefinedclientandendpointconfigurations-Explicitsetup"> + + <title>Explicit setup</title> + <para>Alternatively, JBossWS API facility classes can be used for assigning configurations when building up a client; JAXWS handlers can be read from client configurations as follows:</para> + <informalexample> + <programlisting>import org.jboss.ws.api.configuration.ClientConfigUtil; import org.jboss.ws.api.configuration.ClientConfigurer; ... Service service = Service.create(wsdlURL, serviceName); -Endpoint port = (Endpoint)service.getPort(Endpoint.class); +Endpoint port = service.getPort(Endpoint.class); BindingProvider bp = (BindingProvider)port; ClientConfigUtil.setConfigHandlers(bp, "META-INF/jaxws-client-config.xml", "Custom Client Config 1"); port.echo("Kermit"); @@ -465,19 +506,19 @@ ... -configurer.setConfigHandlers(bp, null, "Container Custom Client Config"); //reads from container configurations +configurer.setConfigHandlers(bp, null, "Container Custom Client Config"); //reads from current container configurations if available port.echo("Kermit"); </programlisting> - </informalexample> - <para>... similarly, properties are read from client configurations as follows:</para> - <informalexample> - <programlisting>import org.jboss.ws.api.configuration.ClientConfigUtil; + </informalexample> + <para>... similarly, properties are read from client configurations as follows:</para> + <informalexample> + <programlisting>import org.jboss.ws.api.configuration.ClientConfigUtil; import org.jboss.ws.api.configuration.ClientConfigurer; ... Service service = Service.create(wsdlURL, serviceName); -Endpoint port = (Endpoint)service.getPort(Endpoint.class); +Endpoint port = service.getPort(Endpoint.class); ClientConfigUtil.setConfigProperties(port, "META-INF/jaxws-client-config.xml", "Custom Client Config 1"); port.echo("Kermit"); @@ -496,19 +537,20 @@ ... -configurer.setConfigProperties(port, null, "Container Custom Client Config"); //reads from container configurations +configurer.setConfigProperties(port, null, "Container Custom Client Config"); //reads from current container configurations if available port.echo("Kermit"); </programlisting> - </informalexample> - <para> - The default - <code>ClientConfigurer</code> - implementation parses the specified configuration file, if any, after having resolved it as a resources using the current thread context classloader. The - <ulink url="http://anonsvn.jboss.org/repos/jbossws/spi/tags/jbossws-spi-2.1... schema</ulink> - defines the descriptor contents and is included in the - <emphasis role="italics">jbossws-spi</emphasis> - artifact. - </para> + </informalexample> + <para> + The default + <code>ClientConfigurer</code> + implementation parses the specified configuration file, if any, after having resolved it as a resources using the current thread context classloader. The + <ulink url="http://anonsvn.jboss.org/repos/jbossws/spi/tags/jbossws-spi-2.1... schema</ulink> + defines the descriptor contents and is included in the + <emphasis role="italics">jbossws-spi</emphasis> + artifact. + </para> + </section> </section> </section> <section id="sid-41713670_Predefinedclientandendpointconfigurations-Applicationserverconfigurations">