[jboss-cvs] JBossAS SVN: r103951 - projects/docs/enterprise/5.0/CXF_User_Guide/en-US.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Wed Apr 14 02:44:56 EDT 2010
Author: rebecca.newton
Date: 2010-04-14 02:44:55 -0400 (Wed, 14 Apr 2010)
New Revision: 103951
Added:
projects/docs/enterprise/5.0/CXF_User_Guide/en-US/Chapter_Four_WS_Addressing.xml
projects/docs/enterprise/5.0/CXF_User_Guide/en-US/Chapter_Three_CXF_Integration.xml
Modified:
projects/docs/enterprise/5.0/CXF_User_Guide/en-US/CXF_User_Guide.xml
projects/docs/enterprise/5.0/CXF_User_Guide/en-US/Chapter_Two_Installation.xml
Log:
Added chapters three and four
Modified: projects/docs/enterprise/5.0/CXF_User_Guide/en-US/CXF_User_Guide.xml
===================================================================
--- projects/docs/enterprise/5.0/CXF_User_Guide/en-US/CXF_User_Guide.xml 2010-04-14 06:36:59 UTC (rev 103950)
+++ projects/docs/enterprise/5.0/CXF_User_Guide/en-US/CXF_User_Guide.xml 2010-04-14 06:44:55 UTC (rev 103951)
@@ -8,6 +8,8 @@
<xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Chapter_One_Introduction.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Chapter_Two_Installation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Chapter_Three_CXF_Integration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Chapter_Four_WS_Addressing.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<!-- </index> -->
</book>
Added: projects/docs/enterprise/5.0/CXF_User_Guide/en-US/Chapter_Four_WS_Addressing.xml
===================================================================
--- projects/docs/enterprise/5.0/CXF_User_Guide/en-US/Chapter_Four_WS_Addressing.xml (rev 0)
+++ projects/docs/enterprise/5.0/CXF_User_Guide/en-US/Chapter_Four_WS_Addressing.xml 2010-04-14 06:44:55 UTC (rev 103951)
@@ -0,0 +1,24 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+
+]>
+<!-- Copyright 2010 Red Hat, Inc Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.-->
+<chapter>
+ <title> Chapter Four WS Addressing </title>
+ <para> CXF provides support for the 2004-08 and 1.0 versions of WS-Addressing.
+
+To enable WS-Addressing you may enable the WSAddressingFeature on your service. If you wish to use XML to configure this, you may use the following syntax: </para>
+
+<programlisting><![CDATA[<jaxws:endpoint id="{your.service.namespace}YourPortName">
+ <jaxws:features>
+ <wsa:addressing xmlns:wsa="http://cxf.apache.org/ws/addressing"/>
+ </jaxws:features>
+</jaxws:endpoint>]]>
+ </programlisting>
+ <para>You can also use the same exact syntax with a <![CDATA[<jaxws:client><]]> </para>
+ <programlisting><![CDATA[ <jaxws: client id="{your.service.namespace}YourPortName">
+ <jaxws:features>
+ <wsa:addressing xmlns:wsa="http://cxf.apache.org/ws/addressing"/>
+ </jaxws:features>
+</jaxws:client>]]></programlisting>
+ </chapter>
Added: projects/docs/enterprise/5.0/CXF_User_Guide/en-US/Chapter_Three_CXF_Integration.xml
===================================================================
--- projects/docs/enterprise/5.0/CXF_User_Guide/en-US/Chapter_Three_CXF_Integration.xml (rev 0)
+++ projects/docs/enterprise/5.0/CXF_User_Guide/en-US/Chapter_Three_CXF_Integration.xml 2010-04-14 06:44:55 UTC (rev 103951)
@@ -0,0 +1,86 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "CXF.ent">
+%BOOK_ENTITIES;
+]>
+<!-- Copyright 2010 Red Hat, Inc Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.-->
+
+<chapter>
+ <title> Server Side Integration Customization </title>
+ <para> It is possible to customize the JBossWS and CXF integration by incorporating the CXF configuration file to the endpoint deployment archive. The convention is the following:
+
+<itemizedlist>
+ <listitem>
+ <para> file name must be jbossws-cxf.xml </para>
+ </listitem>
+ <listitem>
+ <para> for POJO deployments it is located in WEB-INF directory </para>
+ </listitem>
+ <listitem>
+ <para> for EJB3 deployments it is located in META-INF directory </para>
+ </listitem>
+ </itemizedlist>
+
+ If user will not provide its own CXF configuration file the default one will be automatically generated during the runtime.
+
+For POJO deployments the generated jbossws-cxf.xml has the following content:
+</para>
+
+<programlisting><![CDATA[
+ <beans
+ xmlns='http://www.springframework.org/schema/beans'
+ xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
+ xmlns:beans='http://www.springframework.org/schema/beans'
+ xmlns:jaxws='http://cxf.apache.org/jaxws'
+ xsi:schemaLocation='http://www.springframework.org/schema/beans
+ http://www.springframework.org/schema/beans/spring-beans.xsd
+ http://cxf.apache.org/jaxws
+ http://cxf.apache.org/schemas/jaxws.xsd'>
+
+ <!-- one or more jaxws:endpoint POJO declarations -->
+ <jaxws:endpoint
+ id='POJOEndpoint'
+ address='http://localhost:8080/pojo_endpoint_archive_name'
+ implementor='my.package.POJOEndpointImpl'>
+ <jaxws:invoker>
+ <bean class='org.jboss.wsf.stack.cxf.InvokerJSE'/>
+ </jaxws:invoker>
+ </jaxws:endpoint>
+
+</beans>]]>
+</programlisting>
+
+<para>
+For EJB3 deployments the generated jbossws-cxf.xml has the following content:
+</para>
+<programlisting><![CDATA[ <beans
+ xmlns='http://www.springframework.org/schema/beans'
+ xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
+ xmlns:beans='http://www.springframework.org/schema/beans'
+ xmlns:jaxws='http://cxf.apache.org/jaxws'
+ xsi:schemaLocation='http://www.springframework.org/schema/beans
+ http://www.springframework.org/schema/beans/spring-beans.xsd
+ http://cxf.apache.org/jaxws
+ http://cxf.apache.org/schemas/jaxws.xsd'>
+
+ <!-- one or more jaxws:endpoint EJB3 declarations -->
+ <jaxws:endpoint
+ id='EJB3Endpoint'
+ address='http://localhost:8080/ejb3_endpoint_archive_name'
+ implementor='my.package.EJB3EndpointImpl'>
+ <jaxws:invoker>
+ <bean class='org.jboss.wsf.stack.cxf.InvokerEJB3'/>
+ </jaxws:invoker>
+ </jaxws:endpoint>
+
+</beans>]]>
+</programlisting>
+<para>
+Providing custom CXF configuration to the endpoint deployment is useful in cases when users want to use features that are not part of standard JAX-WS specification but CXF implements them. For example see <!-- CXF WS-RM tutorial customization file LINK TO THIS ONCE YOU HAVE MADE THE SECTION -->. We are providing custom CXF endpoint configuration there to turn on WS-RM feature for endpoint.
+
+<note>
+ <para> When user incorporates its own CXF configuration to the endpoint archive he must reference either org.jboss.wsf.stack.cxf.InvokerJSE or org.jboss.wsf.stack.cxf.InvokerEJB3 jaxws invoker bean there for each jaxws endpoint. </para>
+</note>
+</para>
+
+</chapter>
Modified: projects/docs/enterprise/5.0/CXF_User_Guide/en-US/Chapter_Two_Installation.xml
===================================================================
--- projects/docs/enterprise/5.0/CXF_User_Guide/en-US/Chapter_Two_Installation.xml 2010-04-14 06:36:59 UTC (rev 103950)
+++ projects/docs/enterprise/5.0/CXF_User_Guide/en-US/Chapter_Two_Installation.xml 2010-04-14 06:44:55 UTC (rev 103951)
@@ -3,6 +3,8 @@
<!ENTITY % BOOK_ENTITIES SYSTEM "CXF.ent">
%BOOK_ENTITIES;
]>
+<!-- Copyright 2010 Red Hat, Inc Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.-->
+
<chapter>
<title>Installation</title>
<para>
More information about the jboss-cvs-commits
mailing list