Showing results for 
Search instead for 
Did you mean: 

Tech Tip: Using the SOAP Control API with Java

The following code uses Stingray's Control API to list all the running virtual servers on a cluster. The code is written in Java and uses the Stingray-API.jar library described in this article: Using Stingray's SOAP Control API with Java.

Make sure to edit the endpoint address (https://usernameSmiley Tongueassword@host:9090/soap) so that the username, password and host match the admin interface for your Stingray.

import com.zeus.soap.zxtm._1_0.*;









public class listVS {

   public static void main( String[] args ) {

      // Install the all-trusting trust manager

      Security.addProvider( new MyProvider() );

      Security.setProperty( "ssl.TrustManagerFactory.algorithm", "TrustAllCertificates");

      try {

         VirtualServerLocator vsl = new VirtualServerLocator();


            "https://usernameSmiley Tongueassword@host:9090/soap" );

         VirtualServerPort vsp = vsl.getVirtualServerPort();

         String[] vsnames = vsp.getVirtualServerNames();

         boolean[] vsenabled = vsp.getEnabled( vsnames );

         for( int i = 0; i < vsnames.length; i++ ){

            if( vsenabled ){

               System.out.println( vsnames );



      } catch (Exception e) {

         System.out.println( e.toString() );



   /* The following code disables certificate checking.

   * Use the Security.addProvider and Security.setProperty

   * calls to enable it */

   public static class MyProvider extends Provider {

      public MyProvider() {

         super( "MyProvider", 1.0, "Trust certificates" );

         put( "TrustManagerFactory.TrustAllCertificates", MyTrustManagerFactory.class.getName() );


      protected static class MyTrustManagerFactory extends TrustManagerFactorySpi {

         public MyTrustManagerFactory() {}

         protected void engineInit( KeyStore keystore ) {}

         protected void engineInit(

            ManagerFactoryParameters mgrparams ) {}

         protected TrustManager[] engineGetTrustManagers() {

            return new TrustManager[] { new MyX509TrustManager() };



      protected static class MyX509TrustManager implements X509TrustManager {

         public void checkClientTrusted( X509Certificate[] chain, String authType) {}

         public void checkServerTrusted( X509Certificate[] chain, String authType) {}

         public X509Certificate[] getAcceptedIssuers() { return null; }




Running the example

To build and run the code, you'll first need to do the following:

  • Download axis 1.4 from Index of /dist/ws/axis/1_4. You can unzip the axis-bin package in your working directory, or you can install the jar files permanently (e.g. in the JAVAHOME/jre/lib/ext/ directory).

  • Download the JavaMail library; either unzip the package in your working directory, or install the mail.jar file to the JAVAHOME/jre/lib/ext/ directory.  This package provides class implementations that, though not required, will avoid warning about missing classes

Compile and run the example as follows:

$ javac -cp Stingray-API.jar:axis-1_4/lib/*

$ jar -cvfe listVS.jar listVS listVS*.class

$ java -cp Stingray-API.jar:axis-1_4/lib/*:javamail-1.4.7/lib/*:listVS.jar listVS

Main website

Mail servers

Test site

If you install the Stingray-API, Apache Axis 1.2 and JavaMail libraries in your system classpath, then you don't need to reference them explicity when you build and run this example.


The bulk of this code disables client certificate checking. Details of the code and surrounding infrastructure are at

Read more

Version history
Revision #:
1 of 1
Last update:
‎02-25-2013 07:37:AM
Updated by:
Labels (1)

Axis 1.4 (the latest Axis 1.x that exists) has a bug when trying to convert byte arrays to Strings.  This creeps up on certain calls such as Catalog.SSL.Certificates.getRawCertificate.  You will encounter an ArrayStoreException when you invoke it using the Java code generated by Axis if your certificates in Zeus are stored in binary.

To work around this, change the return type to byte[][].  This has to be done in the BindingStub on the setReturnClass call and on the method itself (e.g. getRawCertificates(..)). Change the return type and any relevant casts to byte[][].  Also change the return type on the Port interface class.

One can also change the types to Axis' ArrayDeserializer.ArrayListExtension or just a java.util.List and this will avoid letting Axis try to convert it. Then you can loop through the list yourself and use the values.