Revist Axis 1.4

We have a legacy Axis1 1.4 (not the Axis2 1.4) web services implementation and it’s causing interoperability issues. So we need a revisit :(

Overview
-It’s a SOAP-RPC implementation and implements jaxrpc.jar and saaj.jar (SOAP with attachment API)
-Implemented as a chain of message handlers
–Defaults to RPC/Encoded (SOAP section 5 encoding rules) so NOT WS-I compliant?!
-Architecture guide is here
-It’s compiled in axis.jar file
– See this blog for an overview of differences between jax-rpc and jax-ws.

Install
-Download and unzip Axis 1.4 (axis-bin-1_4.zip)
-Download and install Tomcat (I used apache-tomcat-4.1.39.zip)
-Copy the axis directory from axis distribution’s webapps directory into Tomcat’s webapps directory
-Start Tomcat
-Point browser to http://127.0.0.1:8080/axis/ (should see the Axis welcome page)
-Click Validation link (should see no errors)
-Test a SOAP endpoint: http://localhost:8080/axis/services/Version?method=getVersion
-Test a JWS endpoint: http://localhost:8080/axis/EchoHeaders.jws?method=list

Deploy Stock Sample Web Services
-Create a deploy.bat file in sample directory (i.e. samples/stock):

set AXIS_HOME=C:\jml\sw\org\apache\axis\axis-1_4
set AXIS_LIB=%AXIS_HOME%\lib
set AXISCLASSPATH=%AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-discovery-0.2.jar;%AXIS_LIB%\commons-logging-1.0.4.jar;%AXIS_LIB%\jaxrpc.jar;%AXIS_LIB%\saaj.jar;%AXIS_LIB%\log4j-1.2.8.jar;%AXIS_LIB%\xml-apis.jar;%AXIS_LIB%\xercesImpl.jar;%AXIS_LIB%\wsdl4j-1.5.1.jar
java -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient -lhttp://localhost:8080/axis/services/AdminService deploy.wsdd

-Run deploy.bat to deploy
-Restart Tomcat

WSDD

<deployment xmlns="http://xml.apache.org/axis/wsdd/"
            xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
  <!-- define the logging handler configuration -->
 <handler name="track" type="java:samples.userguide.example4.LogHandler">
  <parameter name="filename" value="MyService.log"/>
 </handler>
 
 <!-- define the service, using the log handler we just defined -->
 <service name="LogTestService" provider="java:RPC">
  <requestFlow>
   <handler type="track"/>
  </requestFlow>
 
  <parameter name="className" value="samples.userguide.example4.Service"/>
  <parameter name="allowedMethods" value="*"/>
 </service>
</deployment>

Test Stock Sample Web Services
-Create a test script in the %AXIS_HOME% directory

set AXIS_HOME=C:\jml\sw\org\apache\axis\axis-1_4
set AXIS_LIB=%AXIS_HOME%\lib
set AXISCLASSPATH=%AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-discovery-0.2.jar;%AXIS_LIB%\commons-logging-1.0.4.jar;%AXIS_LIB%\jaxrpc.jar;%AXIS_LIB%\saaj.jar;%AXIS_LIB%\log4j-1.2.8.jar;%AXIS_LIB%\wsdl4j-1.5.1.jar
java -cp .;%AXISCLASSPATH% samples.stock.GetQuote -lhttp://localhost:8080/axis/servlet/AxisServlet -uuser2 XXX

#!/bin/ksh
export AXIS_LIB=$AXIS_HOME/lib
echo $AXIS_LIB
export AXISCLASSPATH=$AXIS_LIB/axis.jar:$AXIS_LIB/commons-discovery-0.2.jar:$AXIS_LIB/commons-logging-1.0.4.jar:$AXIS_LIB/jaxrpc.jar:$AXIS_LIB/saaj.jar:$AXIS_LIB/log4j-1.2.8.jar:$AXIS_LIB/xml-apis.jar:$AXIS_LIB/xercesImpl.jar:$AXIS_LIB/wsdl4j-1.5.1.jar
echo $AXISCLASSPATH
$JAVA_HOME/bin/java -cp $AXISCLASSPATH org.apache.axis.client.AdminClient -lhttp://localhost:9980/axis/services/AdminService deploy.wsdd

-Run it. Should get “XXX: 55.25”
-Alternatively, use SoapUI to test
*WSDL URL: http://localhost:8080/axis/services/urn:xmltoday-delayed-quotes?wsdl

Test Stock Sample Web Services Using Java Code

public void testVersion() throws ServiceException, AxisFault{
  String endpoint = "http://localhost:8888/axis/services/Version";
  Service service = new Service();
  Call call = (Call)service.createCall();
 
  call.setTargetEndpointAddress(endpoint);
 
  String result = (String)call.invoke("getVersion", null);
  System.out.println(result);
}
 
public void testStockGetQuote() throws ServiceException, AxisFault{
  String endpoint = "http://localhost:8888/axis/services/urn:xmltoday-delayed-quotes";
  Service service = new Service();
  Call call = (Call)service.createCall();
 
  call.setTargetEndpointAddress(endpoint);
  call.setUsername("user1");
  call.setPassword("pass1");
 
  String result = (String)call.invoke("test", null);
  System.out.println(result);
 
  Float quote = (Float)call.invoke("getQuote", new Object[]{"XXX"});
  System.out.println(quote);
}

WSDL2Java
–wsdl2java command options
-Sample client-side generation commands

@echo off
set JAVA_CMD="%JAVA_HOME%\bin\java"
set AXIS_HOME=C:\jml\sw\org\apache\axis\axis-1_4
set JAVA_OPTIONS=-Djava.ext.dirs=%AXIS_HOME%\lib\
set CLASS_PATH=.

%JAVA_CMD% %JAVA_OPTIONS% -cp %CLASS_PATH% org.apache.axis.wsdl.WSDL2Java stock.wsdl

-Generated client side classes
+For each entry in the type section
*A java class
*A holder if this type is used as an inout/out parameter
+For each portType
*A java interface
+For each binding
*A stub class
+For each service
*A service interface
*A service implementation (the locator)
-Test code

public void testStockGetQuote2() throws ServiceException, RemoteException{
  StockQuoteServiceService service = new StockQuoteServiceServiceLocator();
  StockQuoteService port = service.getGetQuote();
  ((org.apache.axis.client.Stub) port).setUsername("user1");
  ((org.apache.axis.client.Stub) port).setPassword("pass1");
 
  String test = port.test();
  System.out.println(test);
 
  float quote = port.getQuote("XXX");
  System.out.println(quote);
}

-Server side binding with option “–server-side –skeletonDeploy true” or “-s -S true”
%JAVA_CMD% %JAVA_OPTIONS% org.apache.axis.wsdl.WSDL2Java -s -S true stock.wsdl
–Generated server side classes
+For each binding
*A skeleton class
*An implementation template class
+For all services
*One deploy.wsdd file
*One undeploy.wsdd file

Java2WSDL
-Create WSDL from Java interface
-From Java Interface

package java2wsdl;
 
public interface WidgetPrice {
	String getWidgetPrice(String widgetName);
	void setWidgetPrice(String widgetName, String widgetPrice);
}

-Command

@echo off
echo JAVA_HOME: %JAVA_HOME%
set JAVA_CMD="%JAVA_HOME%\bin\java"
rem set JAVAC_CMD="%JAVA_HOME%\bin\javac"

rem setting up axis1 env...
set AXIS_HOME=C:\jml\sw\org\apache\axis\axis-1_4

set JAVA_OPTIONS=-Djava.ext.dirs=%AXIS_HOME%\lib\
echo JAVA_OPTIONS: %JAVA_OPTIONS%

set CLASS_PATH=..\..\bin

%JAVA_CMD% %JAVA_OPTIONS% -cp %CLASS_PATH% org.apache.axis.wsdl.Java2WSDL -o widget.wsdl -l"http://localhost:8080/axis/services/WidgetPrice" -n"urn:WidgetPrice" -p"widget" "urn:WidgetPrice" widget.WidgetPrice

-Got

<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions targetNamespace="urn:WidgetPrice" xmlns:apachesoap="http://xml.apache.org/xml-soap" xmlns:impl="urn:WidgetPrice" xmlns:intf="urn:WidgetPrice" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<!--WSDL created by Apache Axis version: 1.4
Built on Apr 22, 2006 (06:55:48 PDT)-->
   <wsdl:message name="setWidgetPriceRequest">
      <wsdl:part name="in0" type="soapenc:string"/>
      <wsdl:part name="in1" type="soapenc:string"/>
   </wsdl:message>
   <wsdl:message name="getWidgetPriceResponse">
      <wsdl:part name="getWidgetPriceReturn" type="soapenc:string"/>
   </wsdl:message>
   <wsdl:message name="setWidgetPriceResponse">
   </wsdl:message>
   <wsdl:message name="getWidgetPriceRequest">
      <wsdl:part name="in0" type="soapenc:string"/>
   </wsdl:message>
   <wsdl:portType name="WidgetPrice">
      <wsdl:operation name="getWidgetPrice" parameterOrder="in0">
         <wsdl:input message="impl:getWidgetPriceRequest" name="getWidgetPriceRequest"/>
         <wsdl:output message="impl:getWidgetPriceResponse" name="getWidgetPriceResponse"/>
      </wsdl:operation>
      <wsdl:operation name="setWidgetPrice" parameterOrder="in0 in1">
         <wsdl:input message="impl:setWidgetPriceRequest" name="setWidgetPriceRequest"/>
         <wsdl:output message="impl:setWidgetPriceResponse" name="setWidgetPriceResponse"/>
      </wsdl:operation>
   </wsdl:portType>
   <wsdl:binding name="WidgetPriceSoapBinding" type="impl:WidgetPrice">
      <wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>
      <wsdl:operation name="getWidgetPrice">
         <wsdlsoap:operation soapAction=""/>
         <wsdl:input name="getWidgetPriceRequest">
            <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:WidgetPrice" use="encoded"/>
         </wsdl:input>
         <wsdl:output name="getWidgetPriceResponse">
            <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:WidgetPrice" use="encoded"/>
         </wsdl:output>
      </wsdl:operation>
      <wsdl:operation name="setWidgetPrice">
         <wsdlsoap:operation soapAction=""/>
         <wsdl:input name="setWidgetPriceRequest">
            <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:WidgetPrice" use="encoded"/>
         </wsdl:input>
         <wsdl:output name="setWidgetPriceResponse">
            <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:WidgetPrice" use="encoded"/>
         </wsdl:output>
      </wsdl:operation>
   </wsdl:binding>
   <wsdl:service name="WidgetPriceService">
      <wsdl:port binding="impl:WidgetPriceSoapBinding" name="WidgetPrice">
         <wsdlsoap:address location="http://localhost:8080/axis/services/WidgetPrice"/>
      </wsdl:port>
   </wsdl:service>
</wsdl:definitions>

-Now generate server side binding classes

@echo off
echo JAVA_HOME: %JAVA_HOME%
set JAVA_CMD="%JAVA_HOME%\bin\java"
set AXIS_HOME=C:\jml\sw\org\apache\axis\axis-1_4
set JAVA_OPTIONS=-Djava.ext.dirs=%AXIS_HOME%\lib\
echo JAVA_OPTIONS: %JAVA_OPTIONS%
set CLASS_PATH=.

%JAVA_CMD% %JAVA_OPTIONS% -cp %CLASS_PATH% org.apache.axis.wsdl.WSDL2Java -o . -d session -s -S true -Nurn:WidgetPrice widget.wsdl2java widget.wsdl

-Implement/fill in “WidgetPriceSoapBindingImpl” class
-Compile widget package and copy to Tomcat webapps\axis\WEB-INF\classes
-Ran deploy

set AXIS_HOME=C:\jml\sw\org\apache\axis\axis-1_4
set AXIS_LIB=%AXIS_HOME%\lib
set AXISCLASSPATH=%AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-discovery-0.2.jar;%AXIS_LIB%\commons-logging-1.0.4.jar;%AXIS_LIB%\jaxrpc.jar;%AXIS_LIB%\saaj.jar;%AXIS_LIB%\log4j-1.2.8.jar;%AXIS_LIB%\xml-apis.jar;%AXIS_LIB%\xercesImpl.jar;%AXIS_LIB%\wsdl4j-1.5.1.jar
rem java -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient -lhttp://localhost:8080/axis/services/AdminService deploy.wsdd
java -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient -lhttp://localhost:8080/axis/services/AdminService undeploy.wsdd

-Restart Tomcat
-Test service

	public void testGetWidgetPrice() throws ServiceException, AxisFault{
		String endpoint = "http://localhost:8888/axis/services/WidgetPrice";
		Service service = new Service();
		Call call = (Call)service.createCall();
 
		call.setTargetEndpointAddress(endpoint);
 
		String result = (String)call.invoke("getWidgetPrice", null);
		System.out.println(result);
	}

Remote Administration
Note that by default, the Axis server is configured to only accept administration requests from the machine on which it resides – if you wish to enable remote administration, you must set the “enableRemoteAdmin” property of the AdminService to true. To do this, find the “server-config.wsdd” file in your webapp’s WEB-INF directory. In it, you’ll see a deployment for the AdminService. Add an option as follows:

<service name="AdminService" provider="java:MSG">
  <parameter name="className" value="org.apache.axis.util.Admin"/>
  <parameter name="allowedMethods" value="*"/>
  <parameter name="enableRemoteAdmin" value="true"/>
</service>