### 泛微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
<servlet>
<servlet-name>XFireServlet</servlet-name>
<display-name>XFire Servlet</display-name>
<servlet-class>org.codehaus.xfire.transport.http.XFireConfigurableServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>XFireServlet</servlet-name>
<url-pattern>/services/*</url-pattern>
</servlet-mapping>
```
- 注意确保这些配置不在任何注释内，即不要被`<!--`和`-->`包围。
##### 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`：用于处理WSDL文件。
- `commons-logging_1.0.4.jar`：日志记录工具。
- `axis.jar`：Apache Axis SOAP引擎。
- `jaxrpc.jar`：Java API for XML-based RPC。
- `saaj.jar`：SOAP with Attachments API for Java。
- `activation.jar`：JavaBeans Activation Framework。
- `mail.jar`：JavaMail API。
##### 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.0.0.1");
// 示例：创建文档
DocInfo docInfo = new DocInfo();
docInfo.setTitle("示例文档");
int createResult = service.createDoc(docInfo, sessionCode);
System.out.println("登录Session码: " + sessionCode);
System.out.println("创建文档结果: " + (createResult == 1 ? "成功" : "失败"));
} catch (Exception e) {
e.printStackTrace();
}
}
```
以上内容详细介绍了如何部署和使用泛微ecology9.0的DocService WebService接口，包括部署步骤、客户端配置、接口方法概述以及一个简单的示例。通过这些步骤和示例，开发者可以更加轻松地集成和使用该接口。
