Spring HTTP invoker 是 spring 框架中的一个远程调用模型,执行基于 HTTP 的远程调用(意味着可以通过防火墙),并使用 java 的序列化机制在网络间传递对象。客户端可以很轻松的像调用本地对象一样调用远程服务器上的对象,这有点类似于 webservice ,但又不同于 webservice ,区别如下:
webservice |
HTTP invoker |
跨平台,跨语言 |
只支持 java 语言 |
支持 SOAP ,提供 wsdl |
不支持 |
结构庞大,依赖特定的 webservice 实现,如 xfire 等 |
结构简单,只依赖于 spring 框架本身 |
项目中使用哪种远程调用机制取决于项目本身的要求。
² HTTP invoker 服务模式
说明:
1. 服务器端:通过 HTTP invoker 服务将服务接口的某个实现类提供为远程服务
2. 客户端:通过 HTTP invoker 代理向服务器端发送请求,远程调用服务接口的方法
3. 服务器端与客户端通信的数据需要序列化
1. 添加 springJAR 文件
建议使用 spring2+.jar 版本
2. 创建服务接口
3. 创建服务接口的具体实现类
4. 公开服务
1. 添加 springJAR 文件
建议使用 spring2+.jar 版本
2. 创建服务接口
3. 访问服务
1. 服务接口: UcService.java
它提供两项服务,查询用户信息和记录日志,如下:
public interface UcService {
public UserInfo getUserInfobyName(String userName);
public int recordLog(String username, String point, String operate, String desc);
}
说明:举这个列子是因为其比较有代表性,它将展示普通数据类型( int,long 等)和复杂数据类型( DTO 等)的远程调用方式。 UserInfo 是一个普通的 DTO ,代码如下:
public class UserInfo implements Serializable {
private static final long serialVersionUID = -6970967506712260305L;
/** 用户名 */
private String userName ;
/** 电子邮箱 */
private String email ;
/** 注册日期 */
private Date registDate ;
public String getUserName() {
return userName ;
}
public void setUserName(String userName) {
this . userName = userName;
}
public String getEmail() {
return email ;
}
public void setEmail(String email) {
this . email = email;
}
public Date getRegistDate() {
return registDate ;
}
public void setRegistDate(Date registDate) {
this . registDate = registDate;
}
}
注意:因为是在网络间传输对象,所以需要将 UserInfo 实现 Serializable 接口,并指定一个 serialVersionUID (任意值即可,同时客户端也要有这个类,否则在客户端接收对象时会因为 serialVersionUID 不匹配而出现异常)
回到UcService.java ,它提供了两个服务(在这里一个方法代表一个服务功能),我们需要具体的实现类来实现真正的服务
2. 实现类是 UCServiceImpl.java
public class UCServiceImpl implements UcService {
private static Logger pointrecordlog = Logger.getLogger ( "pointrecordlog" );
private static Logger logger = Logger.getLogger (UCServiceImpl. class );
private UcFacade ucFacade ;
public void setUcFacade(UcFacade ucFacade) {
this . ucFacade = ucFacade;
}
public UserInfo getUserInfobyName(String userName) {
UserInfo user = null ;
try {
user = ucFacade .getUserInfoDetail(userName);
logger .debug( "get userinfo success by username:" + userName);
} catch (Throwable t) {
logger .error( "get userinfo fail by username:" + userName, t);
}
return user;
}
public int recordLog(String username, String point, String operate, String desc) {
int result = 0;
try {
pointrecordlog .info(username + " - " + point + " - " + operate + " - " + desc);
} catch (Throwable t) {
result = -1;
logger .error(t);
}
return result;
}
}
说明: ucFacade 是通过 spring 注入的一个数据查询类,因为它与 http invoker 没有直接关系,所以不进行介绍。
3. 公开服务 UcService.java
² WEB-INF/application-context.xml :将接口声明为 HTTP invoker 服务
< bean id = "httpService"
class = "org.springframework.remoting.httpinvoker.HttpInvokerServiceExporter" >
< property name = "service" >
< ref bean = "ucService" />
</ property >
< property name = "serviceInterface"
value = "com.netqin.baike.service.UcService" >
</ property >
</ bean >
< bean id = "ucService" class = "com.netqin.baike.service.impl.UCServiceImpl" />
说明: HttpInvokerServiceExporter 实际上是一个 spring mvc 控制器,它处理客户端的请求并调用服务实现。
² WEB-INF/service-servlet.xml : HttpInvokerServiceExporter 实际上是一个 spring mvc 控制器,所以需要为其 提供 spring URL 处理器,这里我们使用 SimpleUrlHandlerMapping
< bean
class = "org.springframework.web.servlet.handler.SimpleUrlHandlerMapping" >
< property name = "mappings" >
< props >
< prop key = "/httpService" > httpService </ prop >
</ props >
</ property >
</ bean >
² WEB-INF/web.xml :配置 spring 监听及 DispatcherServlet
< context-param >
< param-name > contextConfigLocation </ param-name >
< param-value >
/WEB-INF/application-context.xml
</ param-value >
</ context-param >
< listener >
< listener-class >
org.springframework.web.context.ContextLoaderListener
</ listener-class >
</ listener >
font-size: 8pt; colo