1. REST接口JAVA客户端

为便于开发人员使用REST接口,我们提供了专用的Java客户端。

Java开发人员可通过本章学习如何调用系统的RESTFul web service接口。

如果您之前未接触过REST,可以先通过下面的示例来了解。

1.1. 准备环境

【V6.0之前版本】REST接口客户端需要以下文件支持,请从产品环境的webapps/seeyon/WEB-INF/lib获取:

seeyon-ctp-core.jar
jackson-core-asl-1.9.8.jar
jackson-core-lgpl-1.9.8.jar
jackson-jaxrs-1.9.2.jar
jackson-mapper-asl-1.9.8.jar
jackson-xc-1.9.2.jar
jersey-client-1.17.1.jar
jersey-core-1.17.1.jar
jersey-json-1.17.1.jar
jersey-server-1.17.1.jar
jersey-servlet-1.17.1.jar

【V6.0之后版本,包括V6.0,V6.1】REST接口客户端需要以下文件支持,请从产品环境的webapps/seeyon/WEB-INF/lib获取:

seeyon-ctp-core.jar
httpmime.jar
httpcore-nio.jar
httpcore.jar
httpclient-win.jar
httpclient-cache.jar
httpclient.jar
json-lib-jdk15.jar
ezmorph.jar
commons-beanutils.jar
jersey-server.jar
jersey-media-multipart.jar
jersey-media-jaxb.jar
jersey-guava.jar
jersey-container-servlet-core.jar
jersey-container-servlet.jar
jersey-common.jar
jersey-client.jar
javax.ws.rs-api.jar
javax.inject.jar
jackson-module-jaxb-annotations.jar
jackson-jaxrs-base.jar
jackson-databind.jar
jackson-annotations.jar
hk2-utils.jar
hk2-locator.jar
hk2-api.jar
javax.annotation-api.jar
jackson-jaxrs-json-provider.jar
jackson-core.jar

1.2. 获取客户端对象

首先,需要获取客户端对象的实例:

import com.seeyon.client.CTPRestClient;
import com.seeyon.client.CTPServiceClientManager;
...
// 指定协议、IP和端口,获取ClientManager
CTPServiceClientManager clientManager = CTPServiceClientManager.getInstance("http://127.0.0.1:8080");

/ 取得REST动态客户机实例
CTPRestClient client = clientManager.getRestClient();

1.3. Token验证

可以调用authenticate方法进行一次性的登录验证,后续的调用就不必传入token:

//验证rest用户
client.authenticate(userName, password);
//绑定登录用户
client.bindUser(loginName);

此时,通过客户端对象client可以访问我们提供的GET、PUT、POST、DELETE接口。

1.4. GET

所有GET类的REST接口均可按此方式调用:

// 访问按登录名获取人员信息的接口
// 期待的返回值类型为String,此时返回JSON串
String json = client.get("orgMember/?loginName=" + loginName, String.class);
// 同样的调用,此时将JSON解析为Map返回
Map map = client.get("orgMember/?loginName=" + loginName, Map.class);
// 此处指定了accept,返回值为xml
String xml = client.get("flow/data/-5199818657160149985" , String.class,"application/xml");
// 注意URL中的中文一定要进行编码
client.get("orgMembers/name/" + URLEncoder.encode("中文","UTF-8"), String.class);

1.5. POST

以新建类接口示例:

// 新建岗位
Map data = new HashMap() {
    {
        put("orgAccountId", 967547186016371000l);
        put("name", "岗位名称");
    }
};
String post = client.post("orgDepartment", data, String.class);//注意:这里的Map data 切勿传入null,及时data没有信息,也需Map data = new HashMap();

// 新建人员
Map data = new HashMap() {
    {
        put("orgAccountId", orgAccountId);
        put("name", memberName);
        put("code", "");
        put("sortId", 2);
        put("description", "");
        put("orgLevelId", levelId);
        put("orgPostId", postId);
        put("orgDepartmentId", departmentId);
        put("telNumber", "");
        put("birthday", null);
        put("officeNum", "");
        put("emailAddress", "");
        put("loginName", loginName);
    }
};
client.post("member", data, String.class);

新建和修改接口的数据,为了调用方便,通常使用Map,但如果有现成的JSON串,也可以传递字符串,比如:

client.post("flow/H0001",
    "{"senderLoginName":"sender","subject":"这是用JSON发的","data":"HTML正文","attachments":[-1,1]}",
    Long.class);

1.6. PUT

修改类接口示例:

// 修改部门的信息
Map data = new HashMap() {
    {
        put("id", -2332227039700957764l);
        put("name", "部门名称");
    }
};
String department = client.put("orgDepartment", data, String.class);//注意:这里的Map data 切勿传入null,及时data没有信息,也需Map data = new HashMap();

1.7. DELETE

删除类接口示例:

// 删除人员
client.delete("orgMember/?loginName=" + loginName, null,String.class)

1.8. 完整示例

    package com.seeyon.ctp.rest.resources;
    import java.io.UnsupportedEncodingException;
    import java.net.URLEncoder;
    import java.util.HashMap;
    import java.util.Map;

    import com.seeyon.client.CTPRestClient;
    import com.seeyon.client.CTPServiceClientManager;

    public class RestWebServiceClient {

        //REST用户登录名
      private String userName = "macx";
        //REST用户密码
        private String password = "123456";
        //定义REST动态客户机
        private CTPRestClient client = null;

        public RestWebServiceClient(){
            //取得指定服务主机的客户端管理器。
            //参数为服务主机地址,包含{协议}{Ip}:{端口},如http://127.0.0.1:8088
            CTPServiceClientManager clientManager = CTPServiceClientManager.getInstance("http://127.0.0.1:8088");
          //取得REST动态客户机。
            client = clientManager.getRestClient();
            //登录校验,成功返回true,失败返回false,此过程并会把验证通过获取的token保存在缓存中
            //再请求访问其他资源时会自动把token放入请求header中。
            client.authenticate(userName, password);
      }

        public void testRest(){
             //URL为中文的部分要进行编码
            String loginName = URLEncoder.encode("张三", "UTF-8");
            //将当前请求绑定具体的用户
            client.bindUser(loginName);
            /*
           * get请求方式代码示例
             */

            //参数类型为QueryParam
            //根据登录名获取人员信息
          client.get("orgMember?loginName="+loginName, String.class);

            try {
                //URL为中文的部分要进行编码
              client.get("orgMember?loginName="+loginName, String.class);
            } catch (UnsupportedEncodingException e) {
                e.printStackTrace();
            }

          //参数类型为PathParam
            //根据人员ID获取人员信息
            client.get("orgMember/-8361687019900091749", String.class);

            //参数类型为QueryParam和PathParam
         //根据人员电话号码和单位ID获取人员信息
            client.get("orgMember/telephone/15810557555?unitId=4526361456900091749", String.class);

            /*
             * put请求方式代码示例
           * 按照人员ID更新人员
             */
            Map map = new HashMap();
            map.put("id", -8361687019900091749L);
            map.put("type", 1);
          map.put("name", "macx");
            map.put("enabled", true);
            map.put("code", 8);
            map.put("orgLevelId", 2345678);
            //省略其他属性的设置
          //...
            String uri = "orgMember";
            client.put(uri, map, String.class);

            /*
           * delete请求方式代码示例
             * 按照人员ID删除人员
             */
            String url = "orgMember/-8361687019900091749";
            client.delete(url, null, String.class);

            /*
             * POST请求方式代码示例
             * 新增人员
             */
          Map beanMap = new HashMap();
            beanMap.put("id", 123456789);
            beanMap.put("orgAccountId", 1111111);
            beanMap.put("name", "macx11");
            beanMap.put("orgPostId", 9999999);
         beanMap.put("orgDepartmentId", 88888888);
            beanMap.put("orgLevelId", 23456789);
            beanMap.put("loginName", "macx11");
            //省略其他属性的设置
            //...
         String addUri = "orgMember";
            client.post(addUri, beanMap, String.class);
        }

    }

results matching ""

    No results matching ""