亚洲精品无码少妇30P,亚洲人av高清无码,亚洲色婷婷六月亚洲婷婷6月

不同�U�类的webservice错误信息

狼爱上狸 — Sun, 01 Jul 2007 07:51:00 GMT

下面是调试web service�Ӟ��不同�U�种�cȝ��异常情况�Q�以供调试参�?br>

�~�少的jar文�g请加在classpath中，注意��查，classpath文�g前面不要有空根{�?br>
�~�少axis.jar
javax.xml.rpc.ServiceException: java.lang.ClassNotFoundException: org.apache.axis.client.ServiceFactory
at javax.xml.rpc.ServiceFactory.newInstance(ServiceFactory.java:69)
at com.company.project.remote.WebServiceClient.main(WebServiceClient.java:24)

�~�少saaj.jar
Exception in thread "main" java.lang.NoClassDefFoundError: javax/xml/soap/SOAPException
at org.apache.axis.configuration.FileProvider.configureEngine(FileProvider.java:179)
at org.apache.axis.AxisEngine.init(AxisEngine.java:172)
at org.apache.axis.AxisEngine.(AxisEngine.java:156)
at org.apache.axis.client.AxisClient.(AxisClient.java:52)
at org.apache.axis.client.Service.getAxisClient(Service.java:104)
at org.apache.axis.client.Service.(Service.java:157)
at org.apache.axis.client.ServiceFactory.createService(ServiceFactory.java:198)
at com.company.project.remote.WebServiceClient.main(WebServiceClient.java:26)

�~�少wsdl4j.jar
Exception in thread "main" java.lang.NoClassDefFoundError: javax/wsdl/extensions/mime/MIMEContent
at org.apache.axis.wsdl.gen.Parser.run(Parser.java:297)
at org.apache.axis.client.Service.initService(Service.java:243)
at org.apache.axis.client.Service.(Service.java:165)
at org.apache.axis.client.ServiceFactory.createService(ServiceFactory.java:198)
at com.company.project.remote.WebServiceClient.main(WebServiceClient.java:26)

错误的URL
javax.xml.rpc.ServiceException: Error processing WSDL document:
java.net.UnknownHostException: www.xmethods.com
at org.apache.axis.client.Service.initService(Service.java:250)
at org.apache.axis.client.Service.(Service.java:165)
at org.apache.axis.client.ServiceFactory.createService(ServiceFactory.java:198)
at com.company.project.remote.WebServiceClient.main(WebServiceClient.java:26)

�~�少用户名、密�?br>javax.xml.rpc.ServiceException: Error processing WSDL document:
java.net.ProtocolException: Server redirected too many times (20)
at org.apache.axis.client.Service.initService(Service.java:250)
at org.apache.axis.client.Service.(Service.java:165)
at org.apache.axis.client.ServiceFactory.createService(ServiceFactory.java:198)
at com.company.project.remote.WebServiceClient.main(WebServiceClient.java:26)

狼爱上狸 2007-07-01 15:51 发表评论

Axis开发Webservice传Bean对象�q�回String串的实例

狼爱上狸 — Fri, 29 Jun 2007 04:43:00 GMT

�q�几天也一直在��Z��设计与实��C��个业务��^�?想用Webservice 来作为核心技术来实现,也一直想�_�溢求精地把�q�个东东搞好, �H�然觉得好久没来�q�里写日志了.�?旉��如白驹过隙啊!

对于webService 以前也接触过.但只是皮�?�q�次可是来真格的.来就来吧,�q�轻��是��Z��.一定得把握�?�q�它一��? �?��在�|�上到处找找�?在本地机器上左试�?双��试啊, 什么法子都用一遍。就不信搞不定它�Q�小��P��

�|�上的例子也比较散，比较��易的�Q�达不我惌��的业务水�q�I��只能慢慢搜烦与摸索吧。。。。。。就�q�样天天想着�q�事�Q�也没什么心情来�q�里写写�?/p>

�q�些天，也快回深圳了�Q�定在下周四动��n吧。这边的工作也得告一节了。把我前一些日子，搞一个完整的Samples 攑ֈ��q�里来，与大家共享。希望对有心人有些启发，也希望高人指点与点评。。。。。。。�?/p>

   ****************************************************
   *Axis开发Webservice传Bean对象�q�回String串的实例.rtf*
   ****************************************************

在ECLIPSE 里新��Z��工程�Q�其�ơ徏包，再次建类�Q?br>基本包：samples.userguide.example5
基本�c�： Order.java

内容�Q?br> * Order.java *
*�?*******************************

package samples.userguide.example5;

/**
* This is a JavaBean which represents an order for some products.
* Copyright: Copyright (c) 2007-1
* @author Black skin (blackskin@126.com)
* @version 1.0
*/
public class Order {
/** Who's ordering */
private String customerName;

/** Where do they live */
private String shippingAddress;

/** Which items do we want */
private String itemCodes[];

/** And how many */
private int quantities[];

// Bean accessors

public String getCustomerName() {
return customerName;
}

public void setCustomerName(String name) {
customerName = name;
}

public String getShippingAddress() {
return shippingAddress;
}

public void setShippingAddress(String address) {
shippingAddress = address;
}

public String[] getItemCodes() {
return itemCodes;
}

public void setItemCodes(String[] items) {
itemCodes = items;
}

public int[] getQuantities() {
return quantities;
}

public void setQuantities(int[] quants) {
quantities = quants;
}
}

********************************�?

��L��务包: samples.userguide.example5
��L��务类: BeanService.java

如下�Q?br> * BeanService.java *
**�?******************************
package samples.userguide.example5;

/**
* This is a JavaBean which represents an order for some products.
* Copyright: Copyright (c) 2007-1
* @author Black skin (blackskin@126.com)
* @version 1.0
*/

public class BeanService {
public String processOrder(Order order) {
String sep = System.getProperty("line.separator");

String response = "Hi, " + order.getCustomerName() + "!" + sep;

response += sep + "You seem to have ordered the following:" + sep;

String[] items = order.getItemCodes();
int[] quantities = order.getQuantities();

for (int i = 0; i < items.length; i++) {
response += sep + quantities[i] + " of item : " + items[i];
}

response += sep + sep + "If this had been a real order processing system, "
+ sep + "we'd probably have charged you about now.";

return response;
}

public static void main(String[] args) throws Exception{
/** Who's ordering */
String customerName = "Black Skin";
/** Where do they live */
String shippingAddress = "001 xingan Street, bayuquan, YK";
/** Which items do we want */
String[] items = new String[] { "apple", "160ml-Milk" };
/** And how many */
int[] quantities = new int[] { 2, 4 };
/** request class init() */
Order order = new Order();
order.setCustomerName(customerName);
order.setShippingAddress(shippingAddress);
order.setItemCodes(items);
order.setQuantities(quantities);
/** server class init() */
BeanService beanservice = new BeanService();
String result = beanservice.processOrder(order);
/** OutPut the result */
System.out.println(" " + result);
}

}

********************************�?

BeanService.java里有个本地测试方�?samples.userguide.example5.BeanService.main())�Q�来��试此应用的可运行性；

到此�Q�服务端�c�d��完了�Q�接着来把此类的方法发布成 WebService 接口

手写一个deploy.wsdd 文�g�Q�可以参考下面的例子�Q?br> *deploy.wsdd例子*
*�?*******************************

********************************�?

昄��Q�简单，造一个deploy.wsdd 信手捏来,如下�Q?br>      *deploy.wsdd*
*�?*******************************







********************************�?

有了deploy.wsdd文�g了，接着通过它来生成 server-config.wsdd.
OK! 用命令直接生成就行；在deploy.wsdd 的文件夹下新��Z��?makeWsdd.bat.
其中的写法有下面的例子来参考：

* makeWsdd.bat 例子*
*�?*******************************
set AXISCLASSPATH= “应用发布的�\�?#8221;
set AXIS_LIB= “AXIS框架的内部JAR包LIB路径”
SET CLASSPATH=.;%CLASSPATH%;%AXIS_LIB%\wsdl4j-1.5.1.jar;%AXIS_LIB%\axis.jar;%AXIS_LIB%\jaxrpc.jar;
%AXIS_LIB%\saaj.jar;%AXIS_LIB%\commons-discovery-0.2.jar;%AXIS_LIB%\commons-logging-1.0.4.jar

java -Djava.ext.dirs=%AXISCLASSPATH% org.apache.axis.client.AdminClient
-S服务名\services\AdminService -p端口��P��如果你的端口号不是默认的8080需要指定�?br> 例如�Q?899�Q�deploy.wsdd
********************************�?

如此�Q�我写了一“makeWsdd.bat”文�g。如下：

* makeWsdd.bat*
*�?*******************************
set AXISCLASSPATH=C:\Axis_webservice\Tomcat_4.1\webapps\axis
set AXIS_LIB=C:\axis-1_4\lib
SET CLASSPATH=.;%CLASSPATH%;%AXIS_LIB%\wsdl4j-1.5.1.jar;%AXIS_LIB%\axis.jar;%AXIS_LIB%\jaxrpc.jar;
%AXIS_LIB%\saaj.jar;%AXIS_LIB%\commons-discovery-0.2.jar;%AXIS_LIB%\commons-logging-1.0.4.jar

java -Djava.ext.dirs=%AXISCLASSPATH% org.apache.axis.client.AdminClient
-SBeanServer\services\AdminService -p 8080 deploy.wsdd
********************************�?

保存好，接下来架设Webservice.

架设AXIS�Q?br>首先�Q�将deploy.wsdd文�gCopy�?%AXISCLASSPATH%/WEB-INF 目录下；
其次�Q�将之前的类�~�译后，�q��\径一起Copy�?%AXISCLASSPATH%/WEB-INF/classes目录下，
最后，��tomcat�?catalina 服务启动.
�Q�即�Q�C:\Axis_webservice\Tomcat_4.1\bin,

   [特别注意的是�Q�]
       �Q�。tomcat务必启动�?br>       �Q�。在写如上的命��o行时�Q�务必注意参数的写法�?#8220;-D”　�?“-S”与其值间不能有空根{��切讎ͼ�
       C。各XX的�\径里�Q�最好是不要有空��|��因�ؓJAVA里对大小写与路径�I�格有校验�?br>�Q�）

��试�Q?br>命��o行启动方法；�q�行"cmd",在命令行里写�Q?cd C:\Axis_webservice\Tomcat_4.1\bin",回�R�Q�再写：" catalina run ",回�R�Q�OK�Q?br>后台会报错：
"
- Unable to find config file. Creating new servlet engine config file: /WEB-INF/server-config.wsdd
2007-1-20 10:07:48 org.apache.coyote.http11.Http11Protocol start
信息: Starting Coyote HTTP/1.1 on port 8080
"
说明�Q�在../WEB-INF/下没�?server-config.wsdd",暂时忽略�?br>在IE地址栏写�Q?a href="http://localhost:8080/axis">http://localhost:8080/axis
可见�Q�axis �Ƣ迎首页�Q�点�?"list" 便可看到默认情况下发布了两个服务下各有一个方法。一切准备工作已�l�OK�Q?/p>

再回刎ͼ�刚才我们写的那个批处理文�Ӟ��" makeWsdd.bat"�Q?br>直接双击�Q�便可执行，有一个警告，可以忽略的。执行完成后�Q�在相应�?br>%AXISCLASSPATH%/WEB-INF下便有一“server-config.wsdd”文�g�Q�如下：

*server-config.wsdd*
*�?*******************************

http://xml.apache.org/axis/wsdd/

********************************�?

再去打开�Q?http://localhost:8080/axis/servlet/AxisServlet",或者，再刷新�?br>便可以看刎ͼ�我们新发布的一个webservice接口服务�Q�其名�ؓ�Q?OrderProcessor "
此服务下的个�Ҏ��Q�其名�ؓ�Q?processOrder "�?/p>

点击服务对应�?�Q�WSDL�Q?可见服务WSDL描述内容。在其中也可以得服务的访问地址�Q?br>"http://localhost:8080/axis/services/OrderProcessor?wsdl"
服务器端的开发，搞定了！

-:) -:) -:)

接下来，准备开发，客户端的开发�?/p>

* Client.java *
*�?*******************************
package samples.userguide.example5;

/**
* This is a JavaBean which represents an order for some products.
* Copyright: Copyright (c) 2007-1
* @author Black skin (blackskin@126.com)
* @version 1.0
*/

import java.net.URL;

import org.apache.axis.AxisFault;
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.utils.Options;

import javax.xml.namespace.QName;
import javax.xml.rpc.ParameterMode;

public class Client {
public static void main(String[] args) throws Exception {
//Options options = new Options(args);
String urlWsdl = "http://localhost:8080/axis/services/OrderProcessor?wsdl";

Order order = new Order();
order.setCustomerName("Black Skin");
order.setShippingAddress("275 Grove Street, Newton, MA");

String[] items = new String[] { "apple", "160ml-Milk" };
int[] quantities = new int[] { 8, 4 };

order.setItemCodes(items);
order.setQuantities(quantities);

Service service = new Service();
Call call = (Call) service.createCall();
QName qn = new QName("urn:BeanService", "Order");

call.registerTypeMapping(Order.class, qn,
    new org.apache.axis.encoding.ser.BeanSerializerFactory(
      Order.class, qn),
    new org.apache.axis.encoding.ser.BeanDeserializerFactory(
      Order.class, qn));
String result;
try {
   //call.setTargetEndpointAddress(new java.net.URL(options.getURL()));
   call.setTargetEndpointAddress(new java.net.URL(urlWsdl));
   call.setOperationName(new QName("OrderProcessor", "processOrder"));
   call.addParameter("arg1", qn, ParameterMode.IN);
   call.setReturnType(org.apache.axis.encoding.XMLType.XSD_STRING);

result = (String) call.invoke(new Object[] { order });
} catch (AxisFault fault) {
result = "Error : " + fault.toString();
}

System.out.println(result);
}
}

********************************�?

oK! 到此�Q�一个完整的Webservice例子��搞定了�?/p>

另外�Q�Axis �q�提供了一些工��P��?" wsdl2java "�? java2wsdl "

处理的方式与�Ҏ��Q?br> java2wsdl:
1. 以上��Z��Q�在以上工程的class输出目录新徏一BAT文�g�Q�名为：“java2wsdl.bat”
2. 其内容�ؓ�Q?br> * java2wsdl.bat *
*�?*******************************
set AXIS_LIB=C:\axis-1_4\lib
SET CLASSPATH=.;%CLASSPATH%;%AXIS_LIB%\wsdl4j-1.5.1.jar;%AXIS_LIB%\axis.jar;%AXIS_LIB%\jaxrpc.jar;%AXIS_LIB%\saaj.jar;%AXIS_LIB%\commons-discovery-0.2.jar;%AXIS_LIB%\commons-logging-1.0.4.jar

java org.apache.axis.wsdl.Java2WSDL -o Order.wsdl -l"http://localhost:8080/axis/services/OrderProcessor" -n "urn:BeanService" -p"samples.userguide.example5.Order" "urn:Order" samples.userguide.example5.BeanService
********************************�?

把AXIS_LIB设�ؓ正确的本地包路径�Q�再�q�行“java2wsdl.bat”�Q?br>便可以在目录下看��C��个文�Ӟ��“Order.wsdl”�Q�通过�q�个WSDL文�g�Q�可以生成Webservice接口服务的框�Ӟ��
既可以是服务器端�Q�也可以是客��L��框架。其�l�节�Q�可以参考下一节�?/p>

处理的方式与�Ҏ��Q?br> wsdl2java :
1. 以上��Z��Q�把Order.wsdl拯��q�来�Q�在其目录下新徏一BAT文�g�Q�名为：“wsdl2java.bat”
2. 其内容�ؓ�Q?br> * wsdl2java.bat *
*�?*******************************
set AXIS_LIB=C:\axis-1_4\lib
SET CLASSPATH=.;%CLASSPATH%;%AXIS_LIB%\wsdl4j-1.5.1.jar;%AXIS_LIB%\axis.jar;%AXIS_LIB%\jaxrpc.jar;%AXIS_LIB%\saaj.jar;%AXIS_LIB%\commons-discovery-0.2.jar;%AXIS_LIB%\commons-logging-1.0.4.jar

java org.apache.axis.wsdl.WSDL2Java Order.wsdl
********************************�?

或者有另外的作法：把服务端的应用启动，直接写成�Q?br>“
java org.apache.axis.wsdl.WSDL2Java http://localhost:8080/axis/services/OrderProcessor?wsdl
”
保存好后�Q�运行这个BAT文�g�Q?br>便会自动生成:
BeanService_pkg\
BeanService.java
BeanServiceService.java
BeanServiceServiceLocator.java
OrderProcessorSoapBindingStub.java
Order.java

ok.

来自:http://blackskin126.bokee.com/viewdiary.14630183.html

狼爱上狸 2007-06-29 12:43 发表评论

axis 的客��L��使用

狼爱上狸 — Fri, 29 Jun 2007 04:33:00 GMT

1. http://ws.apache.org/Axis/下蝲 axis-1_2_1 解压攑֜� D:\softSetup\�?

dl.bitsCN.com�|�管软�g下蝲

2.下蝲 apache-ant-1.6.1 解压攑֜�D:\softSetup\�?bitsCN全力打造网��学习��^�?/font>

3.环境变量讄��:

需要什么来搜一搜吧so.bitsCN.com

JAVA_HOME=C:\jdk1.5.0_06
CATALINA_HOME=tomcat-5.5.15
ANT_HOME=D:\softSetup\apache-ant-1.6.1
AXISCLASSPATH=%AXIS_LIB%\activation.jar;%AXIS_LIB%\mail.jar;%AXIS_LIB%\axis.jar;%AXIS_LIB% \wsdl4j.jar;%AXIS_LIB%\axis-ant.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%\xerces.jar;%AXIS_LIB%\junit.jar;%AXIS_LIB%\wsdl4j-1.5.1.jar
AXIS_HOME=D:\softSetup\axis-1_2_1
AXIS_LIB=%AXIS_HOME%\lib
CATALINA_HOME=D:\softSetup\jakarta-tomcat-5.0.24
classpath=.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar;%AXISCLASSPATH%
path=%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin;%CATALINA_HOME%\bin;%ANT_HOME%\bin so.bitsCN.com�|�管资料库�Q你搜

4.在命令行 �q�行set ��保新加的环境变量生�?

bitsCN.com中国�|�管联盟

5.�Ҏ��合作伙伴�l�的wsdl地址 http://www.****.com/services/OrderService?wsdl保存下来到D:\project\test\wsdl\OrderService.wsdl 需要什么来搜一搜吧so.bitsCN.com

6.在命令行切换�?D:\project\test\wsdl\下运行axis的WSDL2Java 命��o: java org.apache.axis.wsdl.WSDL2Java OrderService.wsdl 生成 bean 文�g,***Service.java,***ServiceLocator.java,***ServiceSoapBindingStub.java �{�文�?可以用Axis的wsdl2java生成web service的客��L��Q�wsdl2java生成的客��L��是stub方式的。它包括endpoint借口、实现该接口的stub�?serviceLocator、可选的单元��试代码。其中，serviceLocator中hard code了服务端地址.

so.bitsCN.com�|�管资料库�Q你搜

7. 应用.写一个表单jsp,提交��C��面jsp文�g�q�行处理(可以写在�c�里,此处��单处�? play.bitsCN.com累了吗玩一下吧

<%@ page contentType="text/html; charset=GBK"%>
<%@page import="org.apache.axis.client.Call"%>
<%@page import="javax.xml.namespace.QName"%>
<%@page import="java.net.MalformedURLException"%>
<%@page import="java.rmi.RemoteException"%>
<%@page import="java.util.*"%>
<%@page import="java.net.URL"%>
<%@page import="org.apache.axis.client.Service"%>
<%@page import="com.newSky.datainterface.beans.*"%>
<%!

dl.bitsCN.com�|�管软�g下蝲

private final static String success = "��试完成";
private final static String fail = "��试��p�|:";
final static String endPoint = "http://www.***.com/services/OrderService";
final static String portName = "addNewOrder";
final static String nameSpace = "http://beans.datainterface.newSky.com";
%>

<%
try {
    Call call = null;
    URL url = null;
    try {
      //create new url
      url = new URL(endPoint);
    }
    catch (MalformedURLException e) {
      System.out.println(fail + e.getMessage());
      e.printStackTrace();
    }
    //create new service
    Service service = new Service();
    try {
      //create new call 需要什么来搜一搜吧so.bitsCN.com
      call = (Call) service.createCall();
    }
    catch (Exception se) {
      System.out.println(fail + se.getMessage());
      se.printStackTrace();
    }
    //讄��服务�?br>    call.setTargetEndpointAddress(url);
    //讄��端口
    call.setOperationName(new QName(endPoint, portName));
    //***********************
     //注册�c�，开�?br>     try {
       QName qn1 = new QName(nameSpace, "OrderUserData");
       call.registerTypeMapping(OrderUserData.class, qn1,
                                new org.apache.axis.encoding.ser.BeanSerializerFactory(OrderUserData.class, qn1),

bbs.bitsCN.com国内最早的�|�管论坛

                                new org.apache.axis.encoding.ser.BeanDeserializerFactory(OrderUserData.class, qn1));

     }
     catch (Exception EQ) {
       EQ.printStackTrace();
     }
    //注册�c�，�l�束
    //讄��q�回�c�d��
    // set bean 此处省略。�?br>    try {
      //调用服务
      System.out.println("************* ��试开�?******************");
      call.setUsername(request.getParameter("id"));
      String result = (String) call.invoke(new Object[] {new Integer(request.getParameter("id)),
                                             new String(request.getParameter("pwd")), orderData});

so.bitsCN.com�|�管资料库�Q你搜

System.out.println(result);

bbs.bitsCN.com国内最早的�|�管论坛

      if(result.equals("-100")){
        out.write("用户名密码错�?);
      }
       else{
        out.write("成功");
      }
      System.out.println("************* ��试完成 ******************");
    }
    catch (RemoteException re) {
      System.out.println(fail + re.getMessage());
      //re.printStackTrace();
    }
}
catch (Exception e) {
    // e.printStackTrace();
}
%>

bitsCN全力打造网��学习��^�?/p>

8. ok ^_^ bitsCN全力

来自:http://www.bitscn.com/java/webservice/200611/82110.html

狼爱上狸 2007-06-29 12:33 发表评论

用Axis开发基于Java的Web服务

狼爱上狸 — Fri, 29 Jun 2007 02:17:00 GMT

概述

　　本文介绍了一个比较简单实用的��Z��Java的SOAP引擎——Apache�l�织推出的Axis——的安装、配�|�和应用开发方法，希望�Ҏ��兴趣做基于Java的Web Services应用开发的朋友有所帮助�?

　　Axis��?/font>

　　Axis是Apache�l�织推出的SOAP引擎�Q�Axis��目是Apache�l�织著名的SOAP��目的后�l�项目，目前最新版本是采用Java开发的1.1版本�Q�C++的版本正在开发之中。Axis v1.1软�g包可以从http://ws.apache.org/axis/dist/1_1/下蝲得到�?/p>

　　Axis的安�?/strong>

　　应用Axis开发Web Services�Q�你需要有一个支持Servlet�?a target=_blank>服务�?/u>引擎�Q�比如广��Z�h知的Tomcat�Q�Tomcat也是由Apache�l�织所提供的，目前的最新版本�ؓ4.1.24�Q?a target=_blank>下蝲地址为http://jakarta.apache.org/builds/jakarta-tomcat-4.0/release/v4.1.24/�Q�。在此之前当然你机器必须已经装好了JDK1.3以上的版本，当安装好Tomcat之后�Q�只需��?a target=_blank>下蝲的Axis软�g包解压羃�Q�将其中�?#8220;webapps”目录下的“axis”目录整个拯��到Tomcat安装目录下的“webapps”目录下即可�?/p>

　　Axis的配�|?/strong>

　　Axis��Z��Java开发，可以部��v于多�U?a target=_blank>操作�pȝ��Q��用前需要配�|�一�p�d��的系�l�变量，在此假定你已�l�在本机上装好了Tomcat 4.0以上的版本，需要配�|�的�pȝ��变量如下表所�C�：

CATALINA_HOME
C:\Tomcat_4_1

�Q�此处应为Tomcat的安装位�|�，注意路径名中不要有空��|��

AXIS_HOME
%CATALINA_HOME%\webapps\axis

AXIS_LIB
%AXIS_HOME%\lib

AXISCLASSPATH
%AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-discovery.jar; %AXIS_LIB%\commons-logging.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

　　如果你不愿做�q�么�J�琐的类路径讄��Q�可以直接将axis软�g包中“lib”目录下的所�?jar文�g加入到系�l�环境变量CLASSPATH中即可�?/p>
　　Axis的测�?/strong>

　　安装配置完毕后，应测试一下是否Axis可以正确�q�行了�?/p>
　　启动Tomcat服务�?/u>�Q�在��览器中讉K��http://localhost:8080/axis/happyaxis.jsp�Q�如果页面显�C�有错误�Q�则需要回头检查一下相关配�|�是否正��，如果��览��面能正��显�C�出�pȝ��l��g、属性等参数配置信息�Q�则表示安装成功�Q�如下图所�C�：

　　现在可以开始开发你的Web Services应用了�?/p>

作者：飞鹰出处�Q�yesky责�Q�~�辑�Q?方舟 [ 2003-08-21 16:50 ]

本文介绍了一个比较简单实用的��Z��Java的SOAP引擎的安装、配�|�和应用开发方�?/div>

　　服务的发�?/font>

　　Axis提供了两�U�服务发布方式，一�U�是��x��发布�Q�Instant Deployment�Q�，一�U�是定制发布�Q�Custom Deployment�Q��?

　　使用��x��发布

　　对即时发布的支持是Axis的特色之一�Q��用即时发布��用户只需有提供服务的Java�cȝ��源代码，卛_��其�q�速发布成Web服务。每当用戯��用这�c�L��务的时候，Axis会自动进行编译，即��服务�?/u>重启了也不必对其做�Q何处理，使用非常��单快捗��?/p>
　　使用��x��发布首先需要一个实现服务功能的Java源文�Ӟ��其扩展名改�?jws�Q�Java Web Service的羃写）�Q�然后将该文件放�?#8220;……\webapps\axis”目录下即可�?/p>
　　在此�l�出一个从英里到公里的长度单位转换的服务，其源码如下：

文�gDistance.jws

/**

* @author 飞鹰

*/

public class Distance

{

public double convertMile2Kilometre( double mile )

{

//实现英里到公里的距离转换

return mile * 1.609;

}//convertMile2Kilometre()

}/* Distance */

　　��其攑ֈ�“……\webapps\axis”目录�Q�通过讉K��http://localhost:8080/axis/Distance.jws?wsdl可以看到�q�个服务的WSDL描述文�g�Q�这说明Distance服务被成功发布了。如下图所�C�：

　　使用定制发布

　　��x��发布是一��o人激动的技术，它��Web服务的开发变得如此简单；然而即时发布�ƈ不��L��最好的选择�Q�比如有些应用系�l�是�W�三�Ҏ��供的�Q�我们没有购买源代码�Q�只�?class文�g�Q�但我们又希望将�q�个应用�pȝ��的一些功能对外发布成Web服务�Q��其能够在更大范围内��生作用，�q�个时候即时发布技术就无能为力了。此外，��x��发布技术�ƈ不灵�z�，无法�q�行更多的服务配�|�，�q��得它�q�不能满��一些特定系�l�的需求�?/p>
　　因此�Q�Axis提供了另一�U�服务发布方式，�q�就是定制发布�?/p>
　　在此�l�出一个从加仑到升的容�U�单位�{换的服务�Q�其源码如下�Q?/p>
　　文�gCapacity.java

package samples.capacity;

/**

* @author 飞鹰

*/

public class Capacity

{

public double convertGallon2Litre( double gallon )

{

//实现加仑到升的容�U��{�?/p>
return gallon * 4.546;

}//convertGallon2Litre()

}/* Capacity */

　　��其�~�译�?class文�g�Q�放�|�到“……\webapps\axis\samples\capacity”目录下，卛_��着手进行发布�?/p>
　　定制发布不需要构�?jws文�g�Q�但必须创徏服务发布描述文�gdeploy.wsdd�Q�Web Service Deployment Descriptor的羃写）�Q�这个文件负责描�q�服务的名称、入口等信息�Q�其内容如下�Q?/p>
　　文�gdeploy.wsdd

xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">

　　��该文�g也放�?#8220;……\webapps\axis\samples\capacity”目录下，然后可以采用Axis提供的一个客��L��理工具——AdminClient来完成服务的定制发布�?/p>
　　�?#8220;……\webapps\axis\samples\capacity”目录下，�q�行�Q?/p>
java -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient deploy.wsdd

　　可以看到以下�q�行�l�果�Q?/p>
Processing file deploy.wsdd

Doneprocessing

　　�q�表明Capacity服务定制发布完成�?/p>
　　通过讉K��http://localhost:8080/axis/services/Capacity?wsdl可以看到�q�个服务的WSDL描述文�g�Q�这说明Capacity服务被成功发布了。如下图所�C�：

作者：飞鹰出处�Q�yesky责�Q�~�辑�Q?方舟 [ 2003-08-21 16:50 ]

本文介绍了一个比较简单实用的��Z��Java的SOAP引擎的安装、配�|�和应用开发方�?/div>

　　服务的访�?/font>

　　GET方式的服务访�?/strong>

　　一般的SOAP消息都是采用POST方式实现传递，但也可以通过GET方式来访问。比如以下给出的一个服务—�?#8220;HelloWorld”�Q�其源码如下�Q?

文�gHelloWorld.jws

/**

* @author 飞鹰

*/

public class HelloWorld

{

public String helloWorld()

{

//�?a target=_blank>服务�?/u>端打印输�?/p>
System.out.println( "Hello World!" );

//�q�回相应字符�?/p>
return "Hello World!";

}//helloWorld()

}/* HelloWorld */

　　�q�个服务�l�出一个名�?#8220;helloWorld”的无入口参数的操作，�q�回一个内容�ؓ“Hello World�Q�的字符�?#8221;�Q�同时在服务�?/u>端打�?#8220;Hello World�Q?#8221;�Q�将该文件放�?#8220;……\webapps\axis”目录下，卛_��通过GET�Ҏ��直接讉K��该服务，讉K��的地址为http://localhost:8080/axis/HelloWorld.jws?method=helloWorld�Q�可以看到返回的SOAP信封消息�Q�同�?a target=_blank>服务�?/u>端给��Z��相应的显�C�Z��?#8220;Hello World�Q?#8221;�q�表明HelloWorld服务被成功访问了。如下图所�C�：

　　客户端服务访问编�E?/strong>

　　Axis提供了一套API来实现SOAP�Q�从http://localhost:8080/axis/docs/apiDocs/index.html可以看到Axis的API文档�?/p>
　　其中�Q�org.apache.axis.client.Call和org.apache.axis.client.Service是两个比较常用的�c�，一般的客户端程序欲讉K��一个Web Service�Ӟ��都要生成一个客��L��的Service对象和Call对象�Q�在讉K��服务之前�Q�首先要对Call对象讄��相应的参敎ͼ�包括服务的位�|�、操作名、入口参数、返回值类型等�Q�最后调用Call对象的invoke�Ҏ��讉K��服务�?/p>
　　以下�l�出了一个客��L��讉K��Web服务的例�E�——AXISTest.java�Q?/p>
　　文�gAXISTest.java

package axisexercise;

import org.apache.axis.client.Call;

import org.apache.axis.client.Service;

import org.apache.axis.encoding.XMLType;

import javax.xml.rpc.ParameterMode;

/**

* @author 飞鹰

*/

public class AXISTest

{

public static void main( String[] args ) throws Exception

{

Service service = new Service();

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

//////////讉K��x��发布的Distance服务

//讄��讉K��?/p>
call.setTargetEndpointAddress( "http://localhost:8080/axis/Distance.jws" );

//讄��操作�?/p>
call.setOperationName( "convertMile2Kilometre" );

//讄��入口参数

call.addParameter( "op1", XMLType.XSD_DOUBLE, ParameterMode.IN );

call.setReturnType( XMLType.XSD_DOUBLE );

Double d1 = new Double( 190 );

//调用服务

System.out.println( d1 + " 英里相当�?" +

call.invoke( new Object[] {d1} ) + " 公里�Q? );

//////////讉K��定制发布的Capacity服务

call = ( Call ) service.createCall();

//讄��讉K��?/p>
call.setTargetEndpointAddress( "http://localhost:8080/axis/services/Capacity" );

//讄��操作�?/p>
call.setOperationName( "convertGallon2Litre" );

//讄��入口参数

call.addParameter( "op1", XMLType.XSD_DOUBLE, ParameterMode.IN );

call.setReturnType( XMLType.XSD_DOUBLE );

d1 = new Double( 10.00 );

//调用服务

System.out.println( d1 + " 加仑相当�?" +

call.invoke( new Object[] {d1} ) + " 升！" );

} //main()

}/* AXISTest */

　　�~�译�q�行后运行可以看��C��下的�l�果�Q?/p>
　　190.0英里相当�?05.71公里�Q?/p>
　　10.0加仑相当�?5.46升！
　
　　注意�E�序在访问即时发布的Distance服务和定制发布的Capacity服务时的不同�Q�前者的服务讉K��点地址为http://localhost:8080/axis/HelloWorld.jws�Q�而后者的则�ؓhttp://localhost:8080/axis/services/Capacity�?br>

来自�Q?a >http://hi.baidu.com/zxhcloth/blog/item/bb8637dbf28e0b67d0164ea5.html

狼爱上狸 2007-06-29 10:17 发表评论

AXIS全攻略（二）

狼爱上狸 — Thu, 21 Jun 2007 08:20:00 GMT

六、服务的讉K��

　　GET方式的服务访�?/p>
　　一般的SOAP消息都是采用POST方式实现传递，但也可以通过GET方式来访问。比如以下给出的一个服务—�?#8220;HelloWorld”�Q�其源码如下�Q?

文�gHelloWorld.jws
public class HelloWorld
{
    public String helloWorld()
    {
          System.out.println( "Hello World!" );//在服务器端打印输�?nbsp;
          return "Hello World!";//�q�回相应字符�?br>    }
}

　　�q�个服务�l�出一个名�?#8220;helloWorld”的无入口参数的操作，�q�回一个内容�ؓ“Hello World�Q�的字符�?#8221;�Q�同时在服务器端打印“Hello World�Q?#8221;�Q�将该文件放�?#8220;……\webapps\axis”目录下，卛_��通过GET�Ҏ��直接讉K��该服务，讉K��的地址�?a href="http://localhost:8080/axis/HelloWorld.jws?method=helloWorld">http://localhost:8080/axis/HelloWorld.jws?method=helloWorld�Q�可以看到返回的SOAP信封消息�Q�同时服务器端给��Z��相应的显�C�Z��?#8220;Hello World�Q?#8221;�q�表明HelloWorld服务被成功访问了�Q�生成的SOAP信封消息为：

-     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-
-
Hello World!

七、客��L��服务讉K��~�程

　　Axis提供了一套API来实现SOAP�Q�从http://localhost:8080/axis/docs/apiDocs/index.html可以看到Axis的API文档�?/p>
　　其中�Q�org.apache.axis.client.Call和org.apache.axis.client.Service是两个比较常用的�c�，一般的客户端程序欲讉K��一个Web Service�Ӟ��都要生成一个客��L��的Service对象和Call对象�Q�在讉K��服务之前�Q�首先要对Call对象讄��相应的参敎ͼ�包括服务的位�|�、操作名、入口参数、返回值类型等�Q�最后调用Call对象的invoke�Ҏ��讉K��服务�?/p>
　　以下�l�出了一个客��L��讉K��Web服务的例�E�——AXISTest.java�Q?/p>
　　文�gAXISTest.java

package axisexercise;

import org.apache.axis.client.Call;

import org.apache.axis.client.Service;

import org.apache.axis.encoding.XMLType;

import javax.xml.rpc.ParameterMode;

public class AXISTest
{
    public static void main( String[] args ) throws Exception
    {
         创徏service和call对象�Q�这些对象是标准的JAX-RPC对象�Q�这些对象用于存储服务调用的数据�Q�metadata�Q��?/p>
Service service = new Service();
Call call = ( Call ) service.createCall();
//////////讉K��x��发布的Distance服务

//讄��讉K��?br> call.setTargetEndpointAddress( "http://localhost:8080/axis/Distance.jws" );

//讄��操作�?br> call.setOperationName( "convertMile2Kilometre" );

//讄��入口参数
call.addParameter( "op1", XMLType.XSD_DOUBLE, ParameterMode.IN );

//讄��q�回参数�c�d��
call.setReturnType( XMLType.XSD_DOUBLE );
Double d1 = new Double( 190 );

//调用服务�Q�在invoke�Ҏ��中传入的是包含调用参数的数组
System.out.println( d1 + " 英里相当�?" +
call.invoke( new Object[] {d1} ) + " 公里�Q? );

//////////讉K��定制发布的Capacity服务
call = ( Call ) service.createCall();

//讄��讉K��?br> call.setTargetEndpointAddress( "http://localhost:8080/axis/services/Capacity" );

//讄��操作�?br> call.setOperationName( "convertGallon2Litre" );

//讄��入口参数
call.addParameter( "op1", XMLType.XSD_DOUBLE, ParameterMode.IN );
call.setReturnType( XMLType.XSD_DOUBLE );
d1 = new Double( 10.00 );

//调用服务
System.out.println( d1 + " 加仑相当�?" +
call.invoke( new Object[] {d1} ) + " 升！" );

    } //main()

}/* AXISTest */

�~�译�q�行后运行可以看��C��下的�l�果�Q?/p>
190.0英里相当�?05.71公里�Q?/p>
10.0加仑相当�?5.46升！
　
　　注意�E�序在访问即时发布的Distance服务和定制发布的Capacity服务时的不同�Q�前者的服务讉K��点地址�?a href="http://localhost:8080/axis/HelloWorld.jws">http://localhost:8080/axis/HelloWorld.jws�Q�而后者的则�ؓhttp://localhost:8080/axis/services/Capacity�?/p>

八、服务类型：RPC, Document, Wrapped, and Message
在Axis中，有四�U�服务类型：

1. RPC服务�Q?br>PRC服务是AXIS中的默认服务�Q�当你通过 or 标签�q�行部��v的时候，使用的就是RPC服务。RPC服务遵��@SOAP RPC和其�~�码规范。AXIS可以��XML反序列化成java对象�Q��ƈ��其传给服务的方法。�ƈ且可以将服务的方法返回的JAVA对象序列化成XML�?/p>
2.Document / Wrapped services
Document services and wrapped services are similar in that neither uses the SOAP encoding for data; it's just plain old XML schema. In both cases, however, Axis still "binds" Java representations to the XML (see the databinding section for more), so you end up dealing with Java objects, not directly with XML constructs.

Document和Wrapped服务都不使用SOAP�~�码数据�Q�这一�Ҏ��他们�怼�的地斏V��他们仅仅��用旧的XML模式。然而，在这两种服务中，AXIS��捆�l�Java的表�C�到XML文档中，所以你最�l�处理的是java对象而不直接处理XML�?/p>
下面是包含定单的一个简单的SOAP消息�Q�你可以看到Document �?Wrapped 服务的区别所在：
   xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">

   SK001
   1
   Sushi Knife

相应的XML模式如下�Q?/p>





对于Document�c�d��服务�Q�他��映��成下面的方法：
public void method(PurchaseOrder po)

八、soap envolop(soap信封)
1. soap信封
在客��L��发出服务��h��以及服务端返回请求结果的时候，在网�l�中传输的是SOAP信封。首先客��L��E�序��请求参数及��h��的方法序列到XML的文件中�Q�SOAP信封�Q�，�q�将SOAP信封传送到服务器端。服务器端接受到SOAP信封后，��解析这个SOAP信封�q�反序列化调用参数及�Ҏ��q�将该方法的调用�l�果��装成SOAP信封�Q�序列到XML的文件中�Q�返回给客户端，客户端同样将SOAP信封中封装的�q�回�l�果反序列化为想要得到的�l�果�?/p>
我们来看下面�q�段客户端程序的SOAP信封�Q?br>(1) 客户端程序：
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import javax.xml.namespace.QName;

public class TestClient
{
     public static void main(String [] args)
     {
        try
        {
             String endpoint = "http://nagoya.apache.org:5049/axis/services/echo";
             Service service = new Service();
             Call call = (Call) service.createCall();

             call.setTargetEndpointAddress( new java.net.URL(endpoint) );
             call.setOperationName(new QName("http://soapinterop.org/", "echoString"));

             String ret = (String) call.invoke( new Object[] { "Hello!" } );

             System.out.println("Sent 'Hello!', got '" + ret + "'");
         }
catch (Exception e)
{
             System.err.println(e.toString());
         }
     }
}

(2) SOAP信封�Q?br>
       xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

   Hello!

2. 参数命名�Q?br>在上面的代码中，AXIS自动��在Soap消息中的函数调用参数命名为arg0,arg1�{�等�Q�如果你��x��照自己定义的参数名调用方法的话，很简单，在你调用invoke函数之前只要调用addParameter()函数卛_��。如下所�C�：

   call.addParameter("testParam",
      org.apache.axis.Constants.XSD_STRING,
      javax.xml.rpc.ParameterMode.IN);
   call.setReturnType(org.apache.axis.Constants.XSD_STRING);
��testParam定义��用函数的�W�一个参敎ͼ��q�里也只有一个参敎ͼ��Q�这里也可以同时定义该参数的�c�d��以及该参数是输入、输��是输入输出类型。在�q�里它是一个输入类型，现在当你�q�行�E�序�Q�你��得��C��面的消息�Q?br>
       xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

   Hello!

3. �q�回�c�d��
在上面的代码中我们知道echoString函数��返回一个String对象�Q�而且我们也希望通过客户端的调用能够�q�回预期的String对象。下面是一个典型的通过调用echoString函数后获得的Soap信封�Q�消息）�?br>
     xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">


Hello!


我们可以看到�q�里已经声明了返回类型（�Q�是一个String对象。这样Axis��可以将�q�回�l�果反序列化成我们想要的String对象了�?br>很多工具都会��这�U�确定的�c�d��信息攑ֈ�XML文�g中，以生成消息的“自我描述部分”�Q�另一斚w��Q�还有一些工��h��象下面这栯��回响应的�Q?Many toolkits put this kind of explicit typing information in the XML to make the message "self-describing". On the other hand, some toolkits return responses that look like this:)

       xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

   Hello, I'm a string!

在这里�ƈ没有�q�回�c�d��Q�那么我们怎么知道应该��返回结果反序列化成什么类型的�l�果呢？�{�案是metadata�Q�在�q�种情况下，我们需要一个描�q�来指明我们期望的返回类型，下面�q�行代码说明了在客户端应该如何去做：
call.setReturnType( org.apache.axis.Constants.XSD_STRING );
�q�个�Ҏ��会告诉Axis客户端，如果�q�回的结果没有指明类型的话，那么Axis��会把返回类型指明�ؓxsi:type属性所预定义的SOAP�c�d��Q�在�q�里XSD_STRING属性所指明的是String�c�d��?/p>
所以也有这样一个相似的�Ҏ��Q�允�怽�指定所期望�q�回的Java的类�?br>call.setReturnClass(String.class);

http://blog.csdn.net/tenwang1977/archive/2004/09/06/95991.aspx

狼爱上狸 2007-06-21 16:20 发表评论

使用Apache Axis部��v Web服务时的常见问题及其解决�Ҏ��

狼爱上狸 — Thu, 21 Jun 2007 08:02:00 GMT

来自: http://www.ibm.com/developerworks/cn/webservices/ws-axisfaq/

1 引言

随着Web服务技术的发展和成熟，其方便性和易用性已逐渐被�h们所接受�Q�越来越多的合作伙伴之间开始利用Web服务来实现合作方之间的数据接口。��用Apache Axis和Linux�q�_��是一�U�低成本的Web服务解决�Ҏ��Q�但Apache Axis文档的FAQ对开发者来说内容还不够丰富�Q�本文作者将自己使用Axis旉��到的问题和解��x��法整理成文，奉献�l�Web服务的开发�h员和�Ҏ��感兴��的读者朋友，旨在帮助大家节约一些宝�늚�旉��。有关Web服务的基��知识�Q�读者可以阅��d��考文献中推荐的文档。作者未在文中介�l�Apache和Resin的安装方法，读者可以参考相关网站的说明文档�?

作者��用的软�g环境如下�?

操作�pȝ��Q�Red Hat Linux 7.2

Web服务�? Apache 1.3.27

应用服务器：Resin 2.1.8 ( http://www.caucho.com/ )

SOAP服务器：Apache Axis 1.1

XML解析器：Xerces 2.5.0�Q�Xalan 2.5.1

JDK版本�Q�JDK 1.4.1

回页�?/font>

2 使用Axis时的常见问题及其解决�Ҏ��

2.1 Axis�q�行需要哪些jar文�g

对Axis解包后，��axis-1_1/webapps/axis/WEB-INF/lib/目录下的jar文�g复制�?usr/local/apache/htdocs/WEB-INF/lib目录�?Web应用�E�序的目�?。应包括以下jar文�g�?

axis-ant.jar axis.jar commons-discovery.jar commons-logging.jar jaxrpc.jar log4j-1.2.8.jar name.txt saaj.jar wsdl4j.jar

如果需要��用axis提供的测试页面，�q�要��axis-1_1/webapps/axis/目录下的文�g复制�?usr/local/apache/htdocs/axis/目录下。应包括以下募?

EchoHeaders.jws fingerprint.jsp happyaxis.jsp index.html

2.2 应该使用哪一�U�XML解析�?/font>

XML解析器选用不当�Q�经�怼��D��使用Apache Axis时出��C��些莫名其妙的问题�?

�׃��Apache Axis �q�未对Resin内置的xml解析器进行过��试�Q�因此推荐读者��用已通过��试的Xerces xml解析器。可以从 http://xml.apache.org/xalan-j/index.html 处下载Xalan的Java版XSLT处理器，其中包含了Xerces的Java版XML解析器，不需要再单独下蝲xml解析器�?

Xalan 2.5.1解包后，��bin/目录下的xercesImpl.jar、xml-apis.jar和xalan.jar复制到resin安装目录的lib/目录下，例如/usr/local/resin/lib�?

�~�辑/etc/目录下的profile文�g�Q�找到设�|�CLASSPATH环境变量的位�|�，在其后加入下面的内容(B shell)�?

XMLPARSER=$RESIN_HOME/lib/xalan.jar:$RESIN_HOME/lib/xercesImpl.jar:$RESIN_HOME/lib/xml-apis.jar export CLASSPATH=$XMLPARSER:$CLASSPATH

2.2.1 注意事项
如果CLASSPATH中包含其它的XML解析器设�|�，应将其从CLASSPATH环境变量的设�|�中��L��Q�以免发生冲�H��?

2.3 如何在Resin中��用Xerces的XML解析�?/font>

通过修改resin.conf��resin的XmlParser�|�换为Xerces的XmlParser。在resin.conf对应的Web应用�E�序配置中加入以下设�|��?

配置完成后重新启动Resin�?/p>
2.4 如何排除XML解析器出现的异常

2.4.1 问题描述

使用http://test.com/axis查看已部�|�的服务时出现Axis内部错，昄��有关WSDD配置的异�怿�息。如果把WEB-INF目录下的server-config.wsdd删除�Q�再查看��正�怺��Q�但只能看到AdminService和Version两个�pȝ��~�省的服务，后来部��v的服务都看不��C��?

2.4.2 原因分析

Axis会在WEB应用�E�序的WEB-INF/目录下自动生成一个名字�ؓserver-config.wsdd的xml文�g�Q�其中记录了已部�|�的WEB服务。每部��v一个新的WEB服务�Ӟ��Axis都会��新服务的描�q�C��息加入到server-config.wsdd中�?

故障站点使用的XmlParser是resin内置的XmlParser�Q�Axis�q�未对其对进行过兼容性测试，查看WEB服务信息旉��要从server-config.wsdd(�q�是一个xml文�g)取得已部�|�的WEB服务描述信息�Q�当server-config.wsdd的内容较复杂�Ӟ��resin内置的XmlParser因某�U�原因出现异常，��D��Axis内部错误。Server-config.wsdd中记录的Web服务描述信息较少时不会出现异常�?

2.4.3 解决�Ҏ��

修改resin.conf�Q�将resin的XmlParser�|�换为Xerces的XmlParser。置换方法参�?.3节�?/p>
2.4.4 ��结

如果Axis报告的错误中有关于xml解析器的错误�Q�徏议读者参照本��节描述的方法更换应用服务器的xml解析器，��会有助于问题的解决�?

2.5 如何��Axis集成到Resin或其它应用服务器

Axis是以Servlet的方式运行的�Q�而Resin的作用相当于Servlets容器(Container)�Q�因此只要配�|�得当，��可以��Axis在Resin环境中运行，�q�一点也适用于Resin以外的其它应用服务器。在Resin中配�|�Axis的方法如下�?

��axis-1_1/webapps/axis/WEB-INF/web.xml中的Servlet配置��复制到resin.conf中对应的Web应用�E�序配置中。通常应包括以下内宏V�?

AxisServlet Apache-Axis Servlet org.apache.axis.transport.http.AxisServlet AdminServlet Axis Admin Servlet org.apache.axis.transport.http.AdminServlet 100 SOAPMonitorService SOAPMonitorService org.apache.axis.monitor.SOAPMonitorService SOAPMonitorPort 5001 100 AxisServlet /axis/servlet/AxisServlet AxisServlet *.jws AxisServlet /services/* SOAPMonitorService /SOAPMonitor wsdl text/xml xsd text/xml

2.6 Axis提供了哪些开发工�?/font>

Apache Axis提供了WSDL2Java和Java2WSDL两个开发工兗��?

WSDL2Java利用已知的WSDL文�g生成服务端和客户端代码。该WSDL文�g可以是由合作伙伴提供的，也可以是利用Java2WSDL生成的。Java2WSDL�Ҏ��已有的Java�c�L��件生成WSDL文�g�Q�Java�c�L��件可以是接口�c�L��Ӟ��q�不需要实现细节�?

此外Axis�q�提供了SoapMonitorApplet和TCPMon工具�Q�可用于监测Web服务�?

2.7 如何生成Web服务的服务端和客��L��代码

2.7.1 生成或取得WSDL文�g

Java2WSDL是Axis提供的利用Java�c�L��件得到WSDL文�g的工兗��类文�g可以使用接口文�g�~�译生成�Q�例如下面的接口文�gSoftwarePrice.java�?

package samples.userguide.example6; /** * Interface describing a web service to set and get software prices. **/ public interface SoftwarePrice { public void setWidgetPrice(String softWareName, String price); public String getWidgetPrice(String softWareName);

�~�译SoftwarePrice.java�?

javac SoftwarePrice.java

��SoftwarePrice.class复制到正��的package路径下�?

执行下面的命�?

java org.apache.axis.wsdl.Java2WSDL -o sp.wsdl -l"http://test.com:80/services/SoftwarePrice" -n "urn:SoftwarePrice" -p"samples.userguide.example6" "urn:Example6" samples.userguide.example6.SoftwarePrice

各参数的含义如下�?

-o�Q�指定输出的WSDL文�g的文件名�?
-l�Q�指定服务的位置�?
-n�Q�WSDL文�g的目标名字空间�?
-p�Q�指定从package到名字空间的映射�Q�这里可以有多个映射�?

最后面的类文�g包含了Web服务的接口�?

该命令执行后�Q�将生成sp.wsdl文�g�?

如果按CLASSPATH的设�|�找不到指定的类文�g�Q�Axis��报告异常，如下所�C��?

java.lang.ClassNotFoundException: samples.userguide.example6.SoftwarePrice at java.net.URLClassLoader$1.run(URLClassLoader.java:198) at java.security.AccessController.doPrivileged(Native Method) ……

如果出现上面的问题，��h��查是否已��有关类文�g复制到正��的位置或CLASSPATH讄��是否正确�?

生成WSDL文�g以后�Q�就可以利用Axis提供的WSDL2Java工具生成Web服务的服务端代码和客��L��代码了�?

2.7.1.1 注意事项

WSDL文�g也可以由合作伙伴提供。这�U�情况下合作伙伴往往是Web服务的提供者或标准接口的制定者，开发者只要按照既定的WSDL文�g生成客户端或服务端代码就可以了�?

2.7.2 生成客户端或服务端代�?

WSDL2Java工具用于从WSDL文�g生成客户端存根（stub�Q�代码，服务端框�Ӟ��skeleton�Q�代码以及WSDL中的数据�c�d��文�g(生成与之对应的Java代码)。开发�h员只需向框架代码中补充相关的业务逻辑代码卛_��得到完整的Web服务代码�Q�因此该工具极大地减��M��开发�h员的�~�码负担。WSDL2Java的��用�D例如下�?

java org.apache.axis.wsdl.WSDL2Java --server-side --skeletonDeploy true MyService.wsdl

执行上述命��o后将生成下列文�g�?

No. 文�g 用�?/td>

1. deploy.wsdd MyService服务的部�|�描�q�文�?/td>

2. MyService.java MyService服务的接口文�?/td>

3. MyServiceService.java 获得MyService服务的接口文�?/td>

4. MyServiceServiceLocator.java 实现MyServiceService接口

5. MyServiceSoapBindingImpl.java 实现MyService接口�Q�应向其中补充业务逻辑

6. MyServiceSoapBindingSkeleton.java MyService服务的服务端框架代码,实现MyService, org.apache.axis.wsdl.Skeleton接口

7. MyServiceSoapBindingStub.java MyService服务的客��L��存根代码,实现MyService接口

8. undeploy.wsdd 注销MyService服务的部�|�描�q�文�?/td>

2.7.3 �~�写Web服务客户端代�?/p>
Web服务的客��L��E�序完成对Web服务的调用，其程序结构如下�?

import com.chinavnet.zx.service.v1_0.*;// WSDL2Java生成的package的名字空�? public class TestClient { public static void main (String[] args) throws Exception { com.chinavnet.zx.service.v1_0.SPInterfaceForVNetLocator locator = new SPInterfaceForVNetLocator();//获得一个locator对象 locator.setMaintainSession(true); com.chinavnet.zx.service.v1_0.SPInterfaceForVNetSoap service = locator.getSPInterfaceForVNetSoap();//获得服务对象 com.chinavnet.zx.service.v1_0.DetailLedgerFeedbackResult feedbackRes = null; //初始化Web服务中定义的数据�c�d�� try { feedbackRes = service.generalLedgerFeedback();//调用Web服务的方法�ƈ取得�q�回�? System.out.println("FeedbackResult :"); if(feedbackRes != null) { System.out.println("SPID: " +feedbackRes.getSPID()); System.out.println("errorDesc: " +feedbackRes.getErrorDescription()); System.out.println("result: " +feedbackRes.getResult()); }else { System.out.println("feedbackRes is null!"); } } catch (java.rmi.RemoteException re) { // throw new junit.framework.AssertionFailedError("Remote Exception caught: " + re ); re.printStackTrace(); } }//End of main() }//End of TestClient class

��试客户端程序是非常��单的�Q�将客户端程序编译后�Q�执�?java TestClient"卛_��?/p>
2.8 如何�~�写服务端代�?/font>

向MyServiceSoapBindingImpl.java��d��相关的业务逻辑代码后，��WSDL2Java生成的源�E�序�~�译�Q�打包成jar文�g�Q�复制到/usr/local/apache/htdocs/WEB-INF/lib/目录下�?

2.9 如何发布Web服务

有了deploy.wsdd文�g�q�准备好�c�L��件后�Q�就可以发布MyService服务了。Axis在安装后自动发布了AdminService�Q�利用它可以发布新的Web服务。方法如下�?

java org.apache.axis.client.AdminClient -lhttp://localhost:80/services/AdminService deploy.wsdd 上面的命令执行后�Q�有如下提示�? Processing file deploy.wsdd Done processing

2.10 执行WSDL2Java时报�? �c�d��被引用但未定�?

2.10.1 问题描述

执行WSDL2Java时报告下面的异常�Q?/p>

java.io.IOException: Type {http://schemas.xmlsoap.org/wsdl/} ArrayOfFailedRecord is referenced but not defined.

2.10.2 原因分析

出现上述情况可能的原因有�Q?/p>
�c�d��未定义就被引用�?/p>
使用了错误的名字�I�间�?

WSDL文�g中存在输入错误�?

2.10.3 解决�Ҏ��

�l�过仔细��查发现wsdl文�g中的

的type=" s0:ArrayOfFailedRecord"中的s0:前面有一个空��|��空格删除后问题解决了�?/p>
2.10.4 ��结

WSDL文�g中出现的�~�辑错误有可能导致执行WSDL2Java时出�?�c�d��被引用但未定�?错误�?/p>
2.11 server-config.wsdd的作用是什�?/font>

server-config.wsdd记录了axis已发布的Web服务的描�q�C��息�?/p>
2.12 发布Web服务时报�?Exception:: (404)Not Found"

2.12.1 问题描述

执行java org.apache.axis.client.AdminClient -lhttp://localhost:80/services/AdminService deploy.wsdd命��o发布WEB服务时报告如下内宏V�? Processing file deploy.wsdd Exception:: (404)Not Found

Apache的access_log昄��如下�?/p>

127.0.0.1 - - [17/Sep/2003:15:56:33 +0800] "POST /services/AdminService HTTP/1.0" 404 293

2.12.2 原因分析

出现�q�个问题的比较简单的原因可能是端口不对，或URL路径不对(例如路径中多写了目录)�Q�Axis的SoapMonitor服务按指定的端口或URL找不到AdminService�Q�需要检查正��的端口号和URL路径�?

比较深层�ơ的原因��复杂得多了�?/p>
本文作者遇到的是下面的情况�?

AdminService是一个已发布的WEB服务�?

AdminClient使用soap协议同AdminService通信�Q�需要按指定的端口和URL定位AdminService�Q�而原来��用的resin.conf中，有两个web-app配置��，配置A的摘要如下所�C��?

/usr/local/apache/htdocs/

配置B的摘要如下所�C��?/p>

/usr/local/apache/htdocs/esales/

Axis的有关配�|�在配置B中�?/p>
Httpd.conf中的DocumentRoot�?usr/local/apache/htdocs/�?/p>
使用java org.apache.axis.client.AdminClient -lhttp://localhost:80/services/AdminService deploy.wsdd发布WEB服务�Ӟ��需要按http协议解析url: //localhost:80/services/AdminService。由于htdocs/目录下�ƈ没有services/目录(services是Axis在resin.conf中的servlet-mapping)�Q�因此应用服务器按resin.conf中的配置��d��位AdminService �Q�因为url的主机名为localhost�Q�因此resin不会�?lt;host id='test.com'>(配置B)中去定位url�Q�而是到配�|�A中去定位�Q�在配置A中�ƈ没有Axis的配�|�，找不��C��AdminService相关的url�Q�因此报告了前面描述的异常情��c�?

2.12.3 解决�Ҏ��

知道了原因后�Q�按如下�Ҏ��可以解决了�?/p>
��配�|�B中全部关于Axis的配�|�移到配�|�A中，注意相应地要改变/etc/profile中的CLASSPATH变量的倹{�?

保存resin.conf后，重新��d��服务�?使新的CLASSPATH生效)�Q�重新启动resin。再�ơ发布WEB服务�?

java org.apache.axis.client.AdminClient -lhttp://localhost:80/services/AdminService deploy.wsdd

屏幕昄��如下�?/p>

Processing file deploy.wsdd Done processing

WEB服务�l�于发布成功了�?

在发布成功的情况下apache的access_log中会看到如下的log�Q?

tail -f access_log|grep vice 127.0.0.1 - - [17/Sep/2003:16:05:00 +0800] "POST /services/AdminService HTTP/1.0" 200 296 "-" "Axis/1.1"

2.12.4 ��结

本小节描�q�的问题可能是读者遇到的出现最多的异常�Q�但原因�q�不是唯一的。遇到该问题�Ӟ��读者冷静分析出现问题的可能原因�Q�多实验几种解决�Ҏ��Q�最�l�一定可以成功！

2.13 如何监测SOAP��h��和响应流

2.13.1 引言

发布了Web服务以后�Q�如何观察请求和响应数据呢？记录�q�行日志是一�U�传�l�且有效的方法，但对于调试程序来讲还不够方便和直观。值得�ƣ慰的是�Q�Axis为我们提供了在客��L��观察SOAP��h��和响应流数据的工具SoapMonitor�Q�经�q�适当配置后，可以实时地观察到Web服务的SOAP��h��和响应数据。SoapMonitor是一个Java Applet�E�序�Q�通过��览器下载到客户端运行。下面就介绍SoapMonitor的配�|�和使用�Ҏ��?

2.13.2 准备SOAPMonitor ��应用程�?/p>
在Axis 1.1中，没有为我们编译SOAPMonitor.java�E�序�Q�但我们可以在axis-1_1/webapps/axis/目录下找到名字�ؓSOAPMonitorApplet.java的源�E�序文�g�Q�自��p��行编译。该�E�序�~�译后，会生成如下的�c�L��Ӟ��

SOAPMonitorApplet.class SOAPMonitorApplet$ServiceFilterPanel.class SOAPMonitorApplet$SOAPMonitorData.class SOAPMonitorApplet$SOAPMonitorFilter.class SOAPMonitorApplet$SOAPMonitorPage.class SOAPMonitorApplet$SOAPMonitorTableModel.class SOAPMonitorApplet$SOAPMonitorTextArea.class

读者需要把上述�c�L��件复制到自己的Web应用�E�序目录下，本例中是/usr/local/apache/htdocs/目录�?

在浏览器地址样中输入SOAPMonitor的地址�Q�例�?http://test.com/SOAPMonitor �Q�浏览器会提�C�用��h��在下载Applet�E�序�Q�下载完毕后�Q�读者可以在��览器窗口中看到如图4-1所�C�的用户界面。如果上�q�类文�g的位�|�不正确�Q�浏览器会报�?找不到类"的错误。此时应��查是否已��上�q�类文�g复制到正��的目录下�?

�?2-1 SOAPMonitor的界�?/strong>

2.13.3 发布SOAPMonitor服务

�?-1所�C�的SOAPMonitor界面出现后，�q�不意味着��可以观察到Web服务的SOAP��h��与响应��了�Q�首先需要发布SOAPMonitorService。该Web服务是由Axis提供的，但需要由用户自己�q�行发布�Q�方法如下�?

获得SOAPMonitor服务的WSDD文�gdeploy.wsdd�Q�内容如�?也可�?http://www.sosnoski.com/presents/java-xml/axis/axis-monitor.html 复制该文�?�Q?

发布SOAPMonitor服务�Q?/p>

java org.apache.axis.client.AdminClient -lhttp://localhost:80/services/AdminService deploy.wsdd

2.13.4 修改deploy.wsdd

发布SOAPMonitor服务后，�q�要对被监测的Web服务�q�行配置。方法是先注销该Web服务�Q�然后修改该服务对应的WSDD文�g�Q�在其中增加��h��和响应��的配置�Q�否则是观测不到SOAP��h��和响应流的�?

注销Web服务的方法如下�?

�q�入该Web服务的undeploy.wsdd文�g所在的目录�Q�执�?

Java org.apache.axis.client.AdminClient -lhttp://localhost:80/services/AdminService undeploy.wsdd

修改WSDD文�g的方法如下�?

以Axis提供的MyService��Z��Q�对MyService的WSDD文�g做如下修攏V�?

修改�?

... ...

修改�? (有下划线的行是新加入的内�?

... ...

修改WSDD文�g后，重新发布MyService服务�Q?/p>

java org.apache.axis.client.AdminClient -lhttp://localhost:80/services/AdminService deploy.wsdd

2.13.5 启动SOAPMonitor��应用程�?/p>
�?.13.2节介�l�的�Ҏ��启动SOAPMonitor��应用程序�?/p>
使用客户端程序测试MyService服务�Q?

# java samples.userguide.example3.Client -lhttp://vnet.sohu.com/services/MyService "test" �l�果为：You typed : test

注意�Q�一定要先启动SOAPMonitor��应用程序，后调用Web服务才能观察到SOAP��h��和响应流�?/p>
2.13.6 观察SOAP��h��和响应流

�q�时在SoapMonitorApplet的窗口中可以观察到SOAP和请求和响应消息�Q�如�?-2所�C��?

�?-2 MyService的Soap��h��和响应流

2.14 使用客户端程序测试Web服务时报�?Exception:: (404)Not Found"

2.14.1 问题描述

WEB服务接口�~�写完成�q�发布后�Q�客��L��试�E�序收不到WEB服务的返回结果，Apache或Resin的log中也看不到访问记录。但��试�E�序�q�回�l�果�?(成功)�Q�在没有部��v该WEB服务的情况下�Q�也是这个结果，因此怀疑调用的是WSDL文�g的提供者自己测试用的WEB服务接口�Q�可能与另一�Ҏ��供的WSDL文�g有关�?

2.14.2 原因分析

合作伙伴调用WEB服务��p��够成功，从WEB服务��L��自己的客��L��调用��接收不到数据，估计与合作伙伴提供的WSDL文�g有关�Q�该WSDL文�g影响了WSDL2Java生成的客��L��stub代码。检查stub代码�Q�发现其soapAction都指向了合作伙伴的测试地址�?

2.14.3 解决�Ҏ��

修改stub代码中的soapAction�Q�改为sp(Service Provider)自己的WEB服务URL。重新编译程序�ƈ发布Web服务�Q�问题解冟�?

_call.setSOAPActionURI("sp自己的Web服务地址");

2.14.4 ��结

本小节描�q�的问题出现于Web服务提供�Ҏ��合作伙伴�l�一提供的WSDL文�g生成客户端代码的情况。遇到这�c�问题，读者可直接��查WSDL2Java自动生成的代码的有关部分�?

在WSDL文�g中可以看��C��下列内容�怼�的设�|��?/p>

其中 http://test.com/services/SPInterfaceSoap即�ؓ已发布的WEB服务的URL�Q�供客户端调用�?

2.15 如何列出已发布的Web服务

使用下面的命令：

java org.apache.axis.client.AdminClient -lhttp://localhost:80/services/ list

实际上该命��o的输出就是server-config.wsdd文�g的内宏V�?

2.16 发布Web服务时报�?调用目标异常"

2.16.1 问题描述

在部�|�WEB服务时报告：java.lang.reflect.InvocationTargetException异常�?

2.16.2 原因分析

在WSDL文�g中自定义的名字空间与Axis的services名字�I�间冲突�?

2.16.3 解决�Ҏ��

修改WSDL文�g�Q�将services改�ؓ别的名字�?

2.17 WSDL文�g中的targetNamespace的作用是什�?/font>

TargetNamespace指明目标名字�I�间�Q�用于验证xml文档�?

在WSDL文�g中，中的targetNamespace�?lt;types>中的targetNamespace应保持一致�?

2.18 Web服务部��v成功但检��不�?/font>

2.19 客户端程序找不到可用的Web服务

2.19.1 问题描述

执行 java org.apache.axis.client.AdminClient -lhttp://localhost:80/services/AdminService deploy.wsdd

时显�C?lt;Admin>Done processing�Q�却��查不到新的服务，在WEB-INF/目录下的server-config.wsdd文�g中也看不到相应的配置��V�?

2.19.2 原因分析

新的WEB服务的类文�g没有重新�~�译�q�复制到正确的位�|��?

2.19.3 解决�Ҏ��

WEB服务的类文�g可以打包为jar文�g。在CLASSPATH环境变量中正��设�|�jar文�g的�\径。例如：

jar cvf SPInterfaceSoap.jar com/zx/service/v1_0/*.class

��SPInterfaceSoap.jar复制到WEB-INF/lib/目录下，重新发布WEB服务�?

2.20 如何排除原因不明的错�?/font>

有时�Q�在对WEB服务执行客户端测试时会出现慕名其妙的错误。�ؓ保证环境是正��的�Q�可以按下面的步骤排除原因不明的错误�?

1. Undeploy被测试的服务

java org.apache.axis.client.AdminClient -lhttp://localhost:80/services/AdminService undeploy.wsdd

2. 重新启动resin: /usr/local/resin/bin/httpd.sh restart(如果是其它的应用服务器，��h��相应的方法重新启�?

3. 重新发布WEB服务

4. �q�行��试

回页�?/font>

3 ��结

目前有很多可以��用的应用服务器和Web服务�q�_��软�g�Q�本文仅以Apache Axis和Resin��Z��介绍了在部��vWeb服务的过�E�中可能遇到的问题及其解��x��法，其中�q�未讨论Web服务的安全性问题。对于如何高效地开发和部��vWeb服务以及如何��保Web服务的安全性，�q�希望对此感兴趣的读者共同参与讨论，对于文中存在的错误和不��之处也希望读者朋友们能够不吝批评指正�?

参考资�?

http://xml.apache.org/xerces2-j/index.html

http://xml.apache.org/xalan-j/index.html

http://ws.apache.org/axis/

http://www.w3.org/TR/SOAP/

http://www.w3c.org/TR/wsdl.html

http://www.caucho.com/

关于作�?/span>

姓名�Q�刘�U�涛
电子邮�g:　 redwaveht@hotmail.com
办公电话�Q?86(010)87717788�?645
�U�d��电话�Q?3910662615
专长�Q�电子邮件系�l�，计费�pȝ��Q�Radius协议,Web服务�?
兴趣�Q�J2EE
研究方向�Q�Web服务和数据挖�?

狼爱上狸 2007-06-21 16:02 发表评论

狼爱上狸 — Thu, 21 Jun 2007 07:58:00 GMT

一、Axis��?/p>

1. 什么是SOAP

SOAP是一个基于XML的用于应用程序之间通信数据�~�码的传输协议。最初由微��Y和Userland Software提出�Q�随着不断地完善和改进�Q�SOAP很快被业界广泛应用，目前完全发布版本�?.1。在其发展过�E�中�Q�W3C XML标准工作��组�U�极促成SOAP成�ؓ一个真正的开放标准。在写作此文档之�Ӟ��SOAP1.2草案已经发布�Q?.2�?.1中相�Ҏ؜��q��部分做了改进�?br>SOAP被广泛作为新一代跨�q�_��、跨语言分布计算Web Services的重要部分�?/p>

2. 什么是Axis

Axis是Apache�l�织推出的SOAP引擎�Q�Axis��目是Apache�l�织著名的SOAP��目的后�l�项目，目前最新版本是采用Java开发的1.1版本�Q�C++的版本正在开发之中。Axis v1.1软�g包可以从http://ws.apache.org/axis/dist/1_1/下蝲得到�?br>但是Axis不仅仅是一个SOAP引擎�Q�它�q�包括：
    一个独立运行的SOAP服务�?br>    一个servlet引擎的插�Ӟ��q�个servlet引擎可以是Tomcat
    对WSDL的扩展支�?br>    一个将WSDL的描�q�生成JAVA�cȝ��工具
    一些示例代�?br>    �q�有一个监控TCP/IP包的工具

二、Axis的安�?/p>
应用Axis开发Web Services�Q�你需要安装如下��Y�Ӟ��
1.JDK1.4.2
2.一个支持Servlet的服务器引擎�Q�比如广��Z�h知的Tomcat�?/p>
当安装好Tomcat之后�Q�只需��下载的Axis软�g包解压羃�Q�将其中�?#8220;webapps”目录下的“axis”目录整个拯��到Tomcat安装目录下的“webapps”目录下即可�?/p>
三、Axis的配�|?/p>
Axis��Z��Java开发，可以部��v于多�U�操作系�l�，使用前需要配�|�一�p�d��的系�l�变量，在此假定你已�l�在本机上装好了Tomcat 4.0以上的版本，需要配�|�的�pȝ��变量如下表所�C�：

CATALINA_HOME
C:\Tomcat_4_1

�Q�此处应为Tomcat的安装位�|�，注意路径名中不要有空��|��

AXIS_HOME
%CATALINA_HOME%\webapps\axis

AXIS_LIB
%AXIS_HOME%\lib

AXISCLASSPATH
%AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-discovery.jar; %AXIS_LIB%\commons-logging.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

CLASSPATH 中加入：
%AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-discovery.jar; %AXIS_LIB%\commons-logging.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的测�?/p>
安装配置完毕后，应测试一下是否Axis可以正确�q�行了�?/p>
　　启动Tomcat服务器，在浏览器中访�?a href="http://localhost:8080/axis/happyaxis.jsp">http://localhost:8080/axis/happyaxis.jsp�Q�如果页面显�C�有错误�Q�则需要回头检查一下相关配�|�是否正��，如果��览��面能正��显�C�出�pȝ��l��g、属性等参数配置信息�Q�则表示安装成功。现在可以开始开发你的Web Services应用了�?/p>
五、服务的发布
Axis提供了两�U�服务发布方式，一�U�是��x��发布�Q�Instant Deployment�Q�，一�U�是定制发布�Q�Custom Deployment�Q��?/p>
1. 使用��x��发布 Java Web Service(JWS)

　　对即时发布的支持是Axis的特色之一�Q��用即时发布��用户只需有提供服务的Java�cȝ��源代码，卛_��其�q�速发布成Web服务。每当用戯��用这�c�L��务的时候，Axis会自动进行编译，即��服务器重启了也不必对其做��M��处理�Q��用非常简单快捗��?/p>
　　使用��x��发布首先需要一个实现服务功能的Java源文�Ӟ��其扩展名改�?jws�Q�Java Web Service的羃写）�Q�然后将该文件放�?#8220;……\webapps\axis”目录下即可�?br>    在此�l�出一个从英里到公里的长度单位转换的服务，其源码如下：

文�gDistance.jws

public class Distance
{
    public double convertMile2Kilometre( double mile )
    {
return mile * 1.609;  //实现英里到公里的距离转换
    }
}

��其攑ֈ�“……\webapps\axis”目录�Q�通过讉K��http://localhost:8080/axis/Distance.jws?wsdl可以看到�q�个服务的WSDL描述文�g�Q�这说明Distance服务被成功发布了。描�q�的WDSL代码如下�Q?br>
-    xmlns:apachesoap="http://xml.apache.org/xml-soap" xmlns:impl="http://192.168.0.26:8080/axis/Distance.jws" xmlns:intf="http://192.168.0.26:8080/axis/Distance.jws" 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">
-

-

-
-

-

-

-
http://DefaultNamespace" use="encoded" />

-

-
-

需要注意的是：JWS的web服务发布是一个很��单的Web服务发布方式�Q�在��面中你不能使用包，而且�׃��代码是在�q�行期被�~�译的，所以在部��v之后�Q�你也很难找到错误所在�?/p>
2. 使用定制发布 Web Service Deployment Descriptor(WSDD)

　　��x��发布是一��o人激动的技术，它��Web服务的开发变得如此简单；然而即时发布�ƈ不��L��最好的选择�Q�比如有些应用系�l�是�W�三�Ҏ��供的�Q�我们没有购买源代码�Q�只�?class文�g�Q�但我们又希望将�q�个应用�pȝ��的一些功能对外发布成Web服务�Q��其能够在更大范围内��生作用，�q�个时候即时发布技术就无能为力了。此外，��x��发布技术�ƈ不灵�z�，无法�q�行更多的服务配�|�，�q��得它�q�不能满��一些特定系�l�的需求�?/p>
　　因此�Q�Axis提供了另一�U�服务发布方式，�q�就是定制发布�?/p>
　　在此�l�出一个从加仑到升的容�U�单位�{换的服务�Q�其源码如下�Q?/p>
　　文�gCapacity.java
    package samples.capacity;
    public class Capacity
    {
        public double convertGallon2Litre( double gallon )
{
     return gallon * 4.546;//实现加仑到升的容�U��{�?br> }//convertGallon2Litre()

    }/* Capacity */

    ��其�~�译�?class文�g�Q�放�|�到“……\webapps\axis\samples\capacity”目录下，卛_��着手进行发布�?br>    定制发布不需要构�?jws文�g�Q�但必须创徏服务发布描述文�gdeploy.wsdd�Q�Web Service Deployment Descriptor的羃写）�Q�这个文件负责描�q�服务的名称、入口等信息�Q�其内容如下�Q?br>    文�gdeploy.wsdd





    在这里服务的提供者是“java:RPC”�Q�它被内建在Axis中，而且指明了一个JAVA RPC服务�Q�做�q�个处理的类是org.apache.axis.providers.java.RPCProvider�?br>    我们是通过一�?lt;parameter>标签告诉RPC服务应该调用的类�Q�而另外一�?lt;parameter>标签则告诉引擎，它可以调用这个类中的��M��的Public�Ҏ��。你也可以指定通过使用名字�I�间或者一些可以调用的�Ҏ��列表�Q�来指明那些�Ҏ��可以被调用�?/p>
　　��该文�g也放�?#8220;……\webapps\axis\samples\capacity”目录下，然后可以采用Axis提供的一个客��L��理工具——AdminClient来完成服务的定制发布�?br>   �?#8220;……\webapps\axis\samples\capacity”目录下，�q�行�Q?/p>
   java -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient deploy.wsdd

   如果�q�行时说没有扑ֈ��c�，那么可能是类路径没有配置好，��所有的与axis相关的jar都写到classpath中去。这样只要运�?

   java org.apache.axis.client.AdminClient deploy.wsdd
   可以看到以下�q�行�l�果�Q?/p>
Processing file deploy.wsdd
Doneprocessing

　　�q�表明Capacity服务定制发布完成�?br>
   你也可以调用�Q?br> java org.apache.axis.client.AdminClient undeploy.wsdd 来取消部�|�Ӏ?/p>
   你也可以调用�Q?br> java org.apache.axis.client.AdminClient list 来获得所有的已经部��v的服务的列表。在�q�里你会看到services, handlers, transports�{�等�Q�注意这个调用只是列��Z��WEB-INF\server-config.wsdd的文件内宏V�?/p>
   一定要注意�Q�编译后的class文�g要拷贝到web-inf/classes的目录中�Q�如果该文�g中有包存在的话，别忘了还要在classes目录下创建包的目�?br>   通过讉K��http://localhost:8080/axis/services/Capacity?wsdl可以看到�q�个服务的WSDL描述文�g�Q�这说明Capacity服务被成功发布了�?br>   你也可以通过讉K��http://localhost:8080/axis/servlet/AxisServlet查看所有定制发布的服务�?br>   WDSL如下�Q?br>
- http://localhost:8080/axis/services/Capacity" xmlns="http://schemas.xmlsoap.org/wsdl/"
    xmlns:apachesoap="http://xml.apache.org/xml-soap" xmlns:impl="http://localhost:8080/axis/services/Capacity" xmlns:intf="http://localhost:8080/axis/services/Capacity" 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">
-

-

-
-

-

-

-

-
http://localhost:8080/axis/services/Capacity" use="encoded" />

-
-
http://localhost:8080/axis/services/Capacity" />

WSDD 的高�U�功能：
(1) AXIS支持三种对象范围�Q?br>     "request"范围�Q�这是默认的情况�Q�每一�ơSoap��h��的时候都��创建新的对象�?br>     "application"范围�Q�将会�ؓ所有的��h��生成一个单独的�׃�n的对象�?br>     "session"范围�Q��ؓ每一个session期的客户端请求创��Z��个对象�?br> 指定�Ҏ��如下�Q?br>

...

(2) 更多部��v内容�Q�Handlers and Chains
让我们来深入挖掘一下Axis引擎的更强大的特性。如果我们想跟踪我们的服务被调用了多��次�Q�那么我们只需要包含一个简单的handler�Q�它存放在samples/log目录下。要使用�q�个handler�Q�你��首先应该部�|�这个handler�Q�然后��用在部��v服务时给它指定的名字。下面是一个wsdd文�g的例子：
















�W�一�D�|��明了一个名为track的handler�Q�它是samples.userguide.example4.LogHandler�cȝ��实例。另外还指定了一个参数filename�Q�用于指定日志文件名�U��?br> 下面的那�D�|��明了一个RPC服务�Q�和我们在上面的例子中看到的一��P��所不同的是在service标签中的标签�Q�它指定了一些在调用服务前应该被调用的handler集。也��是�׃��我们在部�|�中插入了这�?track"的引用，所以我们确定每�ơ调用服务的时候都��被记录到日志文件中厅R�?br>
(3)�q�程��理�Q?br>

WARNING: enabling remote administration may give unauthorized parties access to your machine. If you do this, please make sure to add security to your configuration!
所以远�E�管理涉及到安全问题�Q�不��采用�?/p>

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=35550
                   http://blog.csdn.net/tenwang1977/archive/2004/07/06/35550.aspx

狼爱上狸 2007-06-21 15:58 发表评论

学习Axis和web service之一

狼爱上狸 — Thu, 21 Jun 2007 07:54:00 GMT

学习Axis和web service之一
web service�׃��工作中需要用刎ͼ�所以那天从�|�上GOOGLE一�?查看如何制作自己的第一个WEB SERVICE。首�?web service的原理我��׃��多讲�?再怎么讲也不如人家讲的�?况且都是从别人那里拷贝的。还是整点实际的吧。马上徏立自��q��WEB SERVICE的程序�?/p>
一.首先下蝲安装软�g�Q?br>1.axis-src-1_2_1,(自己��M��?地址忘记�?
2.jakarta-tomcat-5.0.18.exe(�q�个是安装版�?从别的地�Ҏ��贝也可以�?
最��也要有�q�两个包

�?安装
自己安装吧。挺��单的。TOMCAT安装最好改一下名字比如：TOMCAT

�?
1.��axis-src-1_2_1�q�个包解压后�Q�将axis-1_2_1\webapps下axis的所有东西拷贝到你刚刚徏立的TOMCAT的webapps下。目录结构如下：
tomcat-webapps-axis
然后查看一下你的axis的WEB-INF的lib�?.jar文�g是否全，应该�?�?br>axis.jar
axis-ant.jar
commons-discovery-0.2.jar
commons-logging-1.0.4.jar
jaxrpc.jar
log4j-1.2.8.jar
saaj.jar
wsdl4j-1.5.1.jar
(一定看好各个文件的文�g名，一会将配置CLASSPATH)

2.然后到axis-1_2_1目录�?扑ֈ�lib文�g�?拯��其中的activation.jar文�g,�?br>Tomcat\webapps\axis\WEB-INF\lib,和上面的8个jar文�g在一��P��OK了�?br>
�?配置classpath
我的电脑-右键属�?高��-环境变量
1.建立变量:AXIS_HOME=D:\Tomcat\webapps\axis(你自��q��实际TOMCAT目录)
2.建立变量:AXIS_LIB=%AXIS_HOME%\WEB-INF\lib
建立�q�两个环境变�?br>3.classpath(�怿��q�个变量里面肯定有�?TOMCAT安装的时候配�|�过)

.;%JAVA_HOME%\lib\dt.jar;
%JAVA_HOME%\lib\tools.jar;
%TOMCAT_HOME%\lib;(以上三个都是安装TOMCAT配置�?下面是axis�?
%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;
%AXIS_LIB%\activation.jar;
%AXIS_LIB%\mail.jar
拯��到classpath里面��可以了�Q�然后点�ȝ��定�?/p>
�?��试
�q�步很重�?我自��p��?因�ؓ如果你不知道CLASSPATH是否配置齐全,所以应该测试一�?有些文章没有��试直接��往下走�?但是��出现问题了,我就出现了问�?是jar包没有导入造成�?错误信息如这��P��
Exception in thread "main" java.lang.NoClassDefFoundError:

javax/wsdl/OperationType
at org.apache.axis.description.OperationDesc.(OperationDesc.java
:58)
        at org.apache.axis.client.Call.addParameter(Call.java:948)
        at org.apache.axis.client.Call.addParameter(Call.java:983)
        at BankClient.main(BankClient.java:29)
�q�就是没有导入造成的错误�?br>其实你先看一下classpath��p��避免错误�?br>点击开�?�q�行-cmd-打开命��o行窗�?敲入set classpath,好了你配�|�的classpath完全昄��了，你可以仔�l�的查看了�?/p>
六调试AXIS
启动TOMCAT,输入�|�址 http://localhost:8080/axis, 出现 "Hello! Welcome to Apache-Axis." �Ƣ迎�? 点击链接 Validate 来验�?Axis 所需�?.jar 包是否齐�?(Needed Components).

�?开发一�?Web Service 服务端程�?br>(代码是�{�?谢谢!)
我的�q�个例子是��?Web Service �q�回一个请求字�D늚��?

import java.util.*;

public class wsTestService
{
  String strName = "Ryun";
  int intAge = 21;
  List items = new ArrayList();

  public String getName() {
  return strName;
}

  public int getAge() {
  return intAge;
}

  public List getItems() {
  return items;
}
}��此文�g命名�?wsTestService.jws 存放�?br>d:\tomcat\webapp\axis\�?br>讉K�� http://localhost:8080/axis/wsTestService.jws, 出现 "There is a Web

Service here"卌��?Web Service 服务端程序安装完�?
开发一�?Web Service 客户端程�?br>建立客户端程序wsTestClient.java
以下是客��L��的源�E�序, 用于�?Web Service Server 提交服务��h��:

import org.apache.axis.client.Call;
import org.apache.axis.client.Service;

public class wsTestClient {
  public static void main(String args[]) {
  System.out.println("Start invoking...");
  try {
      String strUri =

"http://localhost:8080/axis/wsTestService.jws";
      Service service = new Service();
      Call call = (Call)
      service.createCall();
      call.setTargetEndpointAddress(new

java.net.URL(strUri));
      call.setOperationName("getName");
      String ret = "" + call.invoke(new Object[] {});
      System.out.println("I am " + ret + ".");
     }
  catch (Exception e) {
      System.err.println(e.toString());
     }
  System.out.println("Finished the invoking.");
  }
}
然后�~�译�q�行�Q�如果出现问题，那可能是环境变量path,classpath配置的问�?自己查看

一下，�q�里��׃��再描�q�C��?br>C:\>cd \
C:\>javac wsTestClient.java

C:\>java wsTestClient
Start invoking...
I am Ryun.
Finished the invoking.
完成�Q�再��d��习，�E�后�ȝ��

来自:
http://www.cnweblog.com/battleseagull/articles/20130.html

狼爱上狸 2007-06-21 15:54 发表评论

No.	文�g	用�?/td>
1.	deploy.wsdd	MyService服务的部�\|�描�q�文�?/td>
2.	MyService.java	MyService服务的接口文�?/td>
3.	MyServiceService.java	获得MyService服务的接口文�?/td>
4.	MyServiceServiceLocator.java	实现MyServiceService接口
5.	MyServiceSoapBindingImpl.java	实现MyService接口�Q�应向其中补充业务逻辑
6.	MyServiceSoapBindingSkeleton.java	MyService服务的服务端框架代码,实现MyService, org.apache.axis.wsdl.Skeleton接口
7.	MyServiceSoapBindingStub.java	MyService服务的客��L��存根代码,实现MyService接口
8.	undeploy.wsdd	注销MyService服务的部�\|�描�q�文�?/td>


		姓名�Q�刘�U�涛电子邮�g:　 redwaveht@hotmail.com 办公电话�Q?86(010)87717788�?645 �U�d��电话�Q?3910662615 专长�Q�电子邮件系�l�，计费�pȝ��Q�Radius协议,Web服务�? 兴趣�Q�J2EE 研究方向�Q�Web服务和数据挖�?