You are viewing a plain text version of this content. The canonical link for it is here.
Posted to wsif-dev@ws.apache.org by ow...@apache.org on 2003/01/28 17:08:56 UTC
cvs commit: xml-axis-wsif/proposals/website/src/documentation/content/xdocs/developers index.xml
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 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>