Documentation Center

Components of the toolkit sample

A list of components included in the toolkit sample. You can find the toolkit sample at the following location in the WorldServer SDK: samples\src\com\idiominc\wssdk\samples\component\webservices\toolkit.

ComponentDescription
The custom SDK application (Toolkit.java)

A custom SDK application that implements all the methods in the toolkit by adapting the original tool classes. This SDK application runs through a complete test scenario that includes all the tools in the sample (ExportKit, ImportKit, LeverageAssets, TDImporter, TMImporter).

The Java2WSDL generator uses this running SDK application to generate a WSDL description for the web services. The WSDL2Java generator, in turn, uses this WSDL file to generate Java web server and client stubs. For the .NET platform, the .NET WSDL tool generates .NET web client stubs.

The generated toolkit web clients are completely decoupled from the toolkit web server and you can run them across the Internet on different computers. All TM or TD kit import or export operations are performed by serializing and deserializing streams between the toolkit's web client and web server.

The web services are served by the original Toolkit.java file, which contains all the web service implementations. Axis directs all web client requests to this service. The -c option is passed to WSDL2Java to tell it to use the same starting class for the actual web services implementation.

sdk-service.wsdlThe WSDL file that generates web client proxies to bind to web services. This file generates all the Java and .NET web client stubs.
The generated Java web client proxy (ToolkitSampleStub.java)The toolkit APIs that Java web client programs invoke.
test\ToolkitTest.java

The web client Java toolkit test application that runs on the Internet and works in a similar manner to the original SDK toolkit application.

All TM or TD kit import or export operations are performed by serializing and deserializing streams between the toolkit's web client and web server. This class uses the generated web client stub (ToolkitSampleStub.java) to access all the web service features.

.NET web client support (csharp)All the corresponding .NET C# web client tests are in the csharp subdirectory.
csharp\Test\ToolkitTest.cs

The web client .NET toolkit test application that runs on the Internet and works in a similar manner to the original SDK toolkit application.

The build.dotnet.webservice.toolkit ANT target compiles the toolkit test class into a .NET executable file: samples/dist/Toolkit.exe. You can run the compiled executable file immediately, because the build script copies the required .NET web client proxy DLL files to the same folder.

All TM or TD kit import or export operations are performed by serializing and deserializing streams between the toolkit's web client and web server.

The generated .NET web client proxy (ToolkitSampleService.cs)
This proxy is generating by running the .NET WSDL.exe tool on the previously generated WSDL.
toolkit> wsdl.exe /language:cs
/n:Com.Idiominc.Wssdk.Samples.Component.Webservices.
Toolkit sdk-service.wsdl

The build.dotnet.webservice.toolkit ANT target compiles the toolkit client proxy class into a .NET DLL file: samples/dist/ToolkitWebServiceClient.dll.

These are the toolkit APIs that .NET (C#, Virtual Basic) web client programs invoke.

deploy.wsddGenerated service descriptors for the toolkit web service. These are used for deploying the toolkit web service on the application server.
samples\docs\api\com\idiominc\wssdk\samples\component\webservices\toolkit\clientGenerated Javadocs for the toolkit web client proxy. These are the web service interfaces against which you can code. The web client does not know anything about how these interfaces are implemented.