Spring Android：RestTemplate 模块详解

2星需积分: 10 139 浏览量更新于2024-07-30 收藏 172KB PDF 举报

“Spring Android 参考手册” Spring Android 是一个由SpringSource公司开发的框架，旨在简化Android开发者在应用程序中集成Spring框架的工作。这个参考手册是针对Spring Android 1.0.0.M4版本的，由Roy Clarkson撰写，提供了一个全面的指南，帮助开发者理解和使用该框架。 1. Spring Android 概览这部分介绍了Spring Android的基本概念和目标。Spring Android旨在为Android应用提供一些核心Spring框架的功能，比如依赖注入和RESTful服务的客户端支持。它帮助开发者构建更加模块化、易于测试和维护的Android应用。 1.1. 引言在这一章节，作者向读者介绍了Spring Android的背景和主要目的，以及它如何适应Android开发环境。 2. Spring Android RestTemplate 模块这个模块专注于Spring Android对处理RESTful服务的支持，通过RestTemplate类提供了丰富的功能。 2.1. 介绍简单介绍了RestTemplate模块的功能，它是Spring Android中的一个重要组件，用于发送HTTP请求并处理响应。 2.2. 概览 - HTTPClient：RestTemplate基于Android的HttpClient实现，允许进行各种HTTP操作。 - Gzip Compression：支持gzip压缩，提高网络传输效率。 - Object to JSON Marshaling：将Java对象转换为JSON字符串，便于在网络中传输。 - Object to XML Marshaling：类似地，也支持Java对象到XML的转换。 - RSS and Atom Support：提供了对RSS和Atom feed的处理能力，方便解析和创建这些数据格式。 2.3. RestTemplate 方法详细列出了RestTemplate提供的HTTP方法，包括DELETE、GET、HEAD、OPTIONS、POST、PUT等，以及它们的使用方式。 2.4. HTTP Message Conversion 这部分讨论了消息转换器，如StringHttpMessageConverter、FormHttpMessageConverter、MappingJacksonHttpMessageConverter等，它们负责在HTTP请求和响应之间转换数据格式。 2.5. 如何获取解释了如何获取和配置所需的处理器，例如用于JSON处理的Jackson库、Google Gson库、SimpleXMLSerializer以及Android的ROME FeedReader库。 2.6. 使用示例提供了基础使用示例和特定功能的使用方法，如基本使用示例和启用Gzip压缩的示例。手册的其余部分可能会涵盖更多关于如何在实际项目中应用Spring Android，如何配置和集成到现有应用，以及错误处理和调试等方面的内容。通过这个参考手册，开发者可以深入理解Spring Android框架，并有效地利用其功能来提升Android应用的开发效率和质量。

Spring Android

1.0.0.M4 Spring Android Reference Manual 2

2. Spring Android RestTemplate Module

2.1 Introduction

Spring's RestTemplate is a robust, popular Java-based REST client. The Spring Android RestTemplate Module

provides a version of RestTemplate that works in an Android environment.

2.2 Overview

The RestTemplate class is the heart of the Spring Android RestTemplate library. It is conceptually similar

to other template classes found in other Spring portfolio projects. RestTemplate's behavior is customized

by providing callback methods and configuring the HttpMessageConverter used to marshal objects

into the HTTP request body and to unmarshal any response back into an object. When you create a new

RestTemplate instance, the constructor sets up several supporting objects that make up the RestTemplate

functionality.

Here is an overview of the functionality supported within RestTemplate.

HTTP Client

RestTemplate provides an abstraction for making RESTful http requests, and internally,

RestTemplate utilizes a native Android HTTP client library for those requests. The HttpComponents

HttpClient [http://hc.apache.org/httpcomponents-client-ga/index.html] is a native HTTP client available

on the Android platform. Within Spring Android RestTemplate the HttpClient is made available

through the HttpComponentsClientHttpRequestFactory. This class is set as the default

ClientHttpRequestFactory when you create a new RestTemplate instance. The standard

J2SE facilities are also available as a native Android library, and are made available through the

SimpleClientHttpRequestFactory. To utilize the SimpleClientHttpRequestFactory,

you must either pass a new instance into the RestTemplate constructor, or call

setRequestFactory(ClientHttpRequestFactory requestFactory) on an existing

RestTemplate instance.

Gzip Compression

RestTemplate supports sending and receiving data encoded with gzip compression. The HTTP

specification allows for additional values in the Accept-Encoding header field, however RestTemplate

only supports gzip compression at this time.

Object to JSON Marshaling

Object to JSON marshaling in Spring Android RestTemplate requires the use of a third party JSON

mapping library. There are two libraries supported in Spring Android, Jackson JSON Processor [http://

jackson.codehaus.org], and Google Gson [http://code.google.com/p/google-gson/]. While Jackson is a well

known JSON parsing library, the Gson library is smaller, which would result in an smaller Android app when

packaged.

Spring Android

1.0.0.M4 Spring Android Reference Manual 3

Object to XML Marshaling

Object to XML marshaling in Spring Android RestTemplate requires the use of a third party XML

mapping library. The Simple XML serializer [http://simple.sourceforge.net] is used to provide this marshaling

functionality.

RSS and Atom Support

RSS and Atom feed support in Spring Android RestTemplate requires the use of a third party feed reader library.

The Android ROME Feed Reader [http://code.google.com/p/android-rome-feed-reader] is used to provide this

functionality.

2.3 RestTemplate Methods

RestTemplate provides higher level methods that correspond to each of the six main HTTP methods. These

methods make it easy to invoke many RESTful services and enforce REST best practices.

The names of RestTemplate methods follow a naming convention, the first part indicates what HTTP

method is being invoked and the second part indicates what is returned. For example, the method

getForObject() will perform a GET, convert the HTTP response into an object type of your choice and

return that object. The method postForLocation() will do a POST, converting the given object into a

HTTP request and return the response HTTP Location header where the newly created object can be found. In

case of an exception processing the HTTP request, an exception of the type RestClientException will

be thrown. This behavior can be changed by plugging in another ResponseErrorHandler implementation

into the RestTemplate.

For more information on RestTemplate and it's associated methods, please refer to the API Javadoc [http://

static.springsource.org/spring-android/docs/1.0.x/api/org/springframework/web/client/RestTemplate.html]

HTTP DELETE

public void delete(String url, Object... urlVariables) throws RestClientException;

public void delete(String url, Map<String, ?> urlVariables) throws RestClientException;

public void delete(URI url) throws RestClientException;

HTTP GET

public <T> T getForObject(String url, Class<T> responseType, Object... urlVariables) throws RestClientException;

public <T> T getForObject(String url, Class<T> responseType, Map<String, ?> urlVariables) throws RestClientException;

public <T> T getForObject(URI url, Class<T> responseType) throws RestClientException;

public <T> ResponseEntity<T> getForEntity(String url, Class<T> responseType, Object... urlVariables);

剩余31页未读，继续阅读

pcjavanet

粉丝: 92
资源: 97

Spring Android：RestTemplate 模块详解

Spring Integration Reference Manual.pdf

spring-integration-reference

Spring 3 Reference中文

Spring Framework Reference Documentation 4.0

Spring boot中文教程（Spring Boot Reference Guide 1.3.0.BUILD）

Spring Boot Reference Guide中文翻译 -《Spring Boot参考指南》.zip

spring reference中文版

spring-boot-reference-2.0.3-中文版

Spring Framework 4.x Reference Documentation 中文翻译

Spring.Security.3 中文参考手册 Reference

最新资源