Resty开发白皮书-中文版

使用Java客户端来访问Api(resty-client)

1. 使用Resty-client客户端来验证Api的权限,当使用了登录参数,api访问403没有权限时,会先进行登录,以通过权限验证

//第一个为基础的api路径,第二个参数为登录api(http://127.0.0.1:8081/api/v1.0/sessions)
//第三个为用户名,第四个为密码,第5个为RememberMe
Client client = new Client("http://127.0.0.1:8081/api/v1.0", "/sessions", "awesa", "123", false);
//不需要登录时
Client client = new Client("http://127.0.0.1:8081/api/v1.0");

2. 使用client来执行表单请求,返回请求结果ClientResult

ClientRequest request = new ClientRequest("/users/1");
//添加一个参数
uploadRequest.addParameter("parameter", "我是参数");
ClientResult result=client.build(request).post();

3. 使用client来发送application/json数据请求

ClientRequest request = new ClientRequest("/users/1");
request.setJsonParameter(jsonString);
ResponseData result=client.build(request).post();

4. 使用client来上传文件

ClientRequest uploadRequest = new ClientRequest("/tests/resty");
uploadRequest.addUploadFile("resty", ClientTest.class.getResource("/resty.jar").getFile());
uploadRequest.addParameter("des", "test file  paras  测试笔");
ClientResult uploadResult = client.build(uploadRequest).post();

5. 使用client来下载文件,支持断点续传

ClientRequest downloadRequest = new ClientRequest("/tests/file");
//设置下载文件保存目录  
/第二个参数overwrite可以没有,表示遇到同名文件是否覆盖
downloadRequest.setDownloadFile(ClientTest.class.getResource("/").getFile(),false);
ClientResult downloadResult = client.build(downloadRequest).get();