springnet-commits

[Mark P. <mar...@us...>]

Update of /cvsroot/springnet/Spring.Net/doc/reference/src
In directory sc8-pr-cvs8.sourceforge.net:/tmp/cvs-serv1090

Modified Files:
	webservices.xml 
Log Message:
SPRNET-909 - Document that WebServiceExporter does not add WebServiceBinding attribute with WSI basic profile 1.1 by default.

Index: webservices.xml
===================================================================
RCS file: /cvsroot/springnet/Spring.Net/doc/reference/src/webservices.xml,v
retrieving revision 1.17
retrieving revision 1.18
diff -C2 -d -r1.17 -r1.18
*** webservices.xml	16 Jan 2008 17:21:44 -0000	1.17
--- webservices.xml	2 Apr 2008 18:17:34 -0000	1.18
***************
*** 259,264 ****
        but that really does defeat the purpose.</para>
  
!       <para>A second, better way, is to set all the necessary values within
!       the definition of the service exporter, like so...</para>
  
        <programlisting>
--- 259,265 ----
        but that really does defeat the purpose.</para>
  
!       <para>To add specific attributes to the exported web service, you can
!       set all the necessary values within the definition of the service
!       exporter, like so...</para>
  
        <programlisting>
***************
*** 297,303 ****
        <emphasis>any</emphasis> class as a web service.</para>
  
        <para>One can also export only certain interfaces that a service class
        implements by setting the <literal>Interfaces</literal> property of the
!       <classname>WebServiceExporter</classname>...</para>
  
        <warning>
--- 298,314 ----
        <emphasis>any</emphasis> class as a web service.</para>
  
+       <para>The WebServiceExporter also has a
+       <literal>TypeAttributes</literal> IList property for applying attributes
+       at the type level.<note>
+           <para>The attribute to confirms to the WSI basic profile 1.1 is not
+           added by default. This will be added in a future release. In the
+           meantime use the TypeAttributes IList property to add
+           <literal>[WebServiceBinding(ConformsTo=WsiProfiles.BasicProfile1_1)]</literal>
+           to the generated proxy.</para>
+         </note></para>
+ 
        <para>One can also export only certain interfaces that a service class
        implements by setting the <literal>Interfaces</literal> property of the
!       <classname>WebServiceExporter</classname>.</para>
  
        <warning>
***************
*** 489,520 ****
  
        <programlisting>
!         &lt;object id="PublicarAltasWebService" type="Spring.Web.Services.WebServiceProxyFactory, Spring.Services"&gt;
!         &lt;property name="ProxyType" value="My.WebService" /&gt;
!         &lt;property name="ServiceInterface" value="My.IWebServiceInterface" /&gt;
!         <emphasis role="bold">&lt;property name="ProductTemplate"&gt; </emphasis>
!         &lt;object&gt;
          &lt;!-- Configure the web service URL --&gt;
          &lt;property name="Url" value="https://localhost/MyApp/webservice.jws" /&gt;
          <emphasis role="bold"> &lt;!-- Configure the Username and password for the web service --&gt; </emphasis>
          &lt;property name="Credentials"&gt;
!         &lt;object type="System.Net.NetworkCredential, System"&gt;
!         &lt;property name="UserName" value="user"/&gt;
!         &lt;property name="Password" value="password"/&gt;
!         &lt;/object&gt;
          &lt;/property&gt;
          <emphasis role="bold">&lt;!-- Configure client certificate for the web service --&gt; </emphasis>
          &lt;property name="ClientCertificates"&gt;
!         &lt;list&gt;
!         &lt;object id="MyCertificate" type="System.Security.Cryptography.X509Certificates.X509Certificate2, System"&gt;
!         &lt;constructor-arg name="fileName" value="Certificate.p12" /&gt;
!         &lt;constructor-arg name="password" value="notgoingtotellyou" /&gt;
!         &lt;/object&gt;
!         &lt;/list&gt;
!         &lt;/property&gt;
!         &lt;/object&gt;
          &lt;/property&gt;
!         &lt;/object&gt;
        </programlisting>
!       
      </sect2>
    </sect1>
--- 500,535 ----
  
        <programlisting>
!  &lt;object id="PublicarAltasWebService" type="Spring.Web.Services.WebServiceProxyFactory, Spring.Services"&gt;
!     &lt;property name="ProxyType" value="My.WebService" /&gt;
!     &lt;property name="ServiceInterface" value="My.IWebServiceInterface" /&gt;
!     <emphasis role="bold">&lt;property name="ProductTemplate"&gt; </emphasis>
!       &lt;object&gt;
          &lt;!-- Configure the web service URL --&gt;
          &lt;property name="Url" value="https://localhost/MyApp/webservice.jws" /&gt;
          <emphasis role="bold"> &lt;!-- Configure the Username and password for the web service --&gt; </emphasis>
          &lt;property name="Credentials"&gt;
!           &lt;object type="System.Net.NetworkCredential, System"&gt;
!             &lt;property name="UserName" value="user"/&gt;
!             &lt;property name="Password" value="password"/&gt;
!           &lt;/object&gt;
          &lt;/property&gt;
          <emphasis role="bold">&lt;!-- Configure client certificate for the web service --&gt; </emphasis>
          &lt;property name="ClientCertificates"&gt;
!           &lt;list&gt;
!             &lt;object id="MyCertificate" type="System.Security.Cryptography.X509Certificates.X509Certificate2, System"&gt;
!               &lt;constructor-arg name="fileName" value="Certificate.p12" /&gt;
!               &lt;constructor-arg name="password" value="notgoingtotellyou" /&gt;
!             &lt;/object&gt;
!           &lt;/list&gt;
          &lt;/property&gt;
!       &lt;/object&gt;
!     &lt;/property&gt;
! &lt;/object&gt;
        </programlisting>
! 
!       <para>For an example of how using SOAP headers for authentication using
!       the WebServiceExporter and WebServiceProxyFactory, refer to this <ulink
!       url="http://opensource.atlassian.com/confluence/spring/download/attachments/708/Spring.Examples.SoapHeader.rar?version=1">solution</ulink>
!       on our wiki.</para>
      </sect2>
    </sect1>