ws-wsif-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ow...@apache.org
Subject cvs commit: xml-axis-wsif/proposals/website/src/documentation/content/xdocs/developers index.xml
Date Tue, 28 Jan 2003 16:08:56 GMT
owenb       2003/01/28 08:08:55

  Modified:    proposals/website/src/documentation/content/xdocs/providers
                        index.xml
               proposals/website/src/documentation/content/xdocs faq.xml
               proposals/website/src/documentation/content/xdocs/developers
                        index.xml
  Log:
  Updates
  
  Revision  Changes    Path
  1.2       +1 -1      xml-axis-wsif/proposals/website/src/documentation/content/xdocs/providers/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvs/xml-axis-wsif/proposals/website/src/documentation/content/xdocs/providers/index.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- index.xml	28 Jan 2003 12:22:03 -0000	1.1
  +++ index.xml	28 Jan 2003 16:08:55 -0000	1.2
  @@ -5,6 +5,6 @@
             <title>WSIF Providers</title> 
           </header> 
           <body> 
  -          <p>WORK IN PROGRESS</p>
  +          <p>Information on the differenent providers shipped with WSIF and also
the WSDL extensions used by these providers</p>
        </body>
       </document>
  
  
  
  1.3       +95 -5     xml-axis-wsif/proposals/website/src/documentation/content/xdocs/faq.xml
  
  Index: faq.xml
  ===================================================================
  RCS file: /home/cvs/xml-axis-wsif/proposals/website/src/documentation/content/xdocs/faq.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- faq.xml	28 Jan 2003 12:22:03 -0000	1.2
  +++ faq.xml	28 Jan 2003 16:08:55 -0000	1.3
  @@ -4,7 +4,7 @@
          "faq-v11.dtd">
   <faqs title="Frequently Asked Questions">
    <faq>
  -  <question>What is official version of WSIF? How to get the latest version?</question>
  +  <question>What is the official version of WSIF? How to I get the latest version?</question>
     <answer>
      <p>
   The official version of WSIF is found here on the Apache web site.
  @@ -12,7 +12,8 @@
       <link href="http://xml.apache.org/dist/axis/nightly/">http://xml.apache.org/dist/axis/nightly/</link>
      </p>
      <p>
  -          The&nbsp; xml-axis-wsif-src.zip contains source distribution and wsif-bin
zip file contains a built wsif.jar  along with the API Javadoc.
  +          The  wsif-src*.zip contains source distribution, the wsif-bin* zip file contains
a built wsif.jar along with the API Javadoc and the wsif-all*.zip 
  +          contains the source, the JAR and the javadocs. (* will be replaced by the current
version number in the file names).
      </p>
      <p>
   The version available from
  @@ -23,18 +24,107 @@
    </faq>
   
    <faq>
  -  <question>What are differences between WSIF and JAX-RPC?</question>
  +  <question>What are the differences between WSIF and WSTK?</question>
     <answer>
  -   <p>TODO
  -   </p>
  +   <p>WSIF is a framework for invoking WSDL-described services. WSTK is IBM's Web
Services Toolkit, 
  +   a preview technology for web services support in Websphere available from alphaworks.
WSTK includes WSIF amongst other things.</p>
     </answer>
    </faq>
   
    <faq>
  +  <question>What are the differences between WSIF and Axis?</question>
  +  <answer>
  + <p>Axis is an implementation of SOAP. It includes on the server-side infrastructure
for deploying web service implementations and then routing 
  + SOAP messages between clients and those implementations. It also implements the JAX-RPC
specification for invoking SOAP services.</p>
  +
  + <p>WSIF is similar to the client piece of Axis, in that it is used for invoking
services. However, WSIF's API is WSDL-driven and 
  + protocol independent; it allows protocol-specific code ("providers") to be plugged in.
For invoking SOAP services, WSIF is in fact 
  + packaged with an Axis provider, that uses Axis APIs (i.e. JAX-RPC) to do the invocation.
So WSIF operates at a more abstract level than Axis.</p>
  +  </answer>
  + </faq>
  +
  + <faq>
  +  <question>What are the differences between WSIF and JAX-RPC?</question>
  +  <answer>
  +   <p>JAX-RPC is an API for invoking XML-based RPC services - essentially its current
scope is limited to invocation of SOAP services. 
  +   WSIF is an API for invoking WSDL-described services, whether they happen to be SOAP
services or not (for example, WSIF defines WSDL 
  +   bindings so that EJBs, enterprise software acessible using JMS or the Java Connector
architecture as wel as local java classes can all 
  +   be described as first class WSDL services and then invoked using the same, protocol-independent
WSIF API)..</p>
  +  </answer>
  + </faq>
  +
  +  <faq>
  +  <question>How to use and set HTTP proxy with WSIF and SOAP over HTTP</question>
  +  <answer>
  +   <p>TODO: describe here current support for system properties etc.</p>
  +  </answer>
  + </faq> 
  +
  + <faq>
     <question>Where can I find details of the extensions to WSDL that are supported
by WSIF?</question>
     <answer>
      <p>Links to the supported extensions can be found in the <link href="providers/index.html">providers
</link>section.
      </p>
     </answer>
    </faq>
  +
  +  <faq>
  +  <question>How do I define my own WSDL binding extensions and write WSIF providers
for them</question>
  +  <answer>
  +   <p>Here's <link href="developers/how_to_wsdl_extensions.html">how to write
your own WSDL extensions</link> to support new protocols, and then 
  +   <link href="developers/how_to_provider.html">write your own WSIF providers</link>
to support customized WSIF extensions.</p>
  +  </answer>
  + </faq> 
  +
  + <faq>
  +  <question>How do I report problems and request new features?</question>
  +  <answer>
  +   <p>The <link href="mail.html">mailing lists</link> are what you are
looking for</p>
  +  </answer>
  + </faq> 
  +
  + <faq>
  +  <question>How do I select SOAP provider used in WSIF?</question>
  +  <answer>
  +   <p>WSIF comes with an Apache Axis provider so using axis with WSIF is easy. WSIF
has two SOAP providers, one using Apache SOAP 2.3 
  +   and the other using Axis, by default WSIF will use the Axis provider. The default is
controlled by the org.apache.wsif.util.WSIFPluggableProviders class. 
  +   The javadoc for this class gives details of how the default is defined, but it can be
overridden programmatically, for example, the following call sets 
  +   the axis provider to be the default: <br /><br /><code>WSIFPluggableProviders.overrideDefaultProvider("http://schemas.xmlsoap.org/wsdl/soap/",
  +new WSIFDynamicProvider_ApacheSOAP() );</code>
  +</p>
  +  </answer>
  + </faq> 
  +
  + <faq>
  +  <question>How do I use use dynamic invoker sample?</question>
  +  <answer>
  +   <source>java clients.DynamicInvoker http://www.xmethods.net/sd/2001/TemperatureService.wsdl
getTemp 10570
  +
  +Reading WSDL document from 'http://www.xmethods.net/sd/2001/TemperatureService.wsdl'
  +Preparing WSIF dynamic invocation
  +- WSIF0006W: Multiple WSIFProvider found supporting the same namespace URI 'http://schemas.xmlsoap.org/wsdl/soap/'.

  +  Found ('org.apache.wsif.providers.soap.apachesoap.WSIFDynamicProvider_ApacheSOAP, org.apache.wsif.providers.soap.apacheaxis.WSIFDynamicProvider_ApacheAxis')
  +- WSIF0007I: Using WSIFProvider 'org.apache.wsif.providers.soap.apachesoap.WSIFDynamicProvider_ApacheSOAP'
for namespaceURI 'http://schemas.xmlsoap.org/wsdl/soap/'
  +Executing operation getTemp
  +Result:
  +return=56.0
  +
  +Done!
  +   </source>
  +  </answer>
  + </faq>
  +
  + <faq>
  +  <question>Sample DynamicInvoker and Complex Type handling in WSIF?</question>
  +  <answer>
  +   <p>WSIF does support complex types - of course XML schema support is limited (but
very reasonable).</p> 
  +
  +<p>The DynamicInvoker doesn't support invocation of services using complex types
since this requires that java representations of the complex types be generated first. </p>
  +
  +<p>It is also possible to extend DynamicInvoker to support complex types but it will
require some kind of intermediate representation of values that can handle any complex type

  +(such as <link href="http://www.alphaworks.ibm.com/tech/jrom">JROM</link>...)
</p>
  +
  +  </answer>
  + </faq>
  +
   </faqs>
  
  
  
  1.2       +1 -1      xml-axis-wsif/proposals/website/src/documentation/content/xdocs/developers/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvs/xml-axis-wsif/proposals/website/src/documentation/content/xdocs/developers/index.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- index.xml	28 Jan 2003 12:22:02 -0000	1.1
  +++ index.xml	28 Jan 2003 16:08:55 -0000	1.2
  @@ -5,6 +5,6 @@
             <title>Developer's Guide</title> 
           </header> 
           <body> 
  -          <p>WORK IN PROGRESS</p>
  +          <p>Information for people wanting to develop or customize WSIF.</p>
          </body>
       </document>
  
  
  

Mime
View raw message