AXIS第五课：AXIS高级施用，在AXIS服务间传递javabean及安全解决方案
http://hanyexiaoxiao.iteye.com/blog/479194
这是AXIS学习笔记的最后一篇。在前面我们讨论了最简单的HelloWorld服务，客户端并没有向服务器端
传递参数，现在我们来传传JavaBean。当然，也可以传递你自己定义的JAVA类，但那样你必须自己创建
专门的XML序列化器和反序列化器；而对JavaBean，AXIS提供了现成的序列化器。（有人说：懒惰是程序员最大的美德，我喜欢，所以我就传传JavaBean）
一、服务器端
1、CLASS类两个Order.class,OrderTest.class，位于%TOMCAT_HOME%\webapps\axis\WEB-INF\classes下
这两个类都直接给出源码，不再说明
Order.java
public
class Order {
private String id;
private String name;
public void setId(String id){
this.id=id;
}
public String
getId(){
return id;
}
public void setName(String
name){
this.name=name;
}
public String
getName(){
return name;
}
}
OrderTest.java
public class OrderTest {
public Order returnOrder(Order order){
Order newOrder=new Order();
if(order.getId().equals("1"))
newOrder.setName("annlee");
else
newOrder.setName("leeann");
return newOrder;
}
}
2、修改服务器端配置文件server-config.wsdd
在server-config.wsdd中相应位置添加以下代码
<service
name="Order" provider="java:RPC">
<parameter name="allowedMethods"
value="returnOrder"/>
<parameter name="className"
value="OrderTest"/>
<beanMapping languageSpecificType="java:Order"
qname="ns1:Order"
xmlns:ns1="urn:BeanService"/>
</service>
可以看到和前面的发布服务代码相比仅多了一行代码
<beanMapping
languageSpecificType="java:Order" qname="ns1:Order"
xmlns:ns1="urn:BeanService"/>
languageSpecificType属性指定JavaBean类文件位置,例如：
languageSpecificType="java:com.annlee.axis.Order"
qname属性指定JavaBean类的名字
其他是固定的。
二、客户端
客户端类文件一个OrderClient.class，代码如下（变化的部分加注释）：
public
class OrderClient
{
public static void main(String args[])
throws Exception
{
String endpoint = "http://localhost:8080/axis/services/Order"; //服务所在位置
Order order=new Order();
//JavaBean
order.setId("1");
Service service = new
Service();
Call call = (Call)service.createCall();
//注册JavaBean，注意和server-config.wsdd中的配置代码比较
QName qn = new
QName("urn:BeanService", "Order");
call.registerTypeMapping(Order.class,
qn, new BeanSerializerFactory(Order.class,
qn),
new
BeanDeserializerFactory(Order.class, qn));
String name="no!";
try
{
call.setTargetEndpointAddress(new
URL(endpoint));
//调用的服务器端方法
call.setOperationName(new
QName("Order", "returnOrder"));
//设定传入的参数，这里qn即Order.class
call.addParameter("arg1", qn, ParameterMode.IN);
//设定返回的参数是Order.class
call.setReturnType(qn, Order.class);
Order result = (Order)call.invoke(new Object[] {
order
});
if(result != null)
name = result.getName();
}
catch(Exception e)
{
System.err.println(e);
}
System.out.println(name);
}
}
OK！运行一下，就可以看到返回了"annlee"。
和上一篇文章一样，我们不容许在网络中传递XML是明文，于是需要加密和验证。这里我们继续采用上次所讲的框架。（已打包成ws-axis.jar)
一、修改服务器端配置文件server-config.wsdd（和上一文章一模一样！不再罗嗦）
在server-config.wsdd中相应位置添加以下代码
<requestFlow>
<handler type="soapmonitor"/>
<handler type="java:com.annlee.WSAxis.WSServerRequestHandler">
<parameter name="keyStoreFile" value="f:\server.keystore"/>
<parameter name="trustStoreFile" value="f:\server.truststore"/>
<parameter name="keyStorePassword" value="changeit"/>
<parameter name="keyAlias" value="Server"/>
<parameter
name="keyEntryPassword" value="changeit"/>
<parameter
name="trustStorePassword" value="changeit"/>
<parameter
name="certAlias" value="clientkey"/>
</handler>
</requestFlow>
<responseFlow>
<handler
type="soapmonitor"/>
<handler
type="java:com.annlee.WSAxis.WSServerResponseHandler">
<parameter name="keyStoreFile" value="f:\server.keystore"/>
<parameter name="trustStoreFile" value="f:\server.truststore"/>
<parameter name="keyStorePassword" value="changeit"/>
<parameter name="keyAlias" value="Server"/>
<parameter
name="keyEntryPassword" value="changeit"/>
<parameter
name="trustStorePassword" value="changeit"/>
<parameter
name="certAlias" value="clientkey"/>
</handler>
</responseFlow>
二、客户端（区别就在这里，注意！！）
客户端的编码我经过了三个阶段
第一阶段：
在这个阶段我想当然的在OrderClient.class中加入了如下代码：
WSClientHandler handler=new WSClientRequestHandler();//注意新加的HANDLER
handler.setInitialization("f:/client.keystore","changeit","Client","changeit",
"f:/client.truststore","changeit","serverkey");//初始化
WSClientHandler
handlee=new WSClientResponseHandler();//注意新加的HANDLER
handlee.setInitialization("f:/client.keystore","changeit","Client","changeit",
"f:/client.truststore","changeit","serverkey");//初始化
call.setClientHandlers(handler,handlee);//添加Handler
这个方法也是我在上一文章里介绍的，结果抛出以下异常：
faultString:
org.xml.sax.SAXException: Deserializing
parameter
'newProfileReturn': could not find deserializer
for type
{urn:BeanService
Order}SerializableProfile
也就是说不能正常解析XML文件，于是理所当然的郁闷了，觉得代码中肯定漏设了CALL的一个属性，于是查看AXIS的源代码，没有结果！转机出现在下面一行代码，在不断的抛出异常中我修改了代码
将call.setClientHandlers(handler,handlee);改为
call.setClientHandlers(null,null);
结果程序还是抛出同样的异常，于是意识到这可能是AXIS的一个BUG，为证明这一点，我将下面的Handler初始化代码删除
WSClientHandler handler=new WSClientRequestHandler();//注意新加的HANDLER
handler.setInitialization("f:/client.keystore","changeit","Client","changeit",
"f:/client.truststore","changeit","serverkey");//初始化
WSClientHandler
handlee=new WSClientResponseHandler();//注意新加的HANDLER
handlee.setInitialization("f:/client.keystore","changeit","Client","changeit",
"f:/client.truststore","changeit","serverkey");//初始化
结果还是抛出同样的异常，果然是BUG！得到这个结论后去了apache
AXIS主页，在问题列表中见到了完全一样问题的提交，但没有解答（晕！）
最后得到了结论：call的setClientHandlers()方法只有当call处理简单的数据类型，如String,int等等才能正常使用！
（当然，如果你对这个问题有不同的见解，欢迎和我联系。或许我错了，但程序不运行是真的：））
第二阶段：
开始在google上找问题的解决方法，这也是我的习惯：）。找了一个类似问题的讨论，地址如下：
http://marc.theaimsgroup.com/?l=axis-user&m=111259980822735&w=2
他们的解决方法是Handler继承于javax.xml.rpc.handler.Handler，然后在程序里动态注册而在我的ws-axis.jar里Handler继承于org.apache.axis.handlers.BasicHandler。当然，
javax.xml.rpc.handler.Handler是org.apache.axis.handlers.BasicHandler的老爸，但在程序里老爸和儿子之间却不能很好的兼容，这也许就是所谓的代沟？？无奈中重新写了Handler,但在运行中却抛出异常，提示message在被invoke的时候已被更改。我靠，Handler的作用就是来更改message的啊！这是什么世道！
我知道很多程序采用的就是这种方法，但我好象怎么修改都抛出上述异常。
第三阶段
既然在程序里动态注册Handler行不通，于是决定写个单独的配置文件来注册Handler。如果这种方法不幸失败就返回第二阶段。好马为什么不吃回头草？？
1、ws-axis.jar中修改WSClientHandler.class,修改后如下，我想你一看就明白为何修改
public class WSClientHandler extends
BasicHandler{
protected String keyStoreFile ;
protected String
keyStoreType ="JKS";
protected String keyStorePassword ;
protected String
keyAlias ;
protected String keyEntryPassword ;
protected String
trustStoreFile ;
protected String trustStoreType = "JKS";
protected String
trustStorePassword ;
protected String certAlias ;
public void init() {
keyStoreFile =
(String)getOption("keyStoreFile");
if(( keyStoreFile== null) )
System.err.println("Please keyStoreFile configured for the
Handler!");
trustStoreFile = (String)getOption("trustStoreFile");
if((
trustStoreFile== null) )
System.err.println("Please trustStoreFile configured
for the Handler!");
keyStorePassword =
(String)getOption("keyStorePassword");
if(( keyStorePassword== null)
)
System.err.println("Please keyStorePassword configured for the
Handler!");
keyAlias = (String)getOption("keyAlias");
if(( keyAlias==
null) )
System.err.println("Please keyAlias configured for the
Handler!");
keyEntryPassword = (String)getOption("keyEntryPassword");
if((
keyEntryPassword== null) )
System.err.println("Please keyEntryPassword
configured for the Handler!");
trustStorePassword =
(String)getOption("trustStorePassword");
if(( trustStorePassword== null)
)
System.err.println("Please trustStorePassword configured for the
Handler!");
certAlias = (String)getOption("certAlias");
if
((certAlias==null))
System.err.println("Please certAlias configured for
the Handler!");
if ((getOption("keyStoreType")) != null)
keyStoreType
= (String)getOption("keyStoreType");
if ((getOption("trustStoreType")) !=
null)
trustStoreType =
(String)getOption("trustStoreType");
}
public void invoke(MessageContext
messageContext) throws AxisFault {
//do nothing now!
}
public void
onFault(MessageContext msgContext) {
System.out.println("处理错误，这里忽略！");
}
}
2、写客户端的配置代码client-config.wsdd,如下：
<?xml version="1.0"
encoding="UTF-8"?>
<deployment name="defaultClientConfig"
xmlns="http://xml.apache.org/axis/wsdd/"
xmlns:java=""
target="_blank">http://xml.apache.org/axis/wsdd/providers/java">
<transport
name="http"
pivot="java:org.apache.axis.transport.http.HTTPSender"/>
<transport
name="local"
pivot="java:org.apache.axis.transport.local.LocalSender"/>
<transport
name="java"
pivot="java:org.apache.axis.transport.java.JavaSender"/>
<globalConfiguration>
<requestFlow>
<handler
type="java:com.annlee.WSAxis.WSClientRequestHandler">
<parameter
name="keyStoreFile"
value="D:\Tomcat5.5\webapps\axis\WEB-INF\client.keystore"/>
<parameter
name="keyEntryPassword" value="changeit"/>
<parameter name="certAlias"
value="serverkey"/>
<parameter name="trustStorePassword"
value="changeit"/>
<parameter name="trustStoreFile"
value="D:\Tomcat5.5\webapps\axis\WEB-INF\client.truststore"/>
<parameter
name="keyAlias" value="Client"/>
<parameter name="keyStorePassword"
value="changeit"/>
</handler>
</requestFlow>
<responseFlow>
<handler
type="java:com.annlee.WSAxis.WSClientResponseHandler">
<parameter
name="keyStoreFile"
value="D:\Tomcat5.5\webapps\axis\WEB-INF\client.keystore"/>
<parameter
name="keyEntryPassword" value="changeit"/>
<parameter name="certAlias"
value="serverkey"/>
<parameter name="trustStorePassword"
value="changeit"/>
<parameter name="trustStoreFile"
value="D:\Tomcat5.5\webapps\axis\WEB-INF\client.truststore"/>
<parameter
name="keyAlias" value="Client"/>
<parameter name="keyStorePassword"
value="changeit"/>
</handler>
</responseFlow>
</globalConfiguration>
</deployment>
同样不再解释，不明白可以参考我的上一篇文章
3、修改OrderClient.class
在OrderClient.class中加入了如下代码：
EngineConfiguration
conf =
new
FileProvider("F:\\Tomcat\\webapps\\axis\\WEB-INF\\client-config.wsdd");//位置
Service
service = new Service(conf);
当然记得导入
import
org.apache.axis.EngineConfiguration;
import
org.apache.axis.configuration.FileProvider;
运行一下，返回"annlee"，靠，搞定！
注意：这次我把OrderClient.class的调用放到了一个JSP文件中而不是jbuilder中，因为有client-config.wsdd，所以你必须有完整的WEB程序发布到TOMCAT中，否则会报找不到相应文件。