README

This package is an example of JSP frontend script to access 
InsumaFocus search engine remotedly as a webservice over SOAP. 
The package uses Axis 1.1 webservice library.

This example does not pretend to be complete or fitting to 
any particular demand or specification. It shell though be 
used as a starting foundation for your integration effort.
Feel free to modify and extend it so it fits your needs at 
best.

You can contact Insuma GmbH under support@insuma.de

Files
=====

The archive consists of 3 major parts:

1. Hand programmed files: SimpleInput.jsp and SimpleSearch.jsp
The first file contains the search form, the second file
places search query to remote Webservice and parses
the received response for presentation. 

2. WEB-INF/lib - selected libraries from Axis 1.1
which support the webservice functionality in java.

3. WEB-INF/classes -  classes stubs for the webservice.

4. WEB-INF/web.xml - a tiny XML configuration file,
describes the application parts, servlets and jsp-pages
involved.


Installation instruction
========================

1. Unpack the archive into a JSP enabled directory of 
your server. To check if JSP is working in the directory,
point your web browser to the file ping_test.jsp

http://www.yoursite.co.uk/path/ping_test.jsp

It should say 2 + 2 = 4. If 4 does not appear please consult
your webadmin regarding correct JSP configuration.

2. Restart the webserver (i.e. Tomcat) so the necessary
libraries are linked.

3. Service active! You can now access the search form by
pointing your web browser to:

   http://www.yoursite.co.uk/path/SimpleInput.jsp


Generating stubs
================

If you want to re-generate the stubs (for example in case 
the webservice description has changed) here is an 
instruction on how to do this. To generate the stubs you 
will need the following:

1. URL of the webservice definition, something like:

    http://www.insuma.de/insuma/download/demo.wsdl

See Insuma website for exact address of WSDL.

2. WSDL2java and ant - these 2 utilities are supplied along 
with Axis. They are used for generating stubs from given
WSDL.

To generate the stubs first execute the following command:

java org.apache.axis.wsdl.WSDL2Java http://url.of.the.wsdl

Save the following compilation script to a file buildproxy.xml

<project default="compile">
<taskdef name="wsdl2java"
 classname="org.apache.axis.tools.ant.wsdl.Wsdl2javaAntTask">
</taskdef>
<target name="compile" >
    <wsdl2java url="demo.wsdl"
               output="src"
               noimports="no"
               verbose="no"
               testcase="no"
               typeMappingVersion="1.2">
               <mapping  namespace="urn:InsumaFocus" package="insuma" />
   </wsdl2java>
</target>
</project>

Now use the ant utility to finalize:

ant buildproxy.xml

You are done! Generated stubs can now be used in any java 
application which works with webservice. Make sure you 
included Axis1.1 webservice library while compiling  your
application (javac -classpath axis.jar).






--- This is the end of the README file