本指南详细介绍了如何利用泛微ecology9.0平台中的DocService Web服务接口进行文档管理操作，包括文档上传、下载和查询等，助力用户高效集成和自动化办公流程。
### 泛微ecology9.0文档（DocService）WebService接口使用详解
#### 一、部署准备工作
在开始使用泛微ecology9.0的DocService WebService接口之前，需要进行一系列的部署准备工作。
##### 1. 更新lib目录下的文件
- **Spring库更新**：将原先的`spring.jar`替换为`spring-1.2.6.jar`。
- **XFire库更新**：将`xfire-all-1.1.2.jar`替换为`xfire-all-1.2.6.jar`。
- **新增依赖**：在lib目录下添加`xbean-spring-2.8.jar`文件，用于支持Spring框架与XFire的集成。
##### 2. 修改web.xml文件
- 在web.xml中添加对XFireServlet的配置：
```xml
XFireServlet
XFire Servlet
org.codehaus.xfire.transport.http.XFireConfigurableServlet
XFireServlet
/services/*
```
- 确保这些配置不在任何注释内，即不要被``包围。
##### 3. 添加必要的文件
- 在classes目录下添加`META-INF/xfire/services.xml`文件。
- 在classes目录中添加以下class文件：
- `weaver/docs/webservices/DocAttachment.class`
- `weaver/docs/webservices/DocCustomField.class`
- `weaver/docs/webservices/DocInfo.class`
- `weaver/docs/webservices/DocService.class`
- `weaver/docs/webservices/DocServiceImpl.class`
这些步骤确保了DocService接口能够正常启动并提供服务。
#### 二、客户端部署及使用
为了调用DocService接口，需要在客户端添加特定的库文件：
##### 1. 客户端所需库文件
- `commons-discovery-0.2.jar`
- `javax-wsdl_1.5.1.jar`
- `commons-logging_1.0.4.jar`
- `axis.jar`
- `jaxrpc.jar`
- `saaj.jar`
- `activation.jar`
- `mail.jar`
##### 2. 获取wsdl描述
部署成功后，可以通过访问以下URL获取DocService接口的WSDL描述文件：
```
http://服务器:端口号/services/DocService?wsdl
```
此WSDL文件详细描述了接口结构、方法和数据类型信息。
#### 三、接口方法概述
- **login**：登录验证。
- 参数：`loginid`, `password`, `logintype`, `ipaddress`。
- 返回值：登录Session码。
- 功能描述：验证用户身份，返回Session码供后续操作使用。
- **createDoc**：创建文档。
- 参数：`docinfo`, `sessioncode`。
- 返回值：创建结果（1为成功，0为失败）。
- 功能描述：基于文档信息对象创建文档。
- **updateDoc**：更新文档。
- 参数：`docinfo`, `sessioncode`。
- 返回值：更新结果（1为成功，0为失败）。
- 功能描述：基于文档信息对象更新文档。
- **deleteDoc**：删除文档。
- 参数：`id`, `sessioncode`。
- 返回值：删除结果（1为成功，0为失败）。
- 功能描述：根据文档ID删除文档。
- **getDoc**：获取文档。
- 参数：`id`, `sessioncode`。
- 返回值：文档对象。
- 功能描述：根据文档ID获取文档及其内容和附件信息。
- **getDocCount**：获取文档数量。
- 参数：`sessioncode`。
- 返回值：文档数量。
- 功能描述：统计用户有权限访问的文档总数。
- **getList**：获取文档列表
- 参数：`sessioncode`
- 返回值: 文档对象数组
- 功能描述: 获取用户有权访问的所有文档信息，但不包含具体内容和附件。
#### 四、接口调用示例
以下是一个简单的代码示例展示如何使用Eclipse生成的客户端程序来调用DocService接口的方法：
```java
public static void main(String[] args) {
try {
// 根据Eclipse生成的Web Service客户端程序，取得接口实例
DocServiceProxy docService = new DocServiceProxy();
DocService service = docService.getDocServicePort();
// 示例：登录
String sessionCode = service.login(username, password, 0, 127
5星
