MIDP 1.0 HttpConnection类的robust封装

核心提示：一、“NetConnection”简介：转述Matrix上zhengyun_ustc所述：“你的HttpConnection是否封装的足够健壮呢？遇到各种情况，你是否有信心应对呢？譬如说，MIDP 1.0 HttpConnection类的robust封装，你要请求的Response包实在太大，以至于运营商给你掐了告诉你

　　一、“NetConnection”简介：

转述Matrix上zhengyun_ustc所述：“你的HttpConnection是否封装的足够健壮呢？遇到各种情况，你是否有信心应对呢？譬如说，你要请求的Response包实在太大，以至于运营商给你掐了告诉你说超时；譬如说你是不是总要自己写一个线程来专门作http连接？譬如说有一些移动运营商设置了caching PRoxy servers，妨碍了你的测试。”

为了解决这个问题，一位日本程序员“JAY-F”针对MIDP1.0提供了一种robust的“NetConnection”封装。这个HttpConnnection类负责管理连接并易于使用。

二、“NetConnection”特性：

1. 跨过Proxy-server阻碍：

一些移动网络放置了代理服务器用来提高访问速度，但是它的cache也成为了开发人员测试/调试程序的一大障碍。“NetConnection”类使用一个简单的http request属性将server上的代理功能关闭掉。

2. 使用线程分离的连接模式：

本类可以使用单线程、多线程两种模式运行，只要设置一个简单的标志即可。

3. 支持Http request range：

由于服务商在其网络上可能存在一些针对回应数据最大长度的限制，所以“NetConnection”类提供了构造request URL的功能使回应数据分为多个数据包。从而去除了前面的限制。

三、netConnection是如何实现的？

1。netConnection类结构分析：

此类实现了Runnable接口，其运行模式支持多线程模式：当前只能由一个线程使用资源，其它线程wait。

此类使用了一些静态成员变量：

　　　　//当前只能由一个线程使用singleton。
　　　　private static NetConnection singleton = new NetConnection();

　　　　private static HttpConnection httpConn;

　　　　private static String url;

　　　　private static String method;

　　　　private static byte[] data;
　　　　　　　　

　　　　private static String contentType;
　　　　

　　　　private static long lowRange;
　　　　

　　　　private static long highRange;
　　　　

　　　　private static boolean disableProxy;
　　　　

　　　　private static boolean detached;
　　　　
　　　　private static byte[] response;

类方法：

//线程run方法
public void run()

//当前运行的线程执行完毕后，通报给其它的由于等待资源而wait状态的线程
private synchronized void forceNotify() 

//当资源正在被其它线程使用时，当前线程进入wait状态
private synchronized void forceWait()

//关闭http连接
private static void severConnection()

由于使用了这些static成员变量，所以一些操作方法需要同步（synchronized）。

2。netConnection核心代码解析：

netConnection类的实现思想很简单，就是设置一些request属性和对于GET方法构造一个特殊的URL。更重要的是其作者对http协议的深入理解、严谨的代码风格值得吾辈学习、研究。这也是本人分析其核心代码的一大原因。

/**
 * 实现了连接逻辑。
 * 调用者可以在分离的线程中使用netConnection类的静态连接。
 * @throws IllegalStateException 如果此方法直接其它类调用则抛出该异常
 */
public void run() {
　　　　
　　　　if (url == null) {
　　　　　　　　throw new IllegalStateException("Cannot invoke this method!");
　　　　}

　　　　
　　　　DataOutputStream dos = null;
　　　　DataInputStream dis = null;
　　　　StringBuffer buffer = null;

　　　　try {

　　　　　　　　int permissions = 0;
　　　　　　　　
　　　　　　　　//根据method值，设置Connector的权限（READ/READ_WRITE）
　　　　　　　　if (HttpConnection.GET.equals(method)) {
　　　　　　　　　　　　permissions = Connector.READ;
　　　　　　　　} else if (HttpConnection.POST.equals(method)) {
　　　　　　　　　　　　permissions = Connector.READ_WRITE;
　　　　　　　　}
　　　　　　　　
　　　　　　　　//如果关闭server代理功能，则构造noProxyUrl。
　　　　　　　　//原理：使用timestamp作为该URL中no-proxy参数值，
　　　　　　　　//　　　　致使server视其为client发来的新请求。
　　　　　　　　if (disableProxy) {
　　　　　　　　　　　　
　　　　　　　　　　　　boolean hasQueryParams = false;
　　　　　　　　　　　　
　　　　　　　　　　　　char[] ca = url.toCharArray();
　　　　　　　　　　　　//判断原URL中是否含有参数
　　　　　　　　　　　　for (int loop = 0; loop < url.length(); loop++) {
　　　　　　　　　　　　　　　　
　　　　　　　　　　　　　　　　if (ca[loop] == '?') {
　　　　　　　　　　　　　　　　　　　　hasQueryParams = true;
　　　　　　　　　　　　　　　　　　　　break;
　　　　　　　　　　　　　　　　}
　　　　　　　　　　　　}
　　　　　　　　　　　　
　　　　　　　　　　　　//由于需要多次字符串拼接，所以使用可提供效率的StringBuffer类
　　　　　　　　　　　　StringBuffer noProxyUrl = new StringBuffer();

　　　　　　　　　　　　//将原URL内容复制到noProxyUrl
　　　　　　　　　　　　noProxyUrl.append(url);

　　　　　　　　　　　　//如果原URL中含有参数，
　　　　　　　　　　　　//　则需要在noProxyUrl中增加"&"，
　　　　　　　　　　　　//　否则直接在noProxyUrl中增加"?"，
　　　　　　　　　　　　//　这样做为了后面增加no-proxy参数做准备。
　　　　　　　　　　　　if (hasQueryParams) {
　　　　　　　　　　　　　　　　noProxyUrl.append("&");
　　　　　　　　　　　　} else {
　　　　　　　　　　　　　　　　noProxyUrl.append("?");
　　　　　　　　　　　　}

　　　　　　　　　　　　//增加no-proxy参数
　　　　　　　　　　　　noProxyUrl.append("no-proxy=");
　　　　　　　　　　　　noProxyUrl.append(System.currentTimeMillis()); // timestamp
　　　　　　　　　　　　
　　　　　　　　　　　　//将构造好的noProxyUrl复制到原URL
　　　　　　　　　　　　url = noProxyUrl.toString();
　　　　　　　　}
　　　　　　　　
　　　　　　　　

　　　　　　　　// 打开Http 连接
　　　　　　　　httpConn = (HttpConnection) Connector.open(url, permissions, true);
　　　　　　　　//设置request方法
　　　　　　　　httpConn.setRequestMethod(method);

　　　　　　　　//如果request权限为READ（即request方法为GET），
　　　　　　　　//则需要设置http request属性的Range。
　　　　　　　　//原理：设置http request属性的Range后的，
　　　　　　　　//　　　　server接收到该request后将把response数据分成小部分发回。
　　　　　　　　//　　　　从而避免了部分运营商对http response size的限制。
　　　　　　　　if (permissions == Connector.READ) {　　　　
　　　　　　　　　　　　if (lowRange > -1 && lowRange < highRange) {
　　　　　　　　　　　　　　　　StringBuffer range = new StringBuffer();
　　　　　　　　　　　　　　　　
　　　　　　　　　　　　　　　　range.append("bytes=");
　　　　　　　　　　　　　　　　range.append(lowRange);
　　　　　　　　　　　　　　　　range.append("-");
　　　　　　　　　　　　　　　　range.append(highRange);
　　　　　　　　　　　　　　　　
　　　　　　　　　　　　　　　　httpConn.setRequestProperty("Range", range.toString());
　　　　　　　　　　　　}
　　　　　　　　//否则，request权限为READ_WRITE（即request方法为POST），
　　　　　　　　//那么设置request的Content-Type属性。
　　　　　　　　} else if (permissions == Connector.READ_WRITE) {
　　　　　　　　　　　　// POST request
　　　　　　　　　　　　httpConn.setRequestProperty("Content-Type", contentType);
　　　　　　　　　　　　dos = httpConn.openDataOutputStream();
　　　　　　　　　　　　dos.write(data);
　　　　　　　　}
　　　　
　　　　} catch (Exception e) {
　　　　
　　　　　　　　exceptionPipe = e;
　　　　　　　　//如果程序运行在多线程模式，则在异常发生后需要唤醒其它睡眠的线程继续run
　　　　　　　　if (detached) {
　　　　　　　　　　　　forceNotify();
　　　　　　　　}
　　　　　　　　
　　　　　　　　return;
　　　　　　　　
　　　　} finally {

　　　　　　　　try {
　　　　　　　　　　　　try {
　　　　　　　　　　　　　　　　if (dos != null) {
　　　　　　　　　　　　　　　　　　　　// 关闭dos
　　　　　　　　　　　　　　　　　　　　dos.close();
　　　　　　　　　　　　　　　　}
　　　　　　　　　　　　} catch (Exception e) {
　　　　　　　　　　　　　　　　// 如果程序运行在多线程模式，则在异常发生后需要唤醒其它睡眠的线程继续run
　　　　　　　　　　　　　　　　if (exceptionPipe == null) {
　　　　　　　　　　　　　　　　　　　　exceptionPipe = e;
　　　　　　　　　　　　　　　　　　　　
　　　　　　　　　　　　　　　　　　　　if (detached) {
　　　　　　　　　　　　　　　　　　　　　　　　forceNotify();
　　　　　　　　　　　　　　　　　　　　}
　　　　　　　　　　　　　　　　　　　　return;
　　　　　　　　　　　　　　　　}
　　　　　　　　　　　　} finally {
　　　　　　　　　　　　　　　　dos = null;
　　　　　　　　　　　　}
　　　　　　　　　　　　
　　　　　　　　　　　　// 读取http连接的回应代码
　　　　　　　　　　　　int responseCode = httpConn.getResponseCode();
　　　　　　　　　　　　
　　　　　　　　　　　　//当request方法为GET，并设置了request range时，接收到的回应代码为HTTP_PARTIAL
　　　　　　　　　　　　//当request方法为POST，接收到的回应代码为HTTP_OK
　　　　　　　　　　　　//如果上述两种回应代码均没有收到，则表明连接失败或者出问题
　　　　　　　　　　　　if (responseCode != HttpConnection.HTTP_OK
　　　　　　　　　　　　　　　　　　　　&& responseCode != HttpConnection.HTTP_PARTIAL) {

　　　　　　　　　　　　　　　　if (exceptionPipe == null) {
　　　　　　　　　　　　　　　　　　　　StringBuffer errorCode = new StringBuffer();
　　　　　　　　　　　　　　　　　　　　errorCode.append("Response code from server: ");
　　　　　　　　　　　　　　　　　　　　errorCode.append(responseCode);
　　　　　　　　　　　　　　　　　　　　errorCode.append("\nMessage: [");
　　　　　　　　　　　　　　　　　　　　errorCode.append(httpConn.getResponseMessage());
　　　　　　　　　　　　　　　　　　　　errorCode.append("]");
　　　　　　　　　　　　　　　　　　　　
　　　　　　　　　　　　　　　　　　　　exceptionPipe = new IOException(errorCode.toString());
　　　　　　　　　　　　　　　　　　　　
　　　　　　　　　　　　　　　　　　　　if (detached) {
　　　　　　　　　　　　　　　　　　　　　　　　forceNotify();
　　　　　　　　　　　　　　　　　　　　}
　　　　　　　　　　　　　　　　　　　　return;
　　　　　　　　　　　　　　　　}
　　　　　　　　　　　　}

　　　　　　　　　　　　//如果收到了上述的两种回应代码之一，则可以继续读取server的response数据
　　　　　　　　　　　　dis = httpConn.openDataInputStream();

　　　　　　　　　　　　//循环读取repsonse数据
　　　　　　　　　　　　int ch;
　　　　　　　　　　　　buffer = new StringBuffer();
　　　　　　　　while ((ch = dis.read()) != -1) {
　　　　　　　　　　　　buffer.append((char) ch);
　　　　　　　　}

　　　　　　　　//将response数据进行必要的编码转换　　　　　　　　 
　　　　　　　　　　　　response = buffer.toString().getBytes("ISO8859_1");
　　　　　　　　　　　　//接收到回应后，表明整个http会话过程结束，线程将结束。
　　　　　　　　　　　　//如果程序运行在多线程模式，则此时需要唤醒其它睡眠的线程继续run
　　　　　　　　　　　　if (detached) {
　　　　　　　　　　　　　　　　forceNotify();
　　　　　　　　　　　　}
　　　　　　　　　　　　
　　　　　　　　　　　　return;

　　　　　　　　} catch (Exception e) {
　　　　　　　　　　　　
　　　　　　　　　　　　if (exceptionPipe == null) {
　　　　　　　　　　　　　　　　exceptionPipe = e;
　　　　　　　　　　　　　　　　
　　　　　　　　　　　　　　　　if (detached) {
　　　　　　　　　　　　　　　　　　　　forceNotify();
　　　　　　　　　　　　　　　　}
　　　　　　　　　　　　　　　　
　　　　　　　　　　　　　　　　return;
　　　　　　　　　　　　}
　　　　　　　　} finally {
　　　　　　　　　　
　　　　　　　　　　　　try {
　　　　　　　　　　　　　　　　if (dis != null) {
　　　　　　　　　　　　　　　　　　　　// 关闭dis
　　　　　　　　　　　　　　　　　　　　dis.close();
　　　　　　　　　　　　　　　　}
　　　　　　　　　　　　} catch (Exception e) {
　　　　　　　　　　　　　　　　// 若关闭dis时发生异常，则进行异常处理
　　　　　　　　　　　　　　　　if (exceptionPipe == null) {
　　　　　　　　　　　　　　　　　　　　exceptionPipe = e;
　　　　　　　　　　　　　　　　　　　　
　　　　　　　　　　　　　　　　　　　　if (detached) {
　　　　　　　　　　　　　　　　　　　　　　　　forceNotify();
　　　　　　　　　　　　　　　　　　　　}
　　　　　　　　　　　　　　　　　　　　return;
　　　　　　　　　　　　　　　　}
　　　　　　　　　　　　} finally {
　　　　　　　　　　　　　　　　dis = null;
　　　　　　　　　　　　}
　　　　　　　　　　　　
　　　　　　　　　　　　try {
　　　　　　　　　　　　　　　　if (httpConn != null) {
　　　　　　　　　　　　　　　　　　　　//关闭http连接
　　　　　　　　　　　　　　　　　　　　httpConn.close();

　　　　　　　　　　　　　　　　　　　　httpConn = null;
　　　　　　　　　　　　　　　　}
　　　　　　　　　　　　} catch (Exception e) {

　　　　　　　　　　　　　　　　if (exceptionPipe == null) {
　　　　　　　　　　　　　　　　　　　　exceptionPipe = e;
　　　　　　　　　　　　　　　　　　　　
　　　　　　　　　　　　　　　　　　　　if (detached) {
　　　　　　　　　　　　　　　　　　　　　　　　forceNotify();
　　　　　　　　　　　　　　　　　　　　}
　　　　　　　　　　　　　　　　　　　　return;
　　　　　　　　　　　　　　　　}
　　　　　　　　　　　　}
　　　　　　　　}
　　　　}
}

五、参考资料：

联系netConnection作者：JAY-F
源代码下载
HTTP/1.1定义

（出处：http://www.cncms.com）