ZConnect

基於OkHttp的客製化封裝連線。(可直接在response處更新UI)

支援的上傳檔案類型

@uploadFileType
_FILE_TYPE_JPG = "image/jpg"
_FILE_TYPE_PNG = "image/png"
_FILE_TYPE_CSV = "text/csv"

---

連線CallBack

public class ZConnectHandler {
    //-----------

    /***
     * 適用inputstream接口
     * inputStream 回傳流
     * code 狀態碼
     */
    public void OnInputStreamResponse(InputStream inputStream,int code) 


    //-----------

    /***
     * 適用 json String 接口
     * response 回傳字串
     * code 狀態碼
     */
    public void OnStringResponse(String response,int code) 


   //-----------

    /***
     *  連線失敗接口
     */
    public void OnFail(IOException e) 
    
    //----------

    /***
     *  連線成功但回覆失敗接口
     */
    public void OnFail(String response, int code) 

}

---

設置

/***
* 自訂客製化dialog
* 如不欲顯示LoadingDialog 將參數設為null即可
* 不使用此方法則會以預設Loading執行
*/
public void setCustomLoadingDialog(@Nullable Dialog dialog)

//------------------

/***
* 預設 15秒 不欲修改則不需使用此方法
* connectTimeOut 連線time out 單位毫秒
*/
public void setConnectTimeOut(int connectTimeOut)

//------------------

/***
* 預設 15秒 不欲修改則不需使用此方法
* writeTimeOut 寫入time out 單位毫秒
*/
public void setWriteTimeOut(int writeTimeOut)

//------------------

/***
* 預設 15秒 不欲修改則不需使用此方法
* readTimeOut 讀取time out 單位毫秒
*/
public void setReadTimeOut(int readTimeOut)

---

連線

/***
* 使用情境:
* 1.http get
* ... ... ... ... ... ...
* apiURL url
* zConnectCallback callback
*/
public void get(String apiURL, ZConnectHandler zConnectHandler) 

		Sample :

        zConnect.get("your url", new ZConnectHandler() {
            
            /***
             *  連線成功但回覆失敗接口
             */
            public void OnFail(String response, int code) {
               super.OnFail(response,code);

            }
            /**
            *  onFail
            */
            @Override
            public void OnFail(IOException e) {
                super.OnFail(e);
            }

            /***
            *  當回傳串流
            * @param inputStream
            * @param code 狀態碼
            */
            @Override
            public void OnInputStreamResponse(InputStream inputStream, int code) {
                super.OnInputStreamResponse(inputStream, code);
            }

            /***
            *  當回傳字串
            * @param response
            * @param code 狀態碼
            */
            @Override
            public void OnStringResponse(String response, int code) {
                super.OnStringResponse(response, code);
            }
        });

//------------------

/***
* 使用情境:
* 1.http get
* 2.headers 
* ... ... ... ... ... ...
* apiURL url
* headers header 
* zConnectCallback callback
*/
public void get(String apiURL, Map<String, String> headers, ZConnectHandler zConnectHandler) 

		Sample :

        Map<String,String> headers = new HashMap<>();
        headers.put("token","AABBCCDDEEFFGGHHIIJJKKLL");

        zConnect.get("your url",headers, new ZConnectHandler() {
            
            /***
             *  連線成功但回覆失敗接口
             */
            public void OnFail(String response, int code) {
               super.OnFail(response,code);
            }
            /**
            *  onFail
            */
            @Override
            public void OnFail(IOException e) {
                super.OnFail(e);
            }
            /**
             * onFail
             */
            @Override
            public void OnFail() {
                super.OnFail();
            }

            /***
             * 當回傳串流
             * @param inputStream
             * @param code 狀態碼
             */
            @Override
            public void OnInputStreamResponse(InputStream inputStream, int code) {
                super.OnInputStreamResponse(inputStream, code);
            }

            /***
             * 當回傳字串
             * @param response
             * @param code 狀態碼
             */
            @Override
            public void OnStringResponse(String response, int code) {
                super.OnStringResponse(response, code);
            }
        });
    

//------------------

/***
* 使用情境:
* 1.http post
* 2.headers 
* 3.params
* ... ... ... ... ... ...
* apiURL url
* headers header 用不到則帶null即可
* params keyValue 參數
* zConnectCallback callback
*/
public void post(String apiURL, @Nullable Map<String, String> headers, @Nullable Map<String, String> params, ZConnectHandler zConnectHandler) {

		Sample :

        Map<String, String> headers = new HashMap<>();
        headers.put("token", "AABBCCDDEEFFGGHHIIJJKKLL");

        Map<String, String> params = new HashMap<>();
        params.put("name", "noel");
        params.put("age", "26");
        params.put("sex", "male");
        
        zConnect.post("your url", headers, params, new ZConnectHandler() {
            /***
             *  連線成功但回覆失敗接口
             */
            public void OnFail(String response, int code) {
               super.OnFail(response,code);
            }
            /**
            *  onFail
            */
            @Override
            public void OnFail(IOException e) {
                super.OnFail(e);
            }

            /***
             *  當回傳串流
             * @param inputStream
             * @param code 狀態碼
             */
            @Override
            public void OnInputStreamResponse(InputStream inputStream, int code) {
                super.OnInputStreamResponse(inputStream, code);
            }

            /***
             *  當回傳字串
             * @param response
             * @param code 狀態碼
             */
            @Override
            public void OnStringResponse(String response, int code) {
                super.OnStringResponse(response, code);
            }
        });

//------------------

/***
* 使用情境:
* 1.http post
* 2.headers 
* 3.json request
* ... ... ... ... ... ...
* apiURL url
* headers header 用不到則帶null即可
* requestModel  json object model  用不到則帶null即可
* zConnectCallback callback
*/
public void post(String apiURL, @Nullable Map<String, String> headers, Object requestModel, ZConnectHandler zConnectHandler)

		Sample:

		public class PersonModel(){
			private String name;
			private String age;
			private String sex;
			
			public PersonModel(String name,String age,String sex){
				this.name = name;
				this.age = age;
				this.sex = sex;
			}
		}

		//------

        zConnect.post("your url", headers, params,new PersonModel("noel","26","male") ,new ZConnectHandler() {
            /***
             *  連線成功但回覆失敗接口
             */
            public void OnFail(String response, int code) {
               super.OnFail(response,code);
            }
            /**
            *  onFail
            */
            @Override
            public void OnFail(IOException e) {
                super.OnFail(e);
            }

            /***
             *  當回傳串流
             * @param inputStream
             * @param code 狀態碼
             */
            @Override
            public void OnInputStreamResponse(InputStream inputStream, int code) {
                super.OnInputStreamResponse(inputStream, code);
            }

            /***
             *  當回傳字串
             * @param response
             * @param code 狀態碼
             */
            @Override
            public void OnStringResponse(String response, int code) {
                super.OnStringResponse(response, code);
            }
        });

//------------------

/***
* 使用情境:
* 1.http post
* 2.上傳檔案
* 3.header
* 4.params
* ... ... ... ... ... ...
* apiURL url
* headers headers 用不到則帶null即可
* params params 用不到則帶null即可
* fileKey 後台此欄位key值
* fileName 檔名
* file 檔案
* fileType 檔案類型 參考 @uploadFileType
* zConnectHandler callback
*/
public void post(String apiURL, @Nullable Map<String, String> headers, @Nullable Map<String, String> params, String fileKey, String fileName, File file, @uploadFileType String fileType, ZConnectHandler zConnectHandler)

		Sample:

        Map<String, String> headers = new HashMap<>();
        headers.put("token", "AABBCCDDEEFFGGHHIIJJKKLL");

        Map<String, String> params = new HashMap<>();
        params.put("name", "noel");
        params.put("age", "26");
        params.put("sex", "male");
        

        zConnect.post("your url", headers, params,"file","fileName.jpg",new File("path"),_FILE_TYPE_JPG, new ZConnectHandler() {
            /***
             *  連線成功但回覆失敗接口
             */
            public void OnFail(String response, int code) {
               super.OnFail(response,code);
            }
            /**
            *  onFail
            */
            @Override
            public void OnFail(IOException e) {
                super.OnFail(e);
            }

            /***
             *  當回傳串流
             * @param inputStream
             * @param code 狀態碼
             */
            @Override
            public void OnInputStreamResponse(InputStream inputStream, int code) {
                super.OnInputStreamResponse(inputStream, code);
            }

            /***
             *  當回傳字串
             * @param response
             * @param code 狀態碼
             */
            @Override
            public void OnStringResponse(String response, int code) {
                super.OnStringResponse(response, code);
            }
        });


//------------------

/***
使用情境:
* 1.http post
* 2.上傳檔案
* 3.header
* 4.json request
* .. ... ... ... ... ...
* apiURL           url
* headers          header 用不到則帶null即可
* requestModel     requestModel 用不到則帶null即可
* fileKey          後台此欄位key值
* fileName         檔名
* file             檔案
* fileType         檔案類型 參考 @uploadFileType
* zConnectHandler callback
*/
public void post(String apiURL, @Nullable Map<String, String> headers, @Nullable Object requestModel, String fileKey, String fileName, File file, @uploadFileType String fileType, ZConnectHandler zConnectHandler)

		Sample:


		public class PersonModel(){
			private String name;
			private String age;
			private String sex;
			
			public PersonModel(String name,String age,String sex){
				this.name = name;
				this.age = age;
				this.sex = sex;
			}
		}

        Map<String, String> headers = new HashMap<>();
        headers.put("token", "AABBCCDDEEFFGGHHIIJJKKLL");



        zConnect.post("your url", headers, new PersonModel("noel","26","male"),"file","fileName.jpg",new File("path"),_FILE_TYPE_JPG, new ZConnectHandler() {
            /***
             *  連線成功但回覆失敗接口
             */
            public void OnFail(String response, int code) {
               super.OnFail(response,code);
            }
            /**
            *  onFail
            */
            @Override
            public void OnFail(IOException e) {
                super.OnFail(e);
            }

            /***
             *  當回傳串流
             * @param inputStream
             * @param code 狀態碼
             */
            @Override
            public void OnInputStreamResponse(InputStream inputStream, int code) {
                super.OnInputStreamResponse(inputStream, code);
            }

            /***
             *  當回傳字串
             * @param response
             * @param code 狀態碼
             */
            @Override
            public void OnStringResponse(String response, int code) {
                super.OnStringResponse(response, code);
            }
        });