[jboss-svn-commits] JBossWS SVN: r644 - in tags/jbossws-1.0.2.GA: docs/user-guide/project/en/modules/endpoints docs/user-guide/project/en/modules/mtom-xop src/main/resources/dist

jboss-svn-commits at lists.jboss.org jboss-svn-commits at lists.jboss.org
Mon Jul 31 07:24:03 EDT 2006


Author: heiko.braun at jboss.com
Date: 2006-07-31 07:23:58 -0400 (Mon, 31 Jul 2006)
New Revision: 644

Added:
   tags/jbossws-1.0.2.GA/docs/user-guide/project/en/modules/endpoints/template-config.xml
   tags/jbossws-1.0.2.GA/src/main/resources/dist/Install.txt
Modified:
   tags/jbossws-1.0.2.GA/docs/user-guide/project/en/modules/mtom-xop/mtom-xop.xml
Log:
updated docs

Added: tags/jbossws-1.0.2.GA/docs/user-guide/project/en/modules/endpoints/template-config.xml
===================================================================
--- tags/jbossws-1.0.2.GA/docs/user-guide/project/en/modules/endpoints/template-config.xml	2006-07-30 12:25:17 UTC (rev 643)
+++ tags/jbossws-1.0.2.GA/docs/user-guide/project/en/modules/endpoints/template-config.xml	2006-07-31 11:23:58 UTC (rev 644)
@@ -0,0 +1,101 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<sect1 id="template-config">
+
+   <title>Endpoint configuration templates</title>
+   <para>
+
+      Configuration templates provide a convenient way to setup a handler configuration for JBossWS endpoints.
+      A configuration basically includes a list of <link linkend="handlers">JAXRPC handlers</link> that are
+      registered with a web service endpoint upon deployment.
+
+      <programlisting><![CDATA[
+<?xml version="1.0" encoding="UTF-8"?>
+
+<jbossws-config xmlns="urn:jboss:jbossws-config:5.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xmlns:j2ee="http://java.sun.com/xml/ns/j2ee"
+  xsi:schemaLocation="urn:jboss:jbossws-config:5.0 http://www.jboss.com/xml/jbossws-config_1_0.xsd">
+
+  <endpoint-config>
+    <config-name>Standard Endpoint</config-name>
+  </endpoint-config>
+
+  <endpoint-config>
+    <config-name>Standard Secure Endpoint</config-name>
+    <pre-handler-chain>
+      <handler-chain-name>PreHandlerChain</handler-chain-name>
+      <handler>
+        <j2ee:handler-name>WSSecurityHandlerInbound</j2ee:handler-name>
+        <j2ee:handler-class>org.jboss.ws.wsse.WSSecurityHandlerInbound</j2ee:handler-class>
+      </handler>
+    </pre-handler-chain>
+   </endpoint-config>
+
+</jbossws-config>
+ ]]></programlisting>
+
+   </para>
+
+   <para>
+         These template configurations can be referenced from any jboss specific deplyoment descriptor, i.e:
+
+         <programlisting><![CDATA[
+   <jboss-client>
+     <jndi-name>jbossws-client</jndi-name>
+
+     <service-ref>
+          <service-ref-name>service/HelloService</service-ref-name>
+        (1) <config-name>Standard Secure Client</config-name>
+          <wsdl-override>http://@jbosstest.host.name@:8080/jbossws-samples-wssecurity-encrypt?wsdl</wsdl-override>
+     </service-ref>
+
+   </jboss-client>
+    ]]></programlisting>
+
+         <orderedlist>
+            <listitem>
+               <para>
+                  An example configuration reference from a client deployment descriptor.
+               </para>
+            </listitem>
+         </orderedlist>
+
+
+         <note>
+            <para>This is a proprietary configuration mechanism.
+               In order to stay portable it's recommended to use the default JAXRPC handler configuration.</para>
+         </note>
+
+      </para>
+
+   <para>
+      <command>Configuration reference from web.xml</command>
+      <para>
+      Within web.xml the same approach can be taken, with the difference that it uses a predefined servlet context
+      parameter (1) to specfiy the chosen endpoint config (2):
+
+      <programlisting><![CDATA[
+<web-app xmlns="http://java.sun.com/xml/ns/j2ee"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
+  version="2.4">
+
+  <context-param>
+ (1)  <param-name>jbossws-config-name</param-name>>
+ (2)  <param-value>Standard Secure Endpoint</param-value>
+  </context-param>
+
+  <servlet>
+    <servlet-name>HelloService</servlet-name>
+    <servlet-class>org.jboss.test.ws.samples.wssecurity.HelloJavaBean</servlet-class>
+  </servlet>
+  <servlet-mapping>
+    <servlet-name>HelloService</servlet-name>
+    <url-pattern>/*</url-pattern>
+  </servlet-mapping>
+</web-app>         ]]></programlisting>
+         </para>
+   </para>
+    
+</sect1>
\ No newline at end of file


Property changes on: tags/jbossws-1.0.2.GA/docs/user-guide/project/en/modules/endpoints/template-config.xml
___________________________________________________________________
Name: svn:keywords
   + Id Revision
Name: svn:eol-style
   + LF

Modified: tags/jbossws-1.0.2.GA/docs/user-guide/project/en/modules/mtom-xop/mtom-xop.xml
===================================================================
--- tags/jbossws-1.0.2.GA/docs/user-guide/project/en/modules/mtom-xop/mtom-xop.xml	2006-07-30 12:25:17 UTC (rev 643)
+++ tags/jbossws-1.0.2.GA/docs/user-guide/project/en/modules/mtom-xop/mtom-xop.xml	2006-07-31 11:23:58 UTC (rev 644)
@@ -54,7 +54,7 @@
 
    </sect1>
 
-   <sect1 id="mtom-schema-elements">
+   <sect1 id="mtom-parameter-types">
       <title>Supported MTOM parameter types</title>
       <para>
          <table frame="all">

Added: tags/jbossws-1.0.2.GA/src/main/resources/dist/Install.txt
===================================================================
--- tags/jbossws-1.0.2.GA/src/main/resources/dist/Install.txt	2006-07-30 12:25:17 UTC (rev 643)
+++ tags/jbossws-1.0.2.GA/src/main/resources/dist/Install.txt	2006-07-31 11:23:58 UTC (rev 644)
@@ -0,0 +1,29 @@
+
+Installation instructions
+=========================
+
+This distribution ships with JBoss binaries for JDK1.4 and JDK1.5.
+Please make sure your chose the right distribution that fits your target JDK.
+
+In order to install JBossWS the following steps are necessary:
+
+1.) 	Copy lib/jbossws-client.jar to <JBOSS_HOME>/client/
+2.) 	Unzip lib/jbossws.sar to <JBOSS_HOME>/server/<SERVER>/deploy/
+3.) 	Replacing JBossXB
+
+	In order to upgrade to 1.0.2 you need to manually replace the jboss-xml-binding.jar 
+	in the JBOSS/client and JBOSS/lib directories. 
+	The 4.0.4GA compatible release can be found here:  
+	http://repository.jboss.com/jboss/jbossxb/1.0.0.CR6/
+
+
+That's it!
+After the jbossws.sar is deployed you should be able to access JBossWS under
+http://localhost:8080/jbossws
+
+If you have any questions, please post to the userforum:
+http://www.jboss.org/index.html?module=bb&op=viewforum&f=200
+
+
+Enjoy,
+The JBossWS Team
\ No newline at end of file


Property changes on: tags/jbossws-1.0.2.GA/src/main/resources/dist/Install.txt
___________________________________________________________________
Name: svn:keywords
   + Id Revision
Name: svn:eol-style
   + LF




More information about the jboss-svn-commits mailing list