Apache CXF 的REST 方式发布WebService实现，Android手机后台服务的开发

最新推荐文章于 2021-05-27 00:00:02 发布

CodeYourBrother

最新推荐文章于 2021-05-27 00:00:02 发布

阅读量1.7k

点赞数

分类专栏： android 服务器客户端通信文章标签： Apache CXF 的REST 方式发布WebService实现 Android手机后台服务的开发服务器

android 同时被 2 个专栏收录

50 篇文章 0 订阅

订阅专栏

服务器客户端通信

4 篇文章 0 订阅

订阅专栏

最近项目中采用Apache CXF 的REST 方式发布WebService实现，Android手机后台服务的开发，以下以简单是实例实现。

在项目中采用Android+REST WebService服务方式开发的手机平台很少采用 soap协议这种方式，主要soap协议解析问题，增加了代码量。采用RESTFull 方式开发WebService的好处，相对SOAP协议的WebService来说，比较简单。同时简化了在手机解析工作，减轻了手机端的压力，提高了手机响应的效率。

手机后台服务：

Java代码

package com.easyway.rest.ws;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;
/**
* 服务端发布一个简单的WebService服务
* 在手机端接受服务端发送的信息.
* 使用 Apache HttpClient 库访问 JAX-RS web 服务。Jersey 是 JAX-RS
* 的参考实现，它简化了 Java™ 环境下的 RESTful Web 服务的开发。Android
* 是一款流行的智能手机，本文将展示如何为 Android 创建一个 JAX-RS 客户端。
* 您将创建一个访问 JAX-RS Web 服务的 Apache HttpClient 库客户端。
* JAX-RS必须的jar：
* jersey-bundle-1.8.jar，jersey-server-1.10.jar，jsr311-api-1.1.1.jar
* asm-3.1.jar
* 使用一个 root 资源类创建一个 RESTful Web 服务资源。root 资源类是带有 @PATH
* 注释的 POJO。它包含至少一个带注释的方法，该注释为 @PATH、@GET、@PUT、@POST
* 或 @DELETE。
*
* 在服务器上，按照 web.xml 的指定，init 参数 com.sun.jersey.config.property.resourceConfigClass
* 作为 com.sun.jersey.api.core.PackagesResourceConfig 启动，而 init 参数
* com.sun.jersey.config.property.packages 作为 com.easyway.rest.ws 启动。
* 找到 root 资源类 com.easyway.rest.ws.HelloWorldResource。
*
* 备注：如果采用jersey发布JAXRS服务需要配置：
* <pre>
* <servlet>
* <description>JAX-RS</description>
* <servlet-name>JAX-RS-Servlet</servlet-name>
* <servlet-class>com.sun.jersey.spi.container.servlet.ServletContainer</servlet-class>
* <init-param>
* <param-name>com.sun.jersey.config.property.resourceConfigClass</param-name>
* <param-value>com.sun.jersey.api.core.PackagesResourceConfig</param-value>
* </init-param>
* <init-param>
* <param-name>com.sun.jersey.config.property.packages</param-name>
* <param-value>com.easyway.rest.ws</param-value>
* </init-param>
* <load-on-startup>1</load-on-startup>
* </servlet>
* <servlet-mapping>
* <servlet-name>JAX-RS-Servlet</servlet-name>
* <url-pattern>/services/*</url-pattern>
* </servlet-mapping>
*
* </pre>
*
* @author longgangbai
*
*/
@Path("/helloworld")
public class HelloWorldResource {
/**
* 一个简单的文本信息
* @return
*/
@GET
@Produces(MediaType.TEXT_PLAIN)
public String getClichedMessage() {
return "Hello Android";
}
}

web.xml配置如下：

Java代码

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5">
<display-name>JAXRSWebService</display-name>
<servlet>
<description>JAX-RS</description>
<servlet-name>JAX-RS-Servlet</servlet-name>
<servlet-class>com.sun.jersey.spi.container.servlet.ServletContainer</servlet-class>
<init-param>
<param-name>com.sun.jersey.config.property.resourceConfigClass</param-name>
<param-value>com.sun.jersey.api.core.PackagesResourceConfig</param-value>
</init-param>
<init-param>
<param-name>com.sun.jersey.config.property.packages</param-name>
<param-value>com.easyway.rest.ws</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>JAX-RS-Servlet</servlet-name>
<url-pattern>/services/*</url-pattern>
</servlet-mapping>
</web-app>

Java代码

注意如果没有 Resource 将会报如下异常：
com.sun.jersey.api.container.ContainerException: The ResourceConfig instance does not contain any root resource classes.

手机前台服务：

Java代码

package com.easyway.rest.ws;
import java.io.IOException;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.ClientProtocolException;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.DefaultHttpClient;
import org.apache.http.util.EntityUtils;
import android.app.Activity;
import android.os.Bundle;
import android.os.StrictMode;
import android.widget.TextView;
/**
* Android平台主要提供了四种数据存储方式：Shared Preferences、文件存储、Sqlite存储和网络存储。其中：
1）Shared Preferences 一个轻量级的键-值存储机制，专门用于存储键-值对数据，并且仅可以存储基本的数据类型
（boolean、int、long、float和String）；通常使用它来存储应用程序的配置信息。
2）文件存储通过FileInputStream和FileOutputStream对文件进行操作，在Android中，文件是一个应用程序私有的，
一个应用程序无法读写其它应用程序的文件。
3）SQLite存储 SQLite是一款轻型的数据库，支持标准SQL。它的设计目标是嵌入式的，占用资源非常的低，在嵌入式设备中，
只需要几百K的内存就够了。Android平台也为我们提供了SQLite数据库。
4）网络存储以上3种方式数据均存储在手机上，而网络存储的数据是存储在远程服务器上，手机客户端通过联接到网络来存储和获取数据。
今天要讲解的HttpClient正是常用的网络存储工具之一。记得最早接触HttpClient是在两年前，当时要做一个垂直搜索引擎，
数据自然是来源于互联网，通过一个爬虫系统不断从指定网站上爬取感兴趣的数据，然后通过Lucene搜索引擎框架实现海量数据
的快速检索。而爬虫系统最开始是想采用开源的爬虫框架Heritrix来实现，但接触一段时间后发现Heritrix过于庞大，而且是作
为一个独立的系统运行，不方便嵌入到现有的系统中，再加上学习成本高，最后还是选择了“HttpClient + HtmlParser”来实现的
小型爬虫系统；其中HttpClient可以模拟HTTP的POST和GET请求，用于从指定网站获取网页数据，而HtmlParser用于解析爬取到
的页面，过滤HTML标记，取得最终数据。
是不是发现HttpClient还挺强大的？让我们看看它是什么来头。"HttpClient 是 Apache Jakarta Common 下的子项目，可以用来
提供高效的、最新的、功能丰富的支持 HTTP 协议的客户端编程工具包，并且它支持 HTTP 协议最新的版本和建议"。如果你以前没
有接触过HttpClient，那么你只需要简单记住两点就可以了：
1）HttpClient是一个HTTP协议开发包；
2）HttpClient不是Android的专利。
HttpClient的功能介绍：
1）实现了HTTP请求的所有方法（如GET、POST、PUT、HEAD 等）；
2）支持自动转向；
3）支持 HTTPS 协议；
4）支持代理服务器等
HttpClient的基本使用（以POST请求为例）：
1）创建HttpClient实例（类似于浏览器客户端）；
HttpClient client = new DefaultHttpClient();
2）创建HttpPost请求，需要向HttpPost的构造方法传入所请求的URL；
HttpPost post = new HttpPost(requestUrl);
3）发出POST请求（调用HttpClient的execute()方法，execute()的参数为HttpPost实例）；
HttpResponse response = client.execute(post);
4）读取返回结果；
5）释放连接；
6）对返回的结果进行处理。
在Android平台上使用HttpClient，并不需要添加额外的jar包，因为Android平台吸收了许多优秀的开源框架，其中就包括HttpClient，
下面就来看一个Android平台使用HttpClient的例子。
备注：是不是发现HttpClient很容易使用呢？其实，上面所讲解的只是HttpClient最基本的功能（发起POST请求）；我们在浏览器客户端
所执行的大多数操作HttpClient都能够模拟，例如：提交表单、查询数据、上传下载文档、页面跳转、Session存储等。比如大家经
常玩“抢车位”、“偷菜”，就可以通过HttpClient编程自动实现。
*
*
* 客户端通过Apache HttpClient调用JAXRS WebService的服务。
* 为 Android 开发访问 JAX-RS Web 服务的 Apache HttpClient 客户端.
*
* 备注：在访问本机的JAXRS Web服务的时候不能使用localhost或者127.0.0.1，
* 因为android模拟机会调用自身的linux内核操作系统，所以可能找不到相关的服务。
* 最好填写ip地址如下：
* "http://192.168.134.1:8080/JAXRSWebService/services/helloworld";
*
* @author longgangbai
*
*/
public class AndroidJAXRSWebServiceActivity extends Activity {
private static final String processURL="http://192.168.134.1:8080/JAXRSWebService/services/helloworld";
private TextView txResult;
/**
* Called when the activity is first created.
*/
@Override
public void onCreate(Bundle savedInstanceState) {
///在Android2.2以后必须添加以下代码
//本应用采用的Android4.0
//设置线程的策略
StrictMode.setThreadPolicy(new StrictMode.ThreadPolicy.Builder()
.detectDiskReads()
.detectDiskWrites()
.detectNetwork() // or .detectAll() for all detectable problems
.penaltyLog()
.build());
//设置虚拟机的策略
StrictMode.setVmPolicy(new StrictMode.VmPolicy.Builder()
.detectLeakedSqlLiteObjects()
//.detectLeakedClosableObjects()
.penaltyLog()
.penaltyDeath()
.build());
super.onCreate(savedInstanceState);
//设置UI布局
setContentView(R.layout.main);
//获取结果显示文本框
txResult=(TextView)findViewById(R.id.tvresult);
//获取JAXRS WebService的结果信息
getJAXRSWebService();
}
/**
* 获取JAXRS WebService的结果信息
*/
public void getJAXRSWebService(){
try {
//创建一个HttpClient对象
HttpClient httpclient = new DefaultHttpClient();
//创建HttpGet对象
HttpGet request=new HttpGet(processURL);
//请求信息类型MIME每种响应类型的输出（普通文本、html 和 XML）。允许的响应类型应当匹配资源类中生成的 MIME 类型
//资源类生成的 MIME 类型应当匹配一种可接受的 MIME 类型。如果生成的 MIME 类型和可接受的 MIME 类型不匹配，那么将
//生成 com.sun.jersey.api.client.UniformInterfaceException。例如，将可接受的 MIME 类型设置为 text/xml，而将
//生成的 MIME 类型设置为 application/xml。将生成 UniformInterfaceException。
request.addHeader("Accept","text/plain");
//获取响应的结果
HttpResponse response =httpclient.execute(request);
//获取HttpEntity
HttpEntity entity=response.getEntity();
//获取响应的结果信息
String result =EntityUtils.toString(entity);
txResult.setText(result);
} catch (ClientProtocolException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
}