Java Apache XML-RPC库使用教程

畫卷琴夢

发布时间：2026-01-01 09:11:02

649人浏览过

来源于php中文网

原创

apache xml-rpc 是一个已停止维护的轻量级纯 java xml-rpc 库，最新版 3.1.3 发布于 2009 年，仅建议用于遗留系统；支持 jdk 1.4+，兼容现代 jdk，但不推荐新项目使用。

java apache xml-rpc库使用教程

Apache XML-RPC 是一个轻量级、纯 Java 实现的 XML-RPC 协议客户端与服务器端库，适合在简单远程调用场景中快速集成。它不依赖 Servlet 容器，可嵌入任意 Java 应用，但已停止维护（最新稳定版为 3.1.3，发布于 2009 年），仅建议用于遗留系统或低复杂度内部工具。

添加依赖（Maven）

使用 Maven 管理依赖时，在 pom.xml 中加入：

  org.apache.xmlrpc
  xmlrpc-client
  3.1.3

如需搭建服务端，还需添加 xmlrpc-server 和 xmlrpc-common 依赖。注意：3.x 版本要求 JDK 1.4+，与现代 JDK（如 17+）兼容性良好，但需避免在新项目中引入。

立即学习“Java免费学习笔记（深入）”；

编写简单客户端调用

XML-RPC 调用本质是发送 HTTP POST 请求，参数和返回值自动序列化为 XML。基本步骤如下：

创建 XmlRpcClientConfigImpl 实例，设置服务端 URL（如 http://localhost:8080/RPC2）
初始化 XmlRpcClient，传入配置对象
调用 execute() 方法，传入方法名（字符串）和参数列表（Object[]）
返回值为 Object 类型，需按约定类型强转（如 Integer、String、HashMap）

示例：调用远程 sample.add 方法计算两数之和：

hkcms双语言响应式科技类通用模板1.0.0

hkcms双语言响应式科技类通用模板是使用hkcms开源内容管理系统开发的一套响应式模板。内有新闻列表、新闻详情、单页、产品列表，产品详情页等。1.使用的框架采用HkCms开源内容管理系统v2.2.1版本2. 所需环境Apache/NginxPHP7.2 及以上 + MySQL 5.6 及以上3. 安装教程：1. 打开根目录，导入根目录下的数据库文件2. 站点运行路径填写到public目录下3.

下载

XmlRpcClientConfigImpl config = new XmlRpcClientConfigImpl();
config.setServerURL(new URL("http://localhost:8080/RPC2"));
XmlRpcClient client = new XmlRpcClient();
client.setConfig(config);
Object result = client.execute("sample.add", new Object[]{5, 3});
int sum = ((Number) result).intValue(); // 返回值通常是 Number 子类

搭建基础服务端

服务端需注册处理类并启动 HTTP 服务器（推荐使用内置的 Jetty 或外置容器）：

定义一个 POJO 类（如 Calculator），方法需 public、非 static、有明确返回值
创建 PropertyHandlerMapping，将方法名前缀（如 sample.）映射到该类
用 XmlRpcServer 注册 handler mapping，再通过 XmlRpcServlet 或 JettyWebServer 暴露服务

若使用 Jetty 内嵌（xmlrpc-server 自带支持）：

XmlRpcServer server = new XmlRpcServer();
PropertyHandlerMapping phm = new PropertyHandlerMapping();
phm.load(Thread.currentThread().getContextClassLoader(), "handler.properties");
// 或直接注册：phm.addHandler("sample", Calculator.class);
server.setHandlerMapping(phm);
JettyWebServer jetty = new JettyWebServer(8080, server);
jetty.start();