项目文档补充

Author: bihe0832

Advanced/app/src/main/java/com/bihe0832/request/libware/TextUtils.java

@@ -6,14 +6,11 @@
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 
+/**
+ * 基本的工具类 处理字符串判空、编码格式转换等
+ */
 public class TextUtils {
-    /**
-     * 判断字符串是否为空
-     *
-     * @param s
-     *            需要判断的字符串
-     * @return boolean 为空返回true
-     */
+
     public static boolean ckIsEmpty(String s) {
         if (s == null || s.trim().equals("") || s.trim().equals("null")) {
             return true;

Advanced/app/src/main/java/com/bihe0832/request/libware/request/BaseConnection.java

@@ -14,6 +14,8 @@
 import java.util.Map;
 
 /**
+ * HttpURLConnection封装基类，网络请求，设置请求协议头、发送请求
+ *
  * Created by hardyshi on 16/11/22.
  */
 public abstract class BaseConnection {

Advanced/app/src/main/java/com/bihe0832/request/libware/request/HTTPConnection.java

@@ -4,7 +4,9 @@
 import java.net.URL;
 
 /**
- * Created by hardyshi on 16/11/22.
+ *
+ * HTTP 请求类
+ *
  */
 public class HTTPConnection extends BaseConnection {
 

Advanced/app/src/main/java/com/bihe0832/request/libware/request/HTTPRequestHandler.java

@@ -1,7 +1,7 @@
 package com.bihe0832.request.libware.request;
 
 /**
- * Created by hardyshi on 16/11/22.
+ * 网络请求基类中将请求结果处理后的返回内容转化为业务逻辑相关错误
  */
 public abstract class HTTPRequestHandler {
     public abstract void onSuccess(int statusCode,String response);

Advanced/app/src/main/java/com/bihe0832/request/libware/request/HTTPSConnection.java

@@ -10,7 +10,7 @@
 import javax.net.ssl.TrustManager;
 
 /**
- * Created by hardyshi on 16/11/22.
+ * HTTPS 请求类
  */
 public class HTTPSConnection extends BaseConnection {
 

Advanced/app/src/main/java/com/bihe0832/request/libware/request/HTTPServer.java

@@ -11,6 +11,9 @@
 
 import java.net.HttpURLConnection;
 
+/**
+ * 网络请求分发、执行类
+ */
 public class HTTPServer {
 
     private  static final String LOG_TAG = "bihe0832 REQUEST";

Advanced/app/src/main/java/com/bihe0832/request/libware/request/HttpRequest.java

@@ -10,6 +10,11 @@
 
 import java.util.HashMap;
 
+/**
+ *
+ * 网络请求实例类的基类，所有具体的网络请求都是他的实现，他与{@link HttpResponse}一般成对使用
+ *
+ */
 
 public abstract class HttpRequest {
 
@@ -56,19 +61,12 @@ public void onSuccess(int statusCode,String response) {
 				if(TextUtils.ckIsEmpty(response)){
 					Log.e(LOG_TAG,"responseBody is null");
 				}else{
-					int flag = HTTPServer.Error;
 					try {
 						JSONObject json = new JSONObject(response);
 						int ret = json.getInt(HttpResponse.HTTP_RESP_PARAM_RET);
-						if (ret == 0) {
-							flag = HTTPServer.Succ;
-						} else {
-							flag = ret;
-						}
 						onRequestSuccess(ret, json);
 					} catch (JSONException e) {
-						flag = HTTPServer.HttpRespParseError;
-						onRequestFailure(flag, response);
+						onRequestFailure(HTTPServer.HttpRespParseError, response);
 					}
 				}
 			}catch (Exception e){
@@ -79,18 +77,13 @@ public void onSuccess(int statusCode,String response) {
 
 		@Override
 		public void onFailure(int statusCode, String responseBody) {
-			if (null == responseBody) {
-				Log.e(LOG_TAG,"responseBody is null");
-				onRequestFailure(statusCode, null);
-			}else{
-				onRequestFailure(statusCode, responseBody);
-			}
 			int code = HTTPServer.NetWorkException;
 			if (statusCode == 0) {
 				code = HTTPServer.NetWorkException;
 			} else if (statusCode > 300) {
 				code = HTTPServer.HttpSatutsError;
 			}
+			onRequestFailure(code, responseBody);
 		}
 	};
 }

Advanced/app/src/main/java/com/bihe0832/request/libware/request/HttpResponse.java

@@ -8,6 +8,13 @@
 import org.json.JSONException;
 import org.json.JSONObject;
 
+
+/**
+ *
+ * 网络请求返回结果的基类，所有具体的网络请求返回都是他的实现，他与{@link HttpRequest}一般成对使用
+ *
+ */
+
 public abstract class HttpResponse {
     private  static final String LOG_TAG = "bihe0832 REQUEST";
 
@@ -38,9 +45,9 @@ public void parseSuccessResponse(int ret, JSONObject responseJson) {
 		}
     }
 
-    public void  parseFailureResponse(int statusCode,String errorResponse) {
+    public void  parseFailureResponse(int flag,String errorResponse) {
 		this.ret = HTTPServer.RET_FAIL;
-		this.flag = processNetErrorCode(statusCode);
+		this.flag = flag;
         if(!TextUtils.ckIsEmpty(errorResponse)){
             this.msg = errorResponse;
         }
@@ -87,18 +94,4 @@ public String toString() {
         builder.append("&msg=" + msg);
         return builder.toString();
     }
-    
-	/**
-	 * @param statusCode
-	 *            当其值为0时说明是异常类错误；当其值为大于300时，说明是http错误；否则的话按默认系统错误处理 网络请求模块的错误处理
-	 */
-	private int processNetErrorCode(int statusCode) {
-		int code = HTTPServer.NetWorkException;
-		if (statusCode == 0) {
-			code = HTTPServer.NetWorkException;
-		} else if (statusCode > 300) {
-			code = HTTPServer.HttpSatutsError;
-		}
-		return code;
-	}
 }

Advanced/app/src/main/java/com/bihe0832/request/libware/request/HttpResponseHandler.java

@@ -1,4 +1,8 @@
 package com.bihe0832.request.libware.request;
+
+/**
+ * 具体业务网络请求结果实例的基类
+ */
 public interface HttpResponseHandler<T> {
 	public void onResponse(T response);
 }

Advanced/app/src/main/java/com/bihe0832/request/libware/request/MyX509TrustManager.java

@@ -9,9 +9,7 @@
 import javax.net.ssl.TrustManagerFactory;
 import javax.net.ssl.X509TrustManager;
 
-/**
- * Created by hardyshi on 16/11/23.
- */
+
 public class MyX509TrustManager implements X509TrustManager {
     X509TrustManager sunJSSEX509TrustManager;