Jersey API基础及应用例子

  1. 概述:在学习微信接口的过程中用到了请求web接口资源的操作

  2. Jersey 客户端API基础 

    首先需要创建一个com.sun.jersey .api.client.Client 类的实例。

    import com.sun.jersey .api.client.Client;

    Client client = Client.create();

    或者 ClientConfig clientConfig = ClienConfig.DefaultClientConfig();

        Client client = Client.create(clientConfig);                                                               Client 类是创建一个 RESTful Web Service 客户端的主要配置点。你可以使用它来配置不同的客户端属性和功能,并且指出使用哪个资源提供者。创建一个 Client 类的实例是一个比较昂贵的操作,所以尽量避免创建一些不需要的客户端实例。比较好的方式是尽可能地复用已经存在的实例。

        当你创建完一个 Client 类的实例后,你可以开始使用它。无论如何,在发出请求前,你需要创建一个 Web Resource 对象来封装客户端所需要的 Web 资源。

    Web 资源创建了一个 WebResponse 对象:

    import com.sun.jersey .api.client.WebResource;

    WebResource webResource = c.resource("https://api.weixin.qq.com/cgi-bin/message/custom/send");

    通过使用 WebResource 对象来创建要发送到 Web 资源的请求,以及处理从 Web 资源返回的响应。例如,你可以使用 WebResource 对象来发送 HTTP GET、PUT、POST 以及 DELETE 请求。

        2.1 get 请求:使用 WebResource 类的 get() 方法来提交一个 HTTP GET请求到 Web 资源:

    String s = webResource.get(String.class);

        这表示如果 WebResource 对象的 URL 是https://api.weixin.qq.com/cgi-bin/message/custom/send,那么一个 HTTP GET 请求将会发送到地址为https://api.weixin.qq.com/cgi-bin/message/custom/send的资源。

    String s = webResource.get(String.class);

       你还可以指定 get() 请求时的查询参数。例如,下面的代码在 get() 请求中指定了两个查询参数:

    有两种方式,其实也算一样的吧:

    第一种:

    MultivaluedMap queryParams = new MultivaluedMapImpl();

    queryParams.add("param1", val1);

    queryParams.add("param2", val2);

    String s = webResouce.queryParams(queryParams).get(String.class);

    第二种:

    webResource.queryParam("param1",val1).queryParam("param2",val2).get(String.class);

    你还可以指定响应所能接受的 MIME 类型。例如,下面的代码指定了响应的 MIME 类型只能为文本:

    String s = webResource.accept("text/plain").get(String.class);

    2.2 ClientResponse 

    你还可以获取对应请求的 HTTP 状态码,例如下面这个例子展示获取一个请求所返回的文本实体与状态码:   

    ClientResponse response = webResource.accept("text/plain").get(ClientResponse.class);

    int status = response.getStatus();

    String textEntity = response.getEntity(String.class);     

    ClientResponse 对象代表了一个客户端收到的 HTTP 响应。   

    2.3 put请求 :不想写

    2.4 post请求 :一个 POST 请求相当于一个 GET 请求和一个 PUT 请求的综合,也就意味着,你可以使用 POST 请求来发送一个实体到指定的 Web 资源并且接收另一个实体。使用 WebResource 类的 post() 方法来发送一个 HTTP POST 请求到指定的 Web 资源。下面的例子展示了发送一个带有查询参数以及进行了 URL 编码的表单数据的 POST 请求:

    例子1.

    MultivaluedMap formData = new MultivaluedMapImpl();

    formData.add("name1", "val1");

    formData.add("name2", "val2");

    ClientResponse response = webResource.type("application/x-www-form-urlencoded").post(ClientResponse.class, formData);

    2.5 delete 请求:使用 Web Resource 类的 delete() 方法来发送 HTTP DELETE 请求到指定的 Web 资源。例如,下面的例子展示删除一个 URI 为 https://api.weixin.qq.com/cgi-bin/message/custom/send 资源:

    ClientResponse response = webResource.path("user/123")

                                         .delete(ClientResponse.class);

     注意:WebResource.path() 方法可以在所有 HTTP 请求中使用,它可以让你给要请求的 Web 资源指定一个额外的路径。另一个  WebResouce 类的方法 header() 可以给你的请求添加 HTTP 头部信息。如果表单提交的话,需要new Form来作为参数提交。

  3. 代码例子 微信发送消息

       /**

         * 往指定用户发送信息

         * @param message

         * @param toUser

         * @return

         */

        public WechatMessageResult send(String message, String toUser) {

           ClientConfig config = new DefaultClientConfig();

            Client client = Client.create(config);

            WebResource webResource = client.resource("https://api.weixin.qq.com/cgi-bin/message/custom/send");

            ClientResponse clientResponse = webResource

                    .queryParam("access_token", getAccessToken().getToken())

                    .post(ClientResponse.class, new Gson().toJson(new MassageBuilder("text").toUser(toUser).textContent(message).bulid()));

            if (clientResponse.getStatus() != 200) {

                throw new IllegalStateException("status error:" + clientResponse.getStatus());

            } else {

                return new Gson().fromJson(clientResponse.getEntity(String.class), WechatMessageResult.class);

            }

        }

本文出自 “小博客” 博客,请务必保留此出处http://9686567.blog.51cto.com/9676567/1588041

Jersey API基础及应用例子

上一篇:经验总结40--C#枚举


下一篇:HandleBase句柄的5种写法