Accessing the execute Interfaces from Client Programs

Sample Client (Not Using wsdl)

Compile the sample program. For example, in a command window on a Windows machine using Apache Axis:

C:\axis>echo %classpath%

.;c:\axis\lib\axis.jar;c:\axis\lib\commons-logging.jar;c:\AXIS\LIB\COMMONS-DISCOVERY.JAR;c:\axis\lib\jaxrpc.jar;c:\axis\lib\saaj.jar

javac -classpath %CLASSPATH% samples/FCStock/fc.java

Run the sample program. For example:

java -classpath %CLASSPATH% samples/FCStock/fc getquote ibm

NOTE	The getquote database business rule is a parameter.

The example below should also execute properly, and display html text:

java -classpath %CLASSPATH% samples/FCStock/fc boo ibm

The second parameter (ibm) is required by the java program, but is ignored by boo.

* This software may include or be accompanied by software

* developed by third parties, including the apache software

* foundation (http://www.apache.org/). Software from third

* parties is subject to license restrictions. For additional

* details, please see the TigerLogic End User License

* Agreement and the third party license agreements that

* accompany the product. TigerLogic may modify some third

* party programs.

* The Apache Software License, Version 1.1

* rights reserved.

* Redistribution and use in source and binary forms, with or

* without modification, are permitted provided that the

* following conditions are met:

* 1.Redistributions of source code must retain the above

* copyright notice, this list of conditions and the following

* disclaimer.

* 2. Redistributions in binary form must reproduce the above

* copyright notice, this list of conditions and the following

* disclaimer in the documentation and/or other materials

* provided with the distribution.

* 3. The end-user documentation included with the

* redistribution, if any, must include the following

* acknowledgment: "This product includes software developed by

* the Apache Software Foundation (http://www.apache.org/)."

* Alternately, this acknowledgment may appear in the software

* itself, if and wherever such third-party acknowledgments

* normally appear.

* 4. The names "Axis" and "Apache Software Foundation" must

* not be used to endorse or promote products derived from this

* software without prior written permission. For written

* permission, please contact apache@apache.org.

* 5. Products derived from this software may not be called

* "Apache", nor may "Apache" appear in their name, without prior

* written permission of the Apache Software Foundation.

* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR

* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A

* PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE

* APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR

* ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR

* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,

* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF

* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER

* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,

* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)

* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF

* ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

*=============================================================

* This software consists of voluntary contributions made by

* many individuals on behalf of the Apache Software Foundation.

* For more information on the Apache Software Foundation,

* please see <http://www.apache.org/>.

* This is a copy of axis/samples/stock/GetQuote.java modified

* to use FlashConnect.

package samples.FCStock ;

import org.apache.axis.AxisFault;

import org.apache.axis.client.Call;

import org.apache.axis.client.Service;

import org.apache.axis.encoding.XMLType;

import org.apache.axis.utils.Options;

import javax.xml.namespace.QName;

import javax.xml.rpc.ParameterMode;

import java.net.URL;

public class fc {

public String username = "";

public String password = "";

public String rulename = "";

public String serverpool = null;

public String[] parameternames = null;

public String[] parametervalues = null;

// helper function; does all the real work

public String run (String args[]) throws Exception {

Options opts = new Options( args );

args = opts.getRemainingArgs();

if ( args == null ) {

System.err.println( "Usage: fc getquote <symbol>" );

System.exit(1);

}

rulename = args[0] ;

parameternames = new String[1];

parametervalues = new String[1];

parameternames[0] = "SYMBOL";

parametervalues[0] = args[1];

opts.setDefaultURL("http://<your hostname here>:8080/axis/servlet/AxisServlet");

URL url = new URL(opts.getURL());

String user = opts.getUser();

String passwd = opts.getPassword();

Service service = new Service();

String res = "";

Call call = (Call) service.createCall();

call.setTargetEndpointAddress( url );

call.setOperationName( new QName("FlashConnect", "execute") );

call.addParameter( "username", XMLType.XSD_STRING, ParameterMode.IN );

call.addParameter( "password", XMLType.XSD_STRING, ParameterMode.IN );

call.addParameter( "rulename", XMLType.XSD_STRING, ParameterMode.IN );

call.addParameter( "serverpool", XMLType.XSD_STRING, ParameterMode.IN );

call.addParameter( "parameternames",

new javax.xml.namespace.QName("urn:FlashConnect", "ArrayOf_xsd_string"),

java.lang.String[].class,

ParameterMode.IN );

call.addParameter( "parametervalues",

new javax.xml.namespace.QName("urn:FlashConnect", "ArrayOf_xsd_string"),

java.lang.String[].class,

ParameterMode.IN );

call.setReturnType( XMLType.XSD_STRING );

// call.setUsername( user );

// call.setPassword( passwd );

Object ret = call.invoke( new Object[] {

username,

password,

rulename,

serverpool,

parameternames,

parametervalues} );

if ( !(ret instance of String)) {

System.out.println("Received problem response from server: "+ret);
throw new AxisFault("", (String)ret, null, null);

}

return (String)ret;

}

public static void main(String args[]) {

try {

fc fcInstance = new fc();

String val = fcInstance.run(args);

// args array gets side-effected

System.out.println( val);

}

catch( Exception e ) {

e.printStackTrace();

}

};

Sample Client Using wsdl

This example program performs the same functions as the previous program, but several of the setups prior to the call.invoke() statement are no longer needed (and have been commented out) as a result of using wsdl.

* This software may include or be accompanied by software

* developed by third parties, including the apache software

* foundation (http://www.apache.org/). Software from third

* parties is subject to license restrictions. For additional

* details, please see the TigerLogic End User License

* Agreement and the third party license agreements that

* accompany the product. TigerLogic may modify some third

* party programs.

* The Apache Software License, Version 1.1

* rights reserved.

* Redistribution and use in source and binary forms, with or

* without modification, are permitted provided that the

* following conditions are met:

* 1.Redistributions of source code must retain the above

* copyright notice, this list of conditions and the following

* disclaimer.

* 2. Redistributions in binary form must reproduce the above

* copyright notice, this list of conditions and the following

* disclaimer in the documentation and/or other materials

* provided with the distribution.

* 3. The end-user documentation included with the

* redistribution, if any, must include the following

* acknowledgment: "This product includes software developed by

* the Apache Software Foundation (http://www.apache.org/)."

* Alternately, this acknowledgment may appear in the software

* itself, if and wherever such third-party acknowledgments

* normally appear.

* 4. The names "Axis" and "Apache Software Foundation" must

* not be used to endorse or promote products derived from this

* software without prior written permission. For written

* permission, please contact apache@apache.org.

* 5. Products derived from this software may not be called

* "Apache", nor may "Apache" appear in their name, without prior

* written permission of the Apache Software Foundation.

* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR

* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A

* PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE

* APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR

* ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR

* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,

* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF

* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER

* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,

* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)

* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF

* ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

*=============================================================

* This software consists of voluntary contributions made by

* many individuals on behalf of the Apache Software Foundation.

* For more information on the Apache Software Foundation,

* please see <http://www.apache.org/>.

* This is a copy of axis/samples/stock/GetQuote.java modified

* to use FlashConnect.

package samples.FCStock ;

import org.apache.axis.AxisFault;

import org.apache.axis.client.Call;

import org.apache.axis.client.Service;

import org.apache.axis.encoding.XMLType;

import org.apache.axis.utils.Options;

import javax.xml.namespace.QName;

import javax.xml.rpc.ParameterMode;

import java.net.URL;

public class fc2 {

public String username = "";

public String password = "";

public String rulename = "";

public String serverpool = null; // defaults to "default"

public String[] parameternames = null;

public String[] parametervalues = null;

// helper function; does all the real work

public String run (String args[]) throws Exception {

Options opts = new Options( args );

args = opts.getRemainingArgs();

if ( args == null ) {

System.err.println( "Usage: fc2 getquote <symbol>" );

System.exit(1);

}

rulename = args[0] ;

parameternames = new String[1];

parametervalues = new String[1];

parameternames[0] = "SYMBOL";

parametervalues[0] = args[1];

String res = "";

/* Define the service QName and port QName */

/*******************************************/

QName servQN = new QName("FlashConnect","FlashConnect");

QName portQN = new QName("FlashConnect","execute");

/* Now use those QNames as pointers into the WSDL doc */

/******************************************************/

Service service = new Service( new URL("file:FlashConnect.wsdl"), servQN );

Call call = (Call) service.createCall( portQN, "execute" );

String user = opts.getUser();

String passwd = opts.getPassword();

/* done by wsdl above

opts.setDefaultURL("http://<your hostname here>:8080/axis/servlet/AxisServlet");

URL url = new URL(opts.getURL());

call.setTargetEndpointAddress( url );

call.setOperationName( new QName("FlashConnect", "run") );

call.addParameter( "username", XMLType.XSD_STRING, ParameterMode.IN );

call.addParameter( "password", XMLType.XSD_STRING, ParameterMode.IN );

call.addParameter( "rulename", XMLType.XSD_STRING, ParameterMode.IN );

call.addParameter( "serverpool", XMLType.XSD_STRING, ParameterMode.IN );

call.addParameter( "parameternames",

new javax.xml.namespace.QName("urn:FlashConnect", "ArrayOf_xsd_string"),

java.lang.String[].class,

ParameterMode.IN );

call.addParameter( "parametervalues",

new javax.xml.namespace.QName("urn:FlashConnect", "ArrayOf_xsd_string"),

java.lang.String[].class,

ParameterMode.IN );

call.setReturnType( XMLType.XSD_STRING );

// call.setUsername( user );

// call.setPassword( passwd );

Object ret = call.invoke( new Object[] {

username,

password,

rulename,

serverpool,

parameternames,

parametervalues} );

if ( !(ret instance of String)) {

System.out.println("Received problem response from server: "+ret); throw new AxisFault("", (String)ret, null, null);

}

return (String)ret;

}

public static void main(String args[]) {

try {

fc fcInstance = new fc();

String val = fcInstance.run(args);

// args array gets side-effected

System.out.println( val);

}

catch( Exception e ) {

e.printStackTrace();

}

};