如果开发一个和服务端有数据交互android应用,流程通常是这样的:界面收集用户数据之后,将它转换成JSON或者XML格式的字符串,以HTTP的方式提交给服务端,获得返回的文本数据,再将数据解析为java对象,参看这位朋友的博文《android通过httpClient请求获取JSON数据并且解析》。对于复杂的应用,JSON数据的字段会很多,那数据解析的那段代码就会很长。能不能封装这个流程,让开发人员只关注业务逻辑呢?用Spring For Android可以做到这一点。
Spring For Android是Spring框架的一个扩展,主要目的在简化Android本地应用的开发。 官方网址:http://www.springsource.org/spring-android
1 使用RestTemplate来为你的Android客户端提供REST服务
2 提供了跟其它诸如Twitter和Facebook等社交网络的集成与OAuth授权客户端等等
本文章讨论的是RestTemplate的使用,第二项功能就不介绍了。
下面以用户登录的例子,给大家介绍spring for android如何使用:
1 引入必须的JAR
jaskson-core和jackson-mappper用来解析和自动映射json数据,在官方网址可以下载到
2 先看android客户端代码
LoginMessage message = new LoginMessage(username,password); MemberMessage responseMessage =RestTemplateManager.postJSON(Urls.LOGIN_URL, message, MemberMessage.class);
LoginMessage是一个普通的Java bean, 它包含了一个登录所需的用户名(loginName)和密码(passsword),MemberMessage 也是一个普通的Java bean,l里面包含了用户基本信息.RestTemplateManager.postJSON()会将LoginMessage对象自动转化为json格式的数据,并以https post方式送出,再将服务端返回的结果转化为MemberMessage对象.
让我们在看看RestTemplateManager的代码(注意红色字体部分)
public class RestTemplateManager { private static final int CONNECT_TIMEOUT = 30000;// 30秒 private static final int READ_TIMEOUT = 15000;// 15秒 private static final String TAG = "RestTemplateManager"; private static SimpleClientHttpRequestFactory simpleFactory; private static HttpComponentsClientHttpRequestFactory httpComponentsFactory; private static HttpHeaders httpHeaders = new HttpHeaders(); static { simpleFactory = new SimpleClientHttpRequestFactory(); simpleFactory.setConnectTimeout(CONNECT_TIMEOUT); simpleFactory.setReadTimeout(READ_TIMEOUT); httpComponentsFactory = new HttpComponentsClientHttpRequestFactory(); httpComponentsFactory.setConnectTimeout(CONNECT_TIMEOUT); httpComponentsFactory.setReadTimeout(READ_TIMEOUT); } /** * 请求头里面加入验证字符串 * * @param extra */ public static void setHttpHeaders(String extra) { httpHeaders.add("verify", extra); } public static ClientHttpRequestFactory getResquestFactory() { // 当SDK版本号为大于2.3时 if (Build.VERSION.SDK_INT >= 9) { return simpleFactory; } return httpComponentsFactory; } /** * POST请求 * * @param url * @param msg * @param clazz * @return */ public static <R, M> R postJSON(String url, M msg, Class<R> clazz) { try { Log.v(TAG, url); httpHeaders.setContentType(MediaType.APPLICATION_JSON); HttpEntity<M> requestEntity = new HttpEntity<M>(msg, httpHeaders); RestTemplate restTemplate = new RestTemplate(getResquestFactory()); ResponseEntity<R> response = restTemplate.exchange(url, HttpMethod.POST, requestEntity, clazz); return response.getBody(); } catch (Exception e) { e.printStackTrace(); } return null; } public static <R> R getJSON(String url, Class<R> clazz, Object... uriVariables) { try { url = spliceRestURL(url, uriVariables); Log.v(TAG, url); HttpEntity<?> requestEntity = new HttpEntity<Object>(httpHeaders); RestTemplate restTemplate = new RestTemplate(getResquestFactory()); ResponseEntity<R> responseEntity = restTemplate.exchange(url, HttpMethod.GET, requestEntity, clazz, uriVariables); return responseEntity.getBody(); } catch (Exception e) { e.printStackTrace(); } return null; } /** * 拼接rest风格的URL,注意参数的顺序 */ public static String spliceRestURL(String prefix, Object... params) { StringBuilder builder = new StringBuilder(prefix); for (Object p : params) { builder.append("/").append(p); } return builder.toString(); } }
postJSON和getJSON方法封装了http请求和JSON数据解析,开发人员只要定义合适的数据对象和处理好业务流程即可。
3 服务端的代码(springMVC演示)
@RequestMapping(value = "login", method = RequestMethod.POST, produces = "application/json") @ResponseBody public MemberMessage login(@RequestBody LoginMessage message) { MemberMessage result = new MemberMessage(); //登录过程处理.......
return result; }
springmvc收到LoginMessage对象处理了登录流程之后,再将结果对象MemberMessage转化为JSON数据
MemberMessage和LoginMessage两个对象在服务端和客户端是重用的,如果你的服务端是Java项目,使用这个组件就更便利了。
这个框架已经用在了公司的客户端上,几乎所有的数据请求都用它。