axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject cvs commit: xml-axis-wsif/java/samples/java README.html
Date Wed, 11 Dec 2002 15:57:31 GMT
nmukhi      2002/12/11 07:57:31

  Added:       java/samples/java README.html
  README for local java invocation sample
  Revision  Changes    Path
  1.1                  xml-axis-wsif/java/samples/java/README.html
  Index: README.html
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head>
  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  <meta name="Author" content="Nirmal Mukhi">
  <meta http-equiv="Content-Style-Type" content="text/css">
  <title>Web Services Invocation Framework: Samples</title>
  <link rel="stylesheet" href="wsif.css" type="text/css"></head>
  <body alink="#0000ff" bgcolor="#ffffff" leftmargin="2" topmargin="2" marginwidth="2"
  Web Services Invocation Framework:<br>
  Java Sample</h1>
  <p>This sample aims to demonstrate the invocation of the local java class through
WSIF's API. Why would one want to do this, you ask. The main reason is that having a uniform
view of software through WSDL necessitates this. It is also useful when developing a web service
- you write your web service in java, expose it through WSDL with a java binding. Then you
can test this using a client that employs WSIF's API to invoke the service. Since you are
really using a java class, there is nothing to deploy, no web server to stop and start, etc.
When you are satisfied that the functionality works, you can replace the binding in the WSDL
with a SOAP binding, deploy the service as a SOAP service and retest with your client - which
you don't need to change at all. Following this path in your Web services development reduces
debugging pains one usually has with SOAP services, by making sure the basic functionality
works before moving to a SOAP binding.</p>
  <p>In this particular sample, we describe an AddressBook service. For those unfamilar
with it, this service offers a port type with three operations. Two of the operations add
an entry to the address book, using slightly different styles for providing input information.
The third operation queries the address book with a name. The service uses complex schema
types for representing an address and a phone number.</p>
  <p>The abstract functionality is tied to a java binding which describes how a java
class supports the abstract port type defined. This isn't a standard WSDL binding, instead
this binding is defined as a part of WSIF; you can find details on how to write a java binding
<a href="../../doc/wsdl_extensions/java_extension.html">here</a>.</p>
  <p>The <a href="AddressBook.wsdl">WSDL file</a> is in this sample directory.</p>
  <p><a href="client/dynamic/README.html">Here's</a> how to invoke this
service dynamically using WSIF's dynamic invocation interface (DII).</p>
  <p><a href="client/stub/README.html">Here's</a> how to invoke this service
by first generating the stub interface and using this directly through WSIF's dynamic proxy,
thus hiding all WSIF specifics from the client code. Note that the stub interface used is
the the service interface as defined by the JAX-RPC specification.</p>
  <hr width="100%">

View raw message