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 :(<\/p>\n
Overview<\/strong> Install<\/strong> Deploy Stock Sample Web Services<\/strong> -Run deploy.bat to deploy WSDD<\/strong><\/p>\n Test Stock Sample Web Services<\/strong> -Run it. Should get “XXX: 55.25” Test Stock Sample Web Services Using Java Code<\/strong><\/p>\n WSDL2Java<\/strong> -Generated client side classes -Server side binding with option “–server-side –skeletonDeploy true” or “-s -S true” Java2WSDL<\/strong> -Command<\/p>\n -Got<\/p>\n -Now generate server side binding classes<\/p>\n -Implement\/fill in “WidgetPriceSoapBindingImpl” class -Restart Tomcat Remote Administration<\/strong> 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 … Continue reading
\n-It’s a SOAP-RPC implementation and implements jaxrpc.jar and saaj.jar (SOAP with attachment API)
\n-Implemented as a chain of message handlers
\n–Defaults to<\/em><\/strong> RPC\/Encoded (SOAP section 5 encoding rules) so NOT WS-I compliant?!
\n-Architecture guide is here<\/a>
\n-It’s compiled in axis.jar file
\n– See this blog<\/a> for an overview of differences between jax-rpc and jax-ws.<\/p>\n
\n-Download and unzip Axis 1.4 (axis-bin-1_4.zip)
\n-Download and install Tomcat (I used apache-tomcat-4.1.39.zip)
\n-Copy the axis directory from axis distribution’s webapps directory into Tomcat’s webapps directory
\n-Start Tomcat
\n-Point browser to http:\/\/127.0.0.1:8080\/axis\/ (should see the Axis welcome page)
\n-Click Validation link (should see no errors)
\n-Test a SOAP endpoint: http:\/\/localhost:8080\/axis\/services\/Version?method=getVersion
\n-Test a JWS endpoint: http:\/\/localhost:8080\/axis\/EchoHeaders.jws?method=list<\/p>\n
\n-Create a deploy.bat file in sample directory (i.e. samples\/stock):<\/p>\nset AXIS_HOME=C:\\jml\\sw\\org\\apache\\axis\\axis-1_4\r\nset AXIS_LIB=%AXIS_HOME%\\lib\r\nset 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\r\njava -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient -lhttp:\/\/localhost:8080\/axis\/services\/AdminService deploy.wsdd<\/pre>\n
\n-Restart Tomcat<\/p>\n\r\n
\n-Create a test script in the %AXIS_HOME% directory<\/p>\nset AXIS_HOME=C:\\jml\\sw\\org\\apache\\axis\\axis-1_4\r\nset AXIS_LIB=%AXIS_HOME%\\lib\r\nset 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\r\njava -cp .;%AXISCLASSPATH% samples.stock.GetQuote -lhttp:\/\/localhost:8080\/axis\/servlet\/AxisServlet -uuser2 XXX<\/pre>\n
\r\n#!\/bin\/ksh\r\nexport AXIS_LIB=$AXIS_HOME\/lib\r\necho $AXIS_LIB\r\nexport 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\r\necho $AXISCLASSPATH\r\n$JAVA_HOME\/bin\/java -cp $AXISCLASSPATH org.apache.axis.client.AdminClient -lhttp:\/\/localhost:9980\/axis\/services\/AdminService deploy.wsdd<\/pre>\n
\n-Alternatively, use SoapUI to test
\n*WSDL URL: http:\/\/localhost:8080\/axis\/services\/urn:xmltoday-delayed-quotes?wsdl<\/p>\npublic void testVersion() throws ServiceException, AxisFault{\r\n String endpoint = \"http:\/\/localhost:8888\/axis\/services\/Version\";\r\n Service service = new Service();\r\n Call call = (Call)service.createCall();\r\n\r\n call.setTargetEndpointAddress(endpoint);\r\n\r\n String result = (String)call.invoke(\"getVersion\", null);\r\n System.out.println(result);\r\n}\r\n\r\npublic void testStockGetQuote() throws ServiceException, AxisFault{\r\n String endpoint = \"http:\/\/localhost:8888\/axis\/services\/urn:xmltoday-delayed-quotes\";\r\n Service service = new Service();\r\n Call call = (Call)service.createCall();\r\n\r\n call.setTargetEndpointAddress(endpoint);\r\n call.setUsername(\"user1\");\r\n call.setPassword(\"pass1\");\r\n\r\n String result = (String)call.invoke(\"test\", null);\r\n System.out.println(result);\r\n\r\n Float quote = (Float)call.invoke(\"getQuote\", new Object[]{\"XXX\"});\r\n System.out.println(quote);\r\n}<\/pre>\n
\n–wsdl2java command options<\/a>
\n-Sample client-side generation commands<\/p>\n\r\n@echo off\r\nset JAVA_CMD=\"%JAVA_HOME%\\bin\\java\"\r\nset AXIS_HOME=C:\\jml\\sw\\org\\apache\\axis\\axis-1_4\r\nset JAVA_OPTIONS=-Djava.ext.dirs=%AXIS_HOME%\\lib\\\r\nset CLASS_PATH=.\r\n\r\n%JAVA_CMD% %JAVA_OPTIONS% -cp %CLASS_PATH% org.apache.axis.wsdl.WSDL2Java stock.wsdl\r\n<\/pre>\n
\n+For each entry in the type section
\n*A java class
\n*A holder if this type is used as an inout\/out parameter
\n+For each portType
\n*A java interface
\n+For each binding
\n*A stub class
\n+For each service
\n*A service interface
\n*A service implementation (the locator)
\n-Test code<\/p>\n\r\npublic void testStockGetQuote2() throws ServiceException, RemoteException{\r\n StockQuoteServiceService service = new StockQuoteServiceServiceLocator();\r\n StockQuoteService port = service.getGetQuote();\r\n ((org.apache.axis.client.Stub) port).setUsername(\"user1\");\r\n ((org.apache.axis.client.Stub) port).setPassword(\"pass1\");\r\n\r\n String test = port.test();\r\n System.out.println(test);\r\n\r\n float quote = port.getQuote(\"XXX\");\r\n System.out.println(quote);\r\n}<\/pre>\n
\n%JAVA_CMD% %JAVA_OPTIONS% org.apache.axis.wsdl.WSDL2Java -s -S true stock.wsdl
\n–Generated server side classes<\/em><\/strong>
\n+For each binding
\n*A skeleton class
\n*An implementation template class
\n+For all services
\n*One deploy.wsdd file
\n*One undeploy.wsdd file<\/p>\n
\n-Create WSDL from Java interface
\n-From Java Interface<\/p>\n\r\npackage java2wsdl;\r\n\r\npublic interface WidgetPrice {\r\n\tString getWidgetPrice(String widgetName);\r\n\tvoid setWidgetPrice(String widgetName, String widgetPrice);\r\n}\r\n<\/pre>\n\r\n@echo off\r\necho JAVA_HOME: %JAVA_HOME%\r\nset JAVA_CMD=\"%JAVA_HOME%\\bin\\java\"\r\nrem set JAVAC_CMD=\"%JAVA_HOME%\\bin\\javac\"\r\n\r\nrem setting up axis1 env...\r\nset AXIS_HOME=C:\\jml\\sw\\org\\apache\\axis\\axis-1_4\r\n\r\nset JAVA_OPTIONS=-Djava.ext.dirs=%AXIS_HOME%\\lib\\\r\necho JAVA_OPTIONS: %JAVA_OPTIONS%\r\n\r\nset CLASS_PATH=..\\..\\bin\r\n\r\n%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<\/pre>\n
\r\n\r\n
\r\n@echo off\r\necho JAVA_HOME: %JAVA_HOME%\r\nset JAVA_CMD=\"%JAVA_HOME%\\bin\\java\"\r\nset AXIS_HOME=C:\\jml\\sw\\org\\apache\\axis\\axis-1_4\r\nset JAVA_OPTIONS=-Djava.ext.dirs=%AXIS_HOME%\\lib\\\r\necho JAVA_OPTIONS: %JAVA_OPTIONS%\r\nset CLASS_PATH=.\r\n\r\n%JAVA_CMD% %JAVA_OPTIONS% -cp %CLASS_PATH% org.apache.axis.wsdl.WSDL2Java -o . -d session -s -S true -Nurn:WidgetPrice widget.wsdl2java widget.wsdl<\/pre>\n
\n-Compile widget package and copy to Tomcat webapps\\axis\\WEB-INF\\classes
\n-Ran deploy<\/p>\n\r\nset AXIS_HOME=C:\\jml\\sw\\org\\apache\\axis\\axis-1_4\r\nset AXIS_LIB=%AXIS_HOME%\\lib\r\nset 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\r\nrem java -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient -lhttp:\/\/localhost:8080\/axis\/services\/AdminService deploy.wsdd\r\njava -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient -lhttp:\/\/localhost:8080\/axis\/services\/AdminService undeploy.wsdd<\/pre>\n
\n-Test service<\/p>\n\r\n\tpublic void testGetWidgetPrice() throws ServiceException, AxisFault{\r\n\t\tString endpoint = \"http:\/\/localhost:8888\/axis\/services\/WidgetPrice\";\r\n\t\tService service = new Service();\r\n\t\tCall call = (Call)service.createCall();\r\n\t\t\r\n\t\tcall.setTargetEndpointAddress(endpoint);\r\n\t\t\r\n\t\tString result = (String)call.invoke(\"getWidgetPrice\", null);\r\n\t\tSystem.out.println(result);\r\n\t}<\/pre>\n
\nNote 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:<\/p>\n\r\n