The SOAP examples kit that is provided in every KonaKart download kit (you can find them under the installation directory in a directory called java_soap_examples) contains everything you need to build a simple SOAP client from the KonaKart Application WSDL. First verify that you have the kit in your version of KonaKart.

Next, ensure that KonaKart is running on your machine. After the default installation you should be able to start KonaKart by clicking on the "Start KonaKart Server" start-up icon (on Windows) or by executing the {Konakart Home}/bin/startkonakart.sh script (on *nix). You need KonaKart to be running in order to get responses so your SOAP calls that you will make with the examples.

Check that the KonaKart server has started OK - a quick way would be to see if the application appears at http://localhost:8780/konakart

Open up a console window and change directory to the location of the java_soap_examples, for example this would be:

C:\> cd C:\KonaKart\java_soap_examples on Windows.

Ensure that the environment variable JAVA_HOME is set correctly. On Windows, a suitable setting might be:

JAVA_HOME=C:\jdk1.6.0_22

Ensure that the JAVA_HOME/bin directory appears on your PATH. On Windows, this might look something like this:

Path=C:\jdk1.6.0_22\bin;C:\WINDOWS\system32;C:\WINDOWS

{You could also check that when you issue "java -version" you get the java version you expect}

If you already have ANT installed, ANT_HOME is defined and ANT's bin directory is on your PATH you can skip the next two sections. If you don't have ANT installed you can use the cut-down version of ANT that we include in the KonaKart download kit, but you must set the following environment variables. Ensure that the environment variable ANT_HOME is set correctly in the command shell that you are executing (you probably don't want to change the environment variable globally). On Windows, if you installed KonaKart to the default location (C:\Program Files\KonaKart), it would be (note the slashes):

ANT_HOME=C:/Program Files/KonaKart/custom/bin

Ensure that the ANT_HOME/bin directory appears on your PATH. On Windows, this might look something like this:

Path=C:\jdk1.6.0_22\bin;C:\WINDOWS\system32;C:\WINDOWS;C:\Program Files\KonaKart\custom\bin

As a sanity check that you are set up ready to build the examples, check that you see the following when you issue a "ant -p" command:

C:\KonaKart\java_soap_examples>ant -p
Buildfile: build.xml

Main targets:

 axis_client_generation  Generate client stubs from the WSDL
 build                   Creates the SOAP clients, compiles and runs a little example
 clean                   Clears away everything that's created during a build
 compile                 Compile the examples
 run                     Run the little example program
Default target: build

[The KonaKart download kit contains just enough of ANT for you to build the examples. For subsequent development using ANT you should consider installing a complete ANT installation - check the Apache ANT site for details]

Simply execute the "ant" command to compile, then run, the simple SOAP example.

If all is well you should see the following output:

C:\KonaKart\java_soap_examples>..\custom\bin\ant
Buildfile: build.xml

clean:
     [echo] Cleanup...

axis_client_generation:
     [echo] Create the KonaKart client stubs from the WSDL

compile:
     [echo] Compile the examples
    [mkdir] Created dir: C:\KonaKart\java_soap_examples\classes
    [javac] Compiling 59 source files to C:\KonaKart\java_soap_examples\classes
    [javac] Note: Some input files use unchecked or unsafe operations.
    [javac] Note: Recompile with -Xlint:unchecked for details.

run:
     [java] First the low-level version...
     [java]
     [java] There are 239 countries
     [java] There are 10 manufacturers
     [java] The default currency is: USD
     [java] 29 products found
     [java] 29 length of product array
     [java]
     [java] Next the recommended high-level version...
     [java]
     [java] There are 239 countries
     [java] There are 10 manufacturers
     [java] The default currency is: USD
     [java] 29 products found
     [java] 29 length of product array

build:

BUILD SUCCESSFUL
Total time: 10 seconds

The code is very simple; here are a couple of extracts from AxisExample.java. This is the lower-level version:

KKWSEngIf port = new KKWSEngIfServiceLocator().getKKWebServiceEng();

// make some example calls

Country[] countries = port.getAllCountries();
System.out.println("There are " + countries.length + " countries");

Manufacturer[] manufacturers = port.getAllManufacturers();
System.out.println("There are " + manufacturers.length + " manufacturers");

Currency curr = port.getDefaultCurrency();
System.out.println("The default currency is: " + curr.getCode());

This is the recommended higher-level version:

EngineConfigIf engConfig = new EngineConfig();
engConfig.setMode(EngineConfig.MODE_SINGLE_STORE);
            
KKEngIf engine = new KKWSEng(engConfig);

// make some example calls

CountryIf[] countries = engine.getAllCountries();
System.out.println("There are " + countries.length + " countries");

ManufacturerIf[] manufacturers = engine.getAllManufacturers();
System.out.println("There are " + manufacturers.length + " manufacturers");

CurrencyIf curr = engine.getDefaultCurrency();
System.out.println("The default currency is: " + curr.getCode());

Notes: