Android 專案重構之路：實現篇

發表於2015-11-19

Android專案重構之路:架構篇
 Android專案重構之路:介面篇
 Android專案重構之路:實現篇

前兩篇文章《Android專案重構之路:架構篇》和《Android專案重構之路:介面篇》已經講了我的專案開始搭建時的架構設計和介面設計，這篇就講講具體怎麼實現的，以實現最小化可用產品(MVP)的目標，用最簡單的方式來搭建架構和實現程式碼。

IDE採用Android Studio，Demo實現的功能為使用者註冊、登入和展示一個券列表，資料採用我們現有專案的測試資料，介面也是我們專案中的測試介面。

專案搭建

根據架構篇所講的，將專案分為了四個層級：模型層、介面層、核心層、介面層。四個層級之間的關係如下圖所示：

實現上，在Android Studio分為了相應的四個模組(Module)：model、api、core、app。
model為模型層，api為介面層，core為核心層，app為介面層。
model、api、core這三個模組的型別為library，app模組的型別為application。
四個模組之間的依賴設定為：model沒有任何依賴，介面層依賴了模型層，核心層依賴了模型層和介面層，介面層依賴了核心層和模型層。
專案搭建的步驟如下：

建立新專案，專案名稱為KAndroid，包名為com.keegan.kandroid。預設已建立了app模組，檢視下app模組下的build.gradle，會看到第一行為：

apply plugin: 'com.android.application'

1

apply plugin: 'com.android.application'

這行表明了app模組是application型別的。
分別新建模組model、api、core，Module Type都選為Android Library，在Add an activity to module頁面選擇Add No Activity，這三個模組做為庫使用，並不需要介面。建立完之後，檢視相應模組的build.gradle，會看到第一行為：

apply plugin: 'com.android.library'

1

apply plugin: 'com.android.library'

建立模組之間的依賴關係。有兩種方法可以設定：
第一種：通過右鍵模組，然後Open Module Settings，選擇模組的Dependencies，點選左下方的加號，選擇Module dependency，最後選擇要依賴的模組，下圖為api模組新增了model依賴；

第二種：直接在模組的build.gradle設定。開啟build.gradle，在最後的dependencies一項裡面新增新的一行：compile project(‘:ModuleName’)，比如app模組新增對model模組和core模組依賴之後的dependencies如下：

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.android.support:appcompat-v7:22.0.0'
    compile project(':model')
    compile project(':core')
}

dependencies {

compile fileTree(dir: 'libs', include: ['*.jar'])

compile 'com.android.support:appcompat-v7:22.0.0'

compile project(':model')

compile project(':core')

}

通過上面兩種方式的任意一種，建立了模組之間的依賴關係之後，每個模組的build.gradle的dependencies項的結果將會如下：
model:

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.android.support:appcompat-v7:22.0.0'
}

dependencies {

compile fileTree(dir: 'libs', include: ['*.jar'])

compile 'com.android.support:appcompat-v7:22.0.0'

}

api:

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.android.support:appcompat-v7:22.0.0'
    compile project(':model')
}

dependencies {

compile fileTree(dir: 'libs', include: ['*.jar'])

compile 'com.android.support:appcompat-v7:22.0.0'

compile project(':model')

}

core:

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.android.support:appcompat-v7:22.0.0'
    compile project(':model')
    compile project(':api')
}

dependencies {

compile fileTree(dir: 'libs', include: ['*.jar'])

compile 'com.android.support:appcompat-v7:22.0.0'

compile project(':model')

compile project(':api')

}

app:

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.android.support:appcompat-v7:22.0.0'
    compile project(':model')
    compile project(':core')
}

dependencies {

compile fileTree(dir: 'libs', include: ['*.jar'])

compile 'com.android.support:appcompat-v7:22.0.0'

compile project(':model')

compile project(':core')

}

建立業務物件模型

業務物件模型統一存放於model模組，是對業務資料的封裝，大部分都是從介面傳過來的物件，因此，其屬性也與介面傳回的物件屬性相一致。在這個Demo裡，只有一個業務物件模型，封裝了券的基本資訊，以下是該實體類的程式碼：

/**
 * 券的業務模型類，封裝了券的基本資訊。
 * 券分為了三種型別：現金券、抵扣券、折扣券。
 * 現金券是擁有固定面值的券，有固定的售價；
 * 抵扣券是滿足一定金額後可以抵扣的券，比如滿100減10元；
 * 折扣券是可以打折的券。
 *
 * @version 1.0 建立時間：15/6/21
 */
public class CouponBO implements Serializable {
    private static final long serialVersionUID = -8022957276104379230L;
    private int id;                // 券id
    private String name;           // 券名稱
    private String introduce;      // 券簡介
    private int modelType;         // 券型別，1為現金券，2為抵扣券，3為折扣券
    private double faceValue;      // 現金券的面值
    private double estimateAmount; // 現金券的售價
    private double debitAmount;    // 抵扣券的抵扣金額
    private double discount;       // 折扣券的折扣率（0-100）
    private double miniAmount;     // 抵扣券和折扣券的最小使用金額

    // TODO 所有屬性的getter和setter
}

/**

* 券的業務模型類，封裝了券的基本資訊。

* 券分為了三種型別：現金券、抵扣券、折扣券。

* 現金券是擁有固定面值的券，有固定的售價；

* 抵扣券是滿足一定金額後可以抵扣的券，比如滿100減10元；

* 折扣券是可以打折的券。

* @version 1.0 建立時間：15/6/21

public class CouponBO implements Serializable {

private static final long serialVersionUID = -8022957276104379230L;

private int id; // 券id

private String name; // 券名稱

private String introduce; // 券簡介

private int modelType; // 券型別，1為現金券，2為抵扣券，3為折扣券

private double faceValue; // 現金券的面值

private double estimateAmount; // 現金券的售價

private double debitAmount; // 抵扣券的抵扣金額

private double discount; // 折扣券的折扣率（0-100）

private double miniAmount; // 抵扣券和折扣券的最小使用金額

// TODO 所有屬性的getter和setter

}

介面層的封裝

在這個Demo裡，提供了4個介面：一個傳送驗證碼的介面、一個註冊介面、一個登入介面、一個獲取券列表的介面。這4個介面具體如下：

傳送驗證碼介面
URL：http://uat.b.quancome.com/platform/api
引數：

引數名描述型別

appKey ANDROID_KCOUPON String

method service.sendSmsCode4Register String

phoneNum 手機號碼 String

輸出樣例：

{ "event": "0", "msg": "success" }

1

{ "event": "0", "msg": "success" }
註冊介面
URL：http://uat.b.quancome.com/platform/api
引數：

引數名描述型別

appKey ANDROID_KCOUPON String

method customer.registerByPhone String

phoneNum 手機號碼 String

code 驗證碼 String

password MD5加密密碼 String

輸出樣例：

{ "event": "0", "msg": "success" }

1

{ "event": "0", "msg": "success" }

登入介面
URL：http://uat.b.quancome.com/platform/api
其他引數：

引數名	描述	型別
appKey	ANDROID_KCOUPON	String
method	customer.loginByApp	String
loginName	登入名（手機號）	String
password	MD5加密密碼	String
imei	手機imei串號	String
loginOS	系統，android為1	int

輸出樣例：

{ "event": "0", "msg": "success" }

1	{ "event": "0", "msg": "success" }

券列表
URL：http://uat.b.quancome.com/platform/api
其他引數：

引數名	描述	型別
appKey	ANDROID_KCOUPON	String
method	issue.listNewCoupon	String
currentPage	當前頁數	int
pageSize	每頁顯示數量	int

輸出樣例：

{ "event": "0", "msg": "success", "maxCount": 125, "maxPage": 7, "currentPage": 1, "pageSize": 20, "objList":[
    {"id": 1, "name": "測試現金券", "modelType": 1, ...}, 
    {...}, 
    ...
]}

{ "event": "0", "msg": "success", "maxCount": 125, "maxPage": 7, "currentPage": 1, "pageSize": 20, "objList":[

{"id": 1, "name": "測試現金券", "modelType": 1, ...},

{...},

...

]}

在架構篇已經講過，介面返回的json資料有三種固定結構：

{"event": "0", "msg": "success"}
{"event": "0", "msg": "success", "obj":{...}}
{"event": "0", "msg": "success", "objList":[{...}, {...}], "currentPage": 1, "pageSize": 20, "maxCount": 2, "maxPage": 1}

{"event": "0", "msg": "success"}

{"event": "0", "msg": "success", "obj":{...}}

{"event": "0", "msg": "success", "objList":[{...}, {...}], "currentPage": 1, "pageSize": 20, "maxCount": 2, "maxPage": 1}

因此可以封裝成實體類，程式碼如下：

public class ApiResponseT> {
    private String event;    // 返回碼，0為成功
    private String msg;      // 返回資訊
    private T obj;           // 單個物件
    private T objList;       // 陣列物件
    private int currentPage; // 當前頁數
    private int pageSize;    // 每頁顯示數量
    private int maxCount;    // 總條數
    private int maxPage;     // 總頁數

    // 建構函式，初始化code和msg
    public ApiResponse(String event, String msg) {
        this.event = event;
        this.msg = msg;
    }

    // 判斷結果是否成功
    public boolean isSuccess() {
        return event.equals("0");
    }

    // TODO 所有屬性的getter和setter
}

public class ApiResponseT> {

private String event; // 返回碼，0為成功

private String msg; // 返回資訊

private T obj; // 單個物件

private T objList; // 陣列物件

private int currentPage; // 當前頁數

private int pageSize; // 每頁顯示數量

private int maxCount; // 總條數

private int maxPage; // 總頁數

// 建構函式，初始化code和msg

public ApiResponse(String event, String msg) {

this.event = event;

this.msg = msg;

}

// 判斷結果是否成功

public boolean isSuccess() {

return event.equals("0");

}

// TODO 所有屬性的getter和setter

}

上面4個介面，URL和appKey都是一樣的，用來區別不同介面的則是method欄位，因此，URL和appKey可以統一定義，method則根據不同介面定義不同常量。而除去appKey和method，剩下的引數才是每個介面需要定義的引數。因此，對上面4個介面的定義如下：

public interface Api {
    // 傳送驗證碼
    public final static String SEND_SMS_CODE = "service.sendSmsCode4Register";
    // 註冊
    public final static String REGISTER = "customer.registerByPhone";
    // 登入
    public final static String LOGIN = "customer.loginByApp";
    // 券列表
    public final static String LIST_COUPON = "issue.listNewCoupon";

    /**
     * 傳送驗證碼
     *
     * @param phoneNum 手機號碼
     * @return 成功時返回：{ "event": "0", "msg":"success" }
     */
    public ApiResponseVoid> sendSmsCode4Register(String phoneNum);

    /**
     * 註冊
     *
     * @param phoneNum 手機號碼
     * @param code     驗證碼
     * @param password MD5加密的密碼
     * @return 成功時返回：{ "event": "0", "msg":"success" }
     */
    public ApiResponseVoid> registerByPhone(String phoneNum, String code, String password);

    /**
     * 登入
     *
     * @param loginName 登入名（手機號）
     * @param password  MD5加密的密碼
     * @param imei      手機IMEI串號
     * @param loginOS   Android為1
     * @return 成功時返回：{ "event": "0", "msg":"success" }
     */
    public ApiResponseVoid> loginByApp(String loginName, String password, String imei, int loginOS);

    /**
     * 券列表
     *
     * @param currentPage 當前頁數
     * @param pageSize    每頁顯示數量
     * @return 成功時返回：{ "event": "0", "msg":"success", "objList":[...] }
     */
    public ApiResponseListCouponBO>> listNewCoupon(int currentPage, int pageSize);
}

public interface Api {

// 傳送驗證碼

public final static String SEND_SMS_CODE = "service.sendSmsCode4Register";

// 註冊

public final static String REGISTER = "customer.registerByPhone";

// 登入

public final static String LOGIN = "customer.loginByApp";

// 券列表

public final static String LIST_COUPON = "issue.listNewCoupon";

/**

* 傳送驗證碼

* @param phoneNum 手機號碼

* @return 成功時返回：{ "event": "0", "msg":"success" }

public ApiResponseVoid> sendSmsCode4Register(String phoneNum);

/**

* 註冊

* @param phoneNum 手機號碼

* @param code 驗證碼

* @param password MD5加密的密碼

* @return 成功時返回：{ "event": "0", "msg":"success" }

public ApiResponseVoid> registerByPhone(String phoneNum, String code, String password);

/**

* 登入

* @param loginName 登入名（手機號）

* @param password MD5加密的密碼

* @param imei 手機IMEI串號

* @param loginOS Android為1

* @return 成功時返回：{ "event": "0", "msg":"success" }

public ApiResponseVoid> loginByApp(String loginName, String password, String imei, int loginOS);

/**

* 券列表

* @param currentPage 當前頁數

* @param pageSize 每頁顯示數量

* @return 成功時返回：{ "event": "0", "msg":"success", "objList":[...] }

public ApiResponseListCouponBO>> listNewCoupon(int currentPage, int pageSize);

}

Api的實現類則是ApiImpl了，實現類需要封裝好請求資料並向伺服器發起請求，並將響應結果的資料轉為ApiResonse返回。而向伺服器傳送請求並將響應結果返回的處理則封裝到http引擎類去處理。另外，這裡引用了gson將json轉為物件。ApiImpl的實現程式碼如下：

public class ApiImpl implements Api {
    private final static String APP_KEY = "ANDROID_KCOUPON";
    private final static String TIME_OUT_EVENT = "CONNECT_TIME_OUT";
    private final static String TIME_OUT_EVENT_MSG = "連線伺服器失敗";
    // http引擎
    private HttpEngine httpEngine;

    public ApiImpl() {
        httpEngine = HttpEngine.getInstance();
    }

    @Override
    public ApiResponseVoid> sendSmsCode4Register(String phoneNum) {
        MapString, String> paramMap = new HashMapString, String>();
        paramMap.put("appKey", APP_KEY);
        paramMap.put("method", SEND_SMS_CODE);
        paramMap.put("phoneNum", phoneNum);

        Type type = new TypeTokenApiResponseVoid>>(){}.getType();
        try {
            return httpEngine.postHandle(paramMap, type);
        } catch (IOException e) {
            return new ApiResponse(TIME_OUT_EVENT, TIME_OUT_EVENT_MSG);
        }
    }

    @Override
    public ApiResponseVoid> registerByPhone(String phoneNum, String code, String password) {
        MapString, String> paramMap = new HashMapString, String>();
        paramMap.put("appKey", APP_KEY);
        paramMap.put("method", REGISTER);
        paramMap.put("phoneNum", phoneNum);
        paramMap.put("code", code);
        paramMap.put("password", EncryptUtil.makeMD5(password));

        Type type = new TypeTokenApiResponseListCouponBO>>>(){}.getType();
        try {
            return httpEngine.postHandle(paramMap, type);
        } catch (IOException e) {
            return new ApiResponse(TIME_OUT_EVENT, TIME_OUT_EVENT_MSG);
        }
    }

    @Override
    public ApiResponseVoid> loginByApp(String loginName, String password, String imei, int loginOS) {
        MapString, String> paramMap = new HashMapString, String>();
        paramMap.put("appKey", APP_KEY);
        paramMap.put("method", LOGIN);
        paramMap.put("loginName", loginName);
        paramMap.put("password", EncryptUtil.makeMD5(password));
        paramMap.put("imei", imei);
        paramMap.put("loginOS", String.valueOf(loginOS));

        Type type = new TypeTokenApiResponseListCouponBO>>>(){}.getType();
        try {
            return httpEngine.postHandle(paramMap, type);
        } catch (IOException e) {
            return new ApiResponse(TIME_OUT_EVENT, TIME_OUT_EVENT_MSG);
        }
    }

    @Override
    public ApiResponseListCouponBO>> listNewCoupon(int currentPage, int pageSize) {
        MapString, String> paramMap = new HashMapString, String>();
        paramMap.put("appKey", APP_KEY);
        paramMap.put("method", LIST_COUPON);
        paramMap.put("currentPage", String.valueOf(currentPage));
        paramMap.put("pageSize", String.valueOf(pageSize));

        Type type = new TypeTokenApiResponseListCouponBO>>>(){}.getType();
        try {
            return httpEngine.postHandle(paramMap, type);
        } catch (IOException e) {
            return new ApiResponse(TIME_OUT_EVENT, TIME_OUT_EVENT_MSG);
        }
    }

}

public class ApiImpl implements Api {

private final static String APP_KEY = "ANDROID_KCOUPON";

private final static String TIME_OUT_EVENT = "CONNECT_TIME_OUT";

private final static String TIME_OUT_EVENT_MSG = "連線伺服器失敗";

// http引擎

private HttpEngine httpEngine;

public ApiImpl() {

httpEngine = HttpEngine.getInstance();

}

@Override

public ApiResponseVoid> sendSmsCode4Register(String phoneNum) {

MapString, String> paramMap = new HashMapString, String>();

paramMap.put("appKey", APP_KEY);

paramMap.put("method", SEND_SMS_CODE);

paramMap.put("phoneNum", phoneNum);

Type type = new TypeTokenApiResponseVoid>>(){}.getType();

try {

return httpEngine.postHandle(paramMap, type);

} catch (IOException e) {

return new ApiResponse(TIME_OUT_EVENT, TIME_OUT_EVENT_MSG);

}

@Override

public ApiResponseVoid> registerByPhone(String phoneNum, String code, String password) {

MapString, String> paramMap = new HashMapString, String>();

paramMap.put("appKey", APP_KEY);

paramMap.put("method", REGISTER);

paramMap.put("phoneNum", phoneNum);

paramMap.put("code", code);

paramMap.put("password", EncryptUtil.makeMD5(password));

Type type = new TypeTokenApiResponseListCouponBO>>>(){}.getType();

try {

return httpEngine.postHandle(paramMap, type);

} catch (IOException e) {

return new ApiResponse(TIME_OUT_EVENT, TIME_OUT_EVENT_MSG);

}

@Override

public ApiResponseVoid> loginByApp(String loginName, String password, String imei, int loginOS) {

MapString, String> paramMap = new HashMapString, String>();

paramMap.put("appKey", APP_KEY);

paramMap.put("method", LOGIN);

paramMap.put("loginName", loginName);

paramMap.put("password", EncryptUtil.makeMD5(password));

paramMap.put("imei", imei);

paramMap.put("loginOS", String.valueOf(loginOS));

Type type = new TypeTokenApiResponseListCouponBO>>>(){}.getType();

try {

return httpEngine.postHandle(paramMap, type);

} catch (IOException e) {

return new ApiResponse(TIME_OUT_EVENT, TIME_OUT_EVENT_MSG);

}

@Override

public ApiResponseListCouponBO>> listNewCoupon(int currentPage, int pageSize) {

MapString, String> paramMap = new HashMapString, String>();

paramMap.put("appKey", APP_KEY);

paramMap.put("method", LIST_COUPON);

paramMap.put("currentPage", String.valueOf(currentPage));

paramMap.put("pageSize", String.valueOf(pageSize));

Type type = new TypeTokenApiResponseListCouponBO>>>(){}.getType();

try {

return httpEngine.postHandle(paramMap, type);

} catch (IOException e) {

return new ApiResponse(TIME_OUT_EVENT, TIME_OUT_EVENT_MSG);

}

而http引擎類的實現如下：

public class HttpEngine {
    private final static String SERVER_URL = "http://uat.b.quancome.com/platform/api";
    private final static String REQUEST_MOTHOD = "POST";
    private final static String ENCODE_TYPE = "UTF-8";
    private final static int TIME_OUT = 15000;

    private static HttpEngine instance = null;

    private HttpEngine() {
    }

    public static HttpEngine getInstance() {
        if (instance == null) {
            instance = new HttpEngine();
        }
        return instance;
    }

    public T> T postHandle(MapString, String> paramsMap, Type typeOfT) throws IOException {
        String data = joinParams(paramsMap);
        HttpUrlConnection connection = getConnection();
        connection.setRequestProperty("Content-Length", String.valueOf(data.getBytes().length));
        connection.connect();
        OutputStream os = connection.getOutputStream();
        os.write(data.getBytes());
        os.flush();
        if (connection.getResponseCode() == 200) {
            // 獲取響應的輸入流物件
            InputStream is = connection.getInputStream();
            // 建立位元組輸出流物件
            ByteArrayOutputStream baos = new ByteArrayOutputStream();
            // 定義讀取的長度
            int len = 0;
            // 定義緩衝區
            byte buffer[] = new byte[1024];
            // 按照緩衝區的大小，迴圈讀取
            while ((len = is.read(buffer)) != -1) {
                // 根據讀取的長度寫入到os物件中
                baos.write(buffer, 0, len);
            }
            // 釋放資源
            is.close();
            baos.close();
            connection.disconnect();
            // 返回字串
            final String result = new String(baos.toByteArray());
            Gson gson = new Gson();
            return gson.fromJson(result, typeOfT);
        } else {
            connection.disconnect();
            return null;
        }
    }

    private HttpURLConnection getConnection() {
        HttpURLConnection connection = null;
        // 初始化connection
        try {
            // 根據地址建立URL物件
            URL url = new URL(SERVER_URL);
            // 根據URL物件開啟連結
            connection = (HttpURLConnection) url.openConnection();
            // 設定請求的方式
            connection.setRequestMethod(REQUEST_MOTHOD);
            // 傳送POST請求必須設定允許輸入，預設為true
            connection.setDoInput(true);
            // 傳送POST請求必須設定允許輸出
            connection.setDoOutput(true);
            // 設定不使用快取
            connection.setUseCaches(false);
            // 設定請求的超時時間
            connection.setReadTimeout(TIME_OUT);
            connection.setConnectTimeout(TIME_OUT);
            connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
            connection.setRequestProperty("Connection", "keep-alive");
            connection.setRequestProperty("Response-Type", "json");
            connection.setChunkedStreamingMode(0);
        } catch (IOException e) {
            e.printStackTrace();
        }
        return connection;
    }

    private String joinParams(MapString, String> paramsMap) {
        StringBuilder stringBuilder = new StringBuilder();
        for (String key : paramsMap.keySet()) {
            stringBuilder.append(key);
            stringBuilder.append("=");
            try {
                stringBuilder.append(URLEncoder.encode(paramsMap.get(key), ENCODE_TYPE));
            } catch (UnsupportedEncodingException e) {
                e.printStackTrace();
            }
            stringBuilder.append("&");
        }
        return stringBuilder.substring(0, stringBuilder.length() - 1);
    }
}

public class HttpEngine {

private final static String SERVER_URL = "http://uat.b.quancome.com/platform/api";

private final static String REQUEST_MOTHOD = "POST";

private final static String ENCODE_TYPE = "UTF-8";

private final static int TIME_OUT = 15000;

private static HttpEngine instance = null;

private HttpEngine() {

}

public static HttpEngine getInstance() {

if (instance == null) {

instance = new HttpEngine();

}

return instance;

}

public T> T postHandle(MapString, String> paramsMap, Type typeOfT) throws IOException {

String data = joinParams(paramsMap);

HttpUrlConnection connection = getConnection();

connection.setRequestProperty("Content-Length", String.valueOf(data.getBytes().length));

connection.connect();

OutputStream os = connection.getOutputStream();

os.write(data.getBytes());

os.flush();

if (connection.getResponseCode() == 200) {

// 獲取響應的輸入流物件

InputStream is = connection.getInputStream();

// 建立位元組輸出流物件

ByteArrayOutputStream baos = new ByteArrayOutputStream();

// 定義讀取的長度

int len = 0;

// 定義緩衝區

byte buffer[] = new byte[1024];

// 按照緩衝區的大小，迴圈讀取

while ((len = is.read(buffer)) != -1) {

// 根據讀取的長度寫入到os物件中

baos.write(buffer, 0, len);

}

// 釋放資源

is.close();

baos.close();

connection.disconnect();

// 返回字串

final String result = new String(baos.toByteArray());

Gson gson = new Gson();

return gson.fromJson(result, typeOfT);

} else {

connection.disconnect();

return null;

}

private HttpURLConnection getConnection() {

HttpURLConnection connection = null;

// 初始化connection

try {

// 根據地址建立URL物件

URL url = new URL(SERVER_URL);

// 根據URL物件開啟連結

connection = (HttpURLConnection) url.openConnection();

// 設定請求的方式

connection.setRequestMethod(REQUEST_MOTHOD);

// 傳送POST請求必須設定允許輸入，預設為true

connection.setDoInput(true);

// 傳送POST請求必須設定允許輸出

connection.setDoOutput(true);

// 設定不使用快取

connection.setUseCaches(false);

// 設定請求的超時時間

connection.setReadTimeout(TIME_OUT);

connection.setConnectTimeout(TIME_OUT);

connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");

connection.setRequestProperty("Connection", "keep-alive");

connection.setRequestProperty("Response-Type", "json");

connection.setChunkedStreamingMode(0);

} catch (IOException e) {

e.printStackTrace();

}

return connection;

}

private String joinParams(MapString, String> paramsMap) {

StringBuilder stringBuilder = new StringBuilder();

for (String key : paramsMap.keySet()) {

stringBuilder.append(key);

stringBuilder.append("=");

try {

stringBuilder.append(URLEncoder.encode(paramsMap.get(key), ENCODE_TYPE));

} catch (UnsupportedEncodingException e) {

e.printStackTrace();

}

stringBuilder.append("&");

}

return stringBuilder.substring(0, stringBuilder.length() - 1);

}

至此，介面層的封裝就完成了。接下來再往上看看核心層吧。

核心層的邏輯

核心層處於介面層和介面層之間，向下呼叫Api，向上提供Action，它的核心任務就是處理複雜的業務邏輯。先看看我對Action的定義：

public interface AppAction {
    // 傳送手機驗證碼
    public void sendSmsCode(String phoneNum, ActionCallbackListenerVoid> listener);
    // 註冊
    public void register(String phoneNum, String code, String password, ActionCallbackListenerVoid> listener);
    // 登入
    public void login(String loginName, String password, ActionCallbackListenerVoid> listener);
    // 按分頁獲取券列表
    public void listCoupon(int currentPage, ActionCallbackListenerListCouponBO>> listener);
}

public interface AppAction {

// 傳送手機驗證碼

public void sendSmsCode(String phoneNum, ActionCallbackListenerVoid> listener);

// 註冊

public void register(String phoneNum, String code, String password, ActionCallbackListenerVoid> listener);

// 登入

public void login(String loginName, String password, ActionCallbackListenerVoid> listener);

// 按分頁獲取券列表

public void listCoupon(int currentPage, ActionCallbackListenerListCouponBO>> listener);

}

首先，和Api介面對比就會發現，引數並不一致。登入並沒有iemi和loginOS的引數，獲取券列表的引數裡也少了pageSize。這是因為，這幾個引數，跟介面其實並沒有直接關係。Action只要定義好跟介面相關的就可以了，其他需要的引數，在具體實現時再去獲取。
另外，大部分action的處理都是非同步的，因此，新增了回撥監聽器ActionCallbackListener，回撥監聽器的泛型則是返回的物件資料型別，例如獲取券列表，返回的資料型別就是List，沒有物件資料時則為Void。回撥監聽器只定義了成功和失敗的方法，如下：

public interface ActionCallbackListenerT> {
    /**
     * 成功時呼叫
     *
     * @param data 返回的資料
     */
    public void onSuccess(T data);

    /**
     * 失敗時呼叫
     *
     * @param errorEvemt 錯誤碼
     * @param message    錯誤資訊
     */
    public void onFailure(String errorEvent, String message);
}

public interface ActionCallbackListenerT> {

/**

* 成功時呼叫

* @param data 返回的資料

public void onSuccess(T data);

/**

* 失敗時呼叫

* @param errorEvemt 錯誤碼

* @param message 錯誤資訊

public void onFailure(String errorEvent, String message);

}

接下來再看看Action的實現。首先，要獲取imei，那就需要傳入一個Context；另外，還需要loginOS和pageSize，這定義為常量就可以了；還有，要呼叫介面層，所以還需要Api例項。而介面的實現分為兩步，第一步做引數檢查，第二步用非同步任務呼叫Api。具體實現如下：

public class AppActionImpl implements AppAction {
    private final static int LOGIN_OS = 1; // 表示Android
    private final static int PAGE_SIZE = 20; // 預設每頁20條

    private Context context;
    private Api api;

    public AppActionImpl(Context context) {
        this.context = context;
        this.api = new ApiImpl();
    }

    @Override
    public void sendSmsCode(final String phoneNum, final ActionCallbackListenerVoid> listener) {
        // 引數為空檢查
        if (TextUtils.isEmpty(phoneNum)) {
            if (listener != null) {
                listener.onFailure(ErrorEvent.PARAM_NULL, "手機號為空");
            }
            return;
        }
        // 引數合法性檢查
        Pattern pattern = Pattern.compile("1\d{10}");
        Matcher matcher = pattern.matcher(phoneNum);
        if (!matcher.matches()) {
            if (listener != null) {
                listener.onFailure(ErrorEvent.PARAM_ILLEGAL, "手機號不正確");
            }
            return;
        }

        // 請求Api
        new AsyncTaskVoid, Void, ApiResponseVoid>>() {
            @Override
            protected ApiResponseVoid> doInBackground(Void... voids) {
                return api.sendSmsCode4Register(phoneNum);
            }

            @Override
            protected void onPostExecute(ApiResponseVoid> response) {
                if (listener != null & response != null) {
                    if (response.isSuccess()) {
                        listener.onSuccess(null);
                    } else {
                        listener.onFailure(response.getEvent(), response.getMsg());
                    }
                }
            }
        }.execute();
    }

    @Override
    public void register(final String phoneNum, final String code, final String password, final ActionCallbackListenerVoid> listener) {
        // 引數為空檢查
        if (TextUtils.isEmpty(phoneNum)) {
            if (listener != null) {
                listener.onFailure(ErrorEvent.PARAM_NULL, "手機號為空");
            }
            return;
        }
        if (TextUtils.isEmpty(code)) {
            if (listener != null) {
                listener.onFailure(ErrorEvent.PARAM_NULL, "驗證碼為空");
            }
            return;
        }
        if (TextUtils.isEmpty(password)) {
            if (listener != null) {
                listener.onFailure(ErrorEvent.PARAM_NULL, "密碼為空");
            }
            return;
        }

        // 引數合法性檢查
        Pattern pattern = Pattern.compile("1\d{10}");
        Matcher matcher = pattern.matcher(phoneNum);
        if (!matcher.matches()) {
            if (listener != null) {
                listener.onFailure(ErrorEvent.PARAM_ILLEGAL, "手機號不正確");
            }
            return;
        }

        // TODO 長度檢查，密碼有效性檢查等

        // 請求Api
        new AsyncTaskVoid, Void, ApiResponseVoid>>() {
            @Override
            protected ApiResponseVoid> doInBackground(Void... voids) {
                return api.registerByPhone(phoneNum, code, password);
            }

            @Override
            protected void onPostExecute(ApiResponseVoid> response) {
                if (listener != null & response != null) {
                    if (response.isSuccess()) {
                        listener.onSuccess(null);
                    } else {
                        listener.onFailure(response.getEvent(), response.getMsg());
                    }
                }
            }
        }.execute();
    }

    @Override
    public void login(final String loginName, final String password, final ActionCallbackListenerVoid> listener) {
        // 引數為空檢查
        if (TextUtils.isEmpty(loginName)) {
            if (listener != null) {
                listener.onFailure(ErrorEvent.PARAM_NULL, "登入名為空");
            }
            return;
        }
        if (TextUtils.isEmpty(password)) {
            if (listener != null) {
                listener.onFailure(ErrorEvent.PARAM_NULL, "密碼為空");
            }
            return;
        }

        // TODO 長度檢查，密碼有效性檢查等        

        // 請求Api
        new AsyncTaskVoid, Void, ApiResponseVoid>>() {
            @Override
            protected ApiResponseVoid> doInBackground(Void... voids) {
                TelephonyManager telephonyManager = (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE);
                String imei = telephonyManager.getDeviceId();
                return api.loginByApp(loginName, password, imei, LOGIN_OS);
            }

            @Override
            protected void onPostExecute(ApiResponseVoid> response) {
                if (listener != null & response != null) {
                    if (response.isSuccess()) {
                        listener.onSuccess(null);
                    } else {
                        listener.onFailure(response.getEvent(), response.getMsg());
                    }
                }
            }
        }.execute();
    }

    @Override
    public void listCoupon(final int currentPage, final ActionCallbackListenerListCouponBO>> listener) {
        // 引數檢查
        if (currentPage  0) {
            if (listener != null) {
                listener.onFailure(ErrorEvent.PARAM_ILLEGAL, "當前頁數小於零");
            }
        }

        // TODO 新增快取

        // 請求Api
        new AsyncTaskVoid, Void, ApiResponseListCouponBO>>>() {
            @Override
            protected ApiResponseListCouponBO>> doInBackground(Void... voids) {
                return api.listNewCoupon(currentPage, PAGE_SIZE);
            }

            @Override
            protected void onPostExecute(ApiResponseListCouponBO>> response) {
                if (listener != null & response != null) {
                    if (response.isSuccess()) {
                        listener.onSuccess(response.getObjList());
                    } else {
                        listener.onFailure(response.getEvent(), response.getMsg());
                    }
                }
            }
        }.execute();
    }
}

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

public class AppActionImpl implements AppAction {

private final static int LOGIN_OS = 1; // 表示Android

private final static int PAGE_SIZE = 20; // 預設每頁20條

private Context context;

private Api api;

public AppActionImpl(Context context) {

this.context = context;

this.api = new ApiImpl();

}

@Override

public void sendSmsCode(final String phoneNum, final ActionCallbackListenerVoid> listener) {

// 引數為空檢查

if (TextUtils.isEmpty(phoneNum)) {

if (listener != null) {

listener.onFailure(ErrorEvent.PARAM_NULL, "手機號為空");

}

return;

}

// 引數合法性檢查

Pattern pattern = Pattern.compile("1\d{10}");

Matcher matcher = pattern.matcher(phoneNum);

if (!matcher.matches()) {

if (listener != null) {

listener.onFailure(ErrorEvent.PARAM_ILLEGAL, "手機號不正確");

}

return;

}

// 請求Api

new AsyncTaskVoid, Void, ApiResponseVoid>>() {

@Override

protected ApiResponseVoid> doInBackground(Void... voids) {

return api.sendSmsCode4Register(phoneNum);

}

@Override

protected void onPostExecute(ApiResponseVoid> response) {

if (listener != null & response != null) {

if (response.isSuccess()) {

listener.onSuccess(null);

} else {

listener.onFailure(response.getEvent(), response.getMsg());

}

}.execute();

}

@Override

public void register(final String phoneNum, final String code, final String password, final ActionCallbackListenerVoid> listener) {

// 引數為空檢查

if (TextUtils.isEmpty(phoneNum)) {

if (listener != null) {

listener.onFailure(ErrorEvent.PARAM_NULL, "手機號為空");

}

return;

}

if (TextUtils.isEmpty(code)) {

if (listener != null) {

listener.onFailure(ErrorEvent.PARAM_NULL, "驗證碼為空");

}

return;

}

if (TextUtils.isEmpty(password)) {

if (listener != null) {

listener.onFailure(ErrorEvent.PARAM_NULL, "密碼為空");

}

return;

}

// 引數合法性檢查

Pattern pattern = Pattern.compile("1\d{10}");

Matcher matcher = pattern.matcher(phoneNum);

if (!matcher.matches()) {

if (listener != null) {

listener.onFailure(ErrorEvent.PARAM_ILLEGAL, "手機號不正確");

}

return;

}

// TODO 長度檢查，密碼有效性檢查等

// 請求Api

new AsyncTaskVoid, Void, ApiResponseVoid>>() {

@Override

protected ApiResponseVoid> doInBackground(Void... voids) {

return api.registerByPhone(phoneNum, code, password);

}

@Override

protected void onPostExecute(ApiResponseVoid> response) {

if (listener != null & response != null) {

if (response.isSuccess()) {

listener.onSuccess(null);

} else {

listener.onFailure(response.getEvent(), response.getMsg());

}

}.execute();

}

@Override

public void login(final String loginName, final String password, final ActionCallbackListenerVoid> listener) {

// 引數為空檢查

if (TextUtils.isEmpty(loginName)) {

if (listener != null) {

listener.onFailure(ErrorEvent.PARAM_NULL, "登入名為空");

}

return;

}

if (TextUtils.isEmpty(password)) {

if (listener != null) {

listener.onFailure(ErrorEvent.PARAM_NULL, "密碼為空");

}

return;

}

// TODO 長度檢查，密碼有效性檢查等

// 請求Api

new AsyncTaskVoid, Void, ApiResponseVoid>>() {

@Override

protected ApiResponseVoid> doInBackground(Void... voids) {

TelephonyManager telephonyManager = (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE);

String imei = telephonyManager.getDeviceId();

return api.loginByApp(loginName, password, imei, LOGIN_OS);

}

@Override

protected void onPostExecute(ApiResponseVoid> response) {

if (listener != null & response != null) {

if (response.isSuccess()) {

listener.onSuccess(null);

} else {

listener.onFailure(response.getEvent(), response.getMsg());

}

}.execute();

}

@Override

public void listCoupon(final int currentPage, final ActionCallbackListenerListCouponBO>> listener) {

// 引數檢查

if (currentPage 0) {

if (listener != null) {

listener.onFailure(ErrorEvent.PARAM_ILLEGAL, "當前頁數小於零");

}

// TODO 新增快取

// 請求Api

new AsyncTaskVoid, Void, ApiResponseListCouponBO>>>() {

@Override

protected ApiResponseListCouponBO>> doInBackground(Void... voids) {

return api.listNewCoupon(currentPage, PAGE_SIZE);

}

@Override

protected void onPostExecute(ApiResponseListCouponBO>> response) {

if (listener != null & response != null) {

if (response.isSuccess()) {

listener.onSuccess(response.getObjList());

} else {

listener.onFailure(response.getEvent(), response.getMsg());

}

}.execute();

}

簡單的實現程式碼就是這樣，其實，這還有很多地方可以優化，比如，將引數為空的檢查、手機號有效性的檢查、數字型範圍的檢查等等，都可以抽成獨立的方法，從而減少重複程式碼的編寫。非同步任務裡的程式碼也一樣，都是可以通過重構優化的。另外，需要擴充套件時，比如新增快取，那就在呼叫Api之前處理。
核心層的邏輯就是這樣了。最後就到介面層了。

介面層

在這個Demo裡，只有三個頁面：登入頁、註冊頁、券列表頁。在這裡，也會遵循介面篇提到的三個基本原則：規範性、單一性、簡潔性。
首先，介面層需要呼叫核心層的Action，而這會在整個應用級別都用到，因此，Action的例項最好放在Application裡。程式碼如下：

public class KApplication extends Application {

    private AppAction appAction;

    @Override
    public void onCreate() {
        super.onCreate();
        appAction = new AppActionImpl(this);
    }

    public AppAction getAppAction() {
        return appAction;
    }
}

public class KApplication extends Application {

private AppAction appAction;

@Override

public void onCreate() {

super.onCreate();

appAction = new AppActionImpl(this);

}

public AppAction getAppAction() {

return appAction;

}

另外，一個Activity的基類也是很有必要的，可以減少很多重複的工作。基類的程式碼如下：

public abstract class KBaseActivity extends FragmentActivity {
    // 上下文例項
    public Context context;
    // 應用全域性的例項
    public KApplication application;
    // 核心層的Action例項
    public AppAction appAction;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        context = getApplicationContext();
        application = (KApplication) this.getApplication();
        appAction = application.getAppAction();
    }
}

public abstract class KBaseActivity extends FragmentActivity {

// 上下文例項

public Context context;

// 應用全域性的例項

public KApplication application;

// 核心層的Action例項

public AppAction appAction;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

context = getApplicationContext();

application = (KApplication) this.getApplication();

appAction = application.getAppAction();

}

再看看登入的Activity：

public class LoginActivity extends KBaseActivity {

    private EditText phoneEdit;
    private EditText passwordEdit;
    private Button loginBtn;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_login);
        // 初始化View
        initViews();
    }

    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        getMenuInflater().inflate(R.menu.menu_login, menu);
        return true;
    }

    @Override
    public boolean onOptionsItemSelected(MenuItem item) {
        int id = item.getItemId();

        // 如果是註冊按鈕
        if (id == R.id.action_register) {
            Intent intent = new Intent(this, RegisterActivity.class);
            startActivity(intent);
            return true;
        }

        return super.onOptionsItemSelected(item);
    }

    // 初始化View
    private void initViews() {
        phoneEdit = (EditText) findViewById(R.id.edit_phone);
        passwordEdit = (EditText) findViewById(R.id.edit_password);
        loginBtn = (Button) findViewById(R.id.btn_login);
    }

    // 準備登入
    public void toLogin(View view) {
        String loginName = phoneEdit.getText().toString();
        String password = passwordEdit.getText().toString();
        loginBtn.setEnabled(false);
        this.appAction.login(loginName, password, new ActionCallbackListenerVoid>() {
            @Override
            public void onSuccess(Void data) {
                Toast.makeText(context, R.string.toast_login_success, Toast.LENGTH_SHORT).show();
                Intent intent = new Intent(context, CouponListActivity.class);
                startActivity(intent);
                finish();
            }

            @Override
            public void onFailure(String errorEvent, String message) {
                Toast.makeText(context, message, Toast.LENGTH_SHORT).show();
                loginBtn.setEnabled(true);
            }
        });
    }
}

public class LoginActivity extends KBaseActivity {

private EditText phoneEdit;

private EditText passwordEdit;

private Button loginBtn;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_login);

// 初始化View

initViews();

}

@Override

public boolean onCreateOptionsMenu(Menu menu) {

getMenuInflater().inflate(R.menu.menu_login, menu);

return true;

}

@Override

public boolean onOptionsItemSelected(MenuItem item) {

int id = item.getItemId();

// 如果是註冊按鈕

if (id == R.id.action_register) {

Intent intent = new Intent(this, RegisterActivity.class);

startActivity(intent);

return true;

}

return super.onOptionsItemSelected(item);

}

// 初始化View

private void initViews() {

phoneEdit = (EditText) findViewById(R.id.edit_phone);

passwordEdit = (EditText) findViewById(R.id.edit_password);

loginBtn = (Button) findViewById(R.id.btn_login);

}

// 準備登入

public void toLogin(View view) {

String loginName = phoneEdit.getText().toString();

String password = passwordEdit.getText().toString();

loginBtn.setEnabled(false);

this.appAction.login(loginName, password, new ActionCallbackListenerVoid>() {

@Override

public void onSuccess(Void data) {

Toast.makeText(context, R.string.toast_login_success, Toast.LENGTH_SHORT).show();

Intent intent = new Intent(context, CouponListActivity.class);

startActivity(intent);

finish();

}

@Override

public void onFailure(String errorEvent, String message) {

Toast.makeText(context, message, Toast.LENGTH_SHORT).show();

loginBtn.setEnabled(true);

}

});

}

登入頁的佈局檔案則如下：

LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    tools:context="com.keegan.kandroid.activity.LoginActivity">

    EditText
        android:id="@+id/edit_phone"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="@dimen/edit_vertical_margin"
        android:layout_marginBottom="@dimen/edit_vertical_margin"
        android:hint="@string/hint_phone"
        android:inputType="phone"
        android:singleLine="true" />

    EditText
        android:id="@+id/edit_password"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="@dimen/edit_vertical_margin"
        android:layout_marginBottom="@dimen/edit_vertical_margin"
        android:hint="@string/hint_password"
        android:inputType="textPassword"
        android:singleLine="true" />

    Button
        android:id="@+id/btn_login"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="@dimen/btn_vertical_margin"
        android:layout_marginBottom="@dimen/btn_vertical_margin"
        android:onClick="toLogin"
        android:text="@string/btn_login" />

LinearLayout>

LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"

xmlns:tools="http://schemas.android.com/tools"

android:layout_width="match_parent"

android:layout_height="match_parent"

android:orientation="vertical"

android:paddingBottom="@dimen/activity_vertical_margin"

android:paddingLeft="@dimen/activity_horizontal_margin"

android:paddingRight="@dimen/activity_horizontal_margin"

android:paddingTop="@dimen/activity_vertical_margin"

tools:context="com.keegan.kandroid.activity.LoginActivity">

EditText

android:id="@+id/edit_phone"

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:layout_marginTop="@dimen/edit_vertical_margin"

android:layout_marginBottom="@dimen/edit_vertical_margin"

android:hint="@string/hint_phone"

android:inputType="phone"

android:singleLine="true" />

EditText

android:id="@+id/edit_password"

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:layout_marginTop="@dimen/edit_vertical_margin"

android:layout_marginBottom="@dimen/edit_vertical_margin"

android:hint="@string/hint_password"

android:inputType="textPassword"

android:singleLine="true" />

Button

android:id="@+id/btn_login"

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:layout_marginTop="@dimen/btn_vertical_margin"

android:layout_marginBottom="@dimen/btn_vertical_margin"

android:onClick="toLogin"

android:text="@string/btn_login" />

LinearLayout>

可以看到，EditText的id命名統一以edit開頭，而在Activity裡的控制元件變數名則以Edit結尾。按鈕的onClick也統一用toXXX的方式命名，明確表明這是一個將要做的動作。還有，string，dimen也都統一在相應的資原始檔裡按照相應的規範去定義。
註冊頁和登陸頁差不多，這裡就不展示程式碼了。主要再看看券列表頁，因為用到了ListView，ListView需要新增介面卡。實際上，介面卡很多程式碼都是可以複用的，因此，我抽象了一個介面卡的基類，程式碼如下：

public abstract class KBaseAdapterT> extends BaseAdapter {

    protected Context context;
    protected LayoutInflater inflater;
    protected ListT> itemList = new ArrayListT>();

    public KBaseAdapter(Context context) {
        this.context = context;
        inflater = LayoutInflater.from(context);
    }

    /**
     * 判斷資料是否為空
     *
     * @return 為空返回true，不為空返回false
     */
    public boolean isEmpty() {
        return itemList.isEmpty();
    }

    /**
     * 在原有的資料上新增新資料
     *
     * @param itemList
     */
    public void addItems(ListT> itemList) {
        this.itemList.addAll(itemList);
        notifyDataSetChanged();
    }

    /**
     * 設定為新的資料，舊資料會被清空
     *
     * @param itemList
     */
    public void setItems(ListT> itemList) {
        this.itemList.clear();
        this.itemList = itemList;
        notifyDataSetChanged();
    }

    /**
     * 清空資料
     */
    public void clearItems() {
        itemList.clear();
        notifyDataSetChanged();
    }

    @Override
    public int getCount() {
        return itemList.size();
    }

    @Override
    public Object getItem(int i) {
        return itemList.get(i);
    }

    @Override
    public long getItemId(int i) {
        return i;
    }

    @Override
    abstract public View getView(int i, View view, ViewGroup viewGroup);
}

public abstract class KBaseAdapterT> extends BaseAdapter {

protected Context context;

protected LayoutInflater inflater;

protected ListT> itemList = new ArrayListT>();

public KBaseAdapter(Context context) {

this.context = context;

inflater = LayoutInflater.from(context);

}

/**

* 判斷資料是否為空

* @return 為空返回true，不為空返回false

public boolean isEmpty() {

return itemList.isEmpty();

}

/**

* 在原有的資料上新增新資料

* @param itemList

public void addItems(ListT> itemList) {

this.itemList.addAll(itemList);

notifyDataSetChanged();

}

/**

* 設定為新的資料，舊資料會被清空

* @param itemList

public void setItems(ListT> itemList) {

this.itemList.clear();

this.itemList = itemList;

notifyDataSetChanged();

}

/**

* 清空資料

public void clearItems() {

itemList.clear();

notifyDataSetChanged();

}

@Override

public int getCount() {

return itemList.size();

}

@Override

public Object getItem(int i) {

return itemList.get(i);

}

@Override

public long getItemId(int i) {

return i;

}

@Override

abstract public View getView(int i, View view, ViewGroup viewGroup);

}

這個抽象基類整合了設定資料的方法，每個具體的介面卡類只要再實現各自的getView方法就可以了。本Demo的券列表的介面卡如下：

public class CouponListAdapter extends KBaseAdapterCouponBO> {

    public CouponListAdapter(Context context) {
        super(context);
    }

    @Override
    public View getView(int i, View view, ViewGroup viewGroup) {
        ViewHolder holder;
        if (view == null) {
            view = inflater.inflate(R.layout.item_list_coupon, viewGroup, false);
            holder = new ViewHolder();
            holder.titleText = (TextView) view.findViewById(R.id.text_item_title);
            holder.infoText = (TextView) view.findViewById(R.id.text_item_info);
            holder.priceText = (TextView) view.findViewById(R.id.text_item_price);
            view.setTag(holder);
        } else {
            holder = (ViewHolder) view.getTag();
        }

        CouponBO coupon = itemList.get(i);
        holder.titleText.setText(coupon.getName());
        holder.infoText.setText(coupon.getIntroduce());
        SpannableString priceString;
        // 根據不同的券型別展示不同的價格顯示方式
        switch (coupon.getModelType()) {
            default:
            case CouponBO.TYPE_CASH:
                priceString = CouponPriceUtil.getCashPrice(context, coupon.getFaceValue(), coupon.getEstimateAmount());
                break;
            case CouponBO.TYPE_DEBIT:
                priceString = CouponPriceUtil.getVoucherPrice(context, coupon.getDebitAmount(), coupon.getMiniAmount());
                break;
            case CouponBO.TYPE_DISCOUNT:
                priceString = CouponPriceUtil.getDiscountPrice(context, coupon.getDiscount(), coupon.getMiniAmount());
                break;
        }
        holder.priceText.setText(priceString);

        return view;
    }

    static class ViewHolder {
        TextView titleText;
        TextView infoText;
        TextView priceText;
    }

}

public class CouponListAdapter extends KBaseAdapterCouponBO> {

public CouponListAdapter(Context context) {

super(context);

}

@Override

public View getView(int i, View view, ViewGroup viewGroup) {

ViewHolder holder;

if (view == null) {

view = inflater.inflate(R.layout.item_list_coupon, viewGroup, false);

holder = new ViewHolder();

holder.titleText = (TextView) view.findViewById(R.id.text_item_title);

holder.infoText = (TextView) view.findViewById(R.id.text_item_info);

holder.priceText = (TextView) view.findViewById(R.id.text_item_price);

view.setTag(holder);

} else {

holder = (ViewHolder) view.getTag();

}

CouponBO coupon = itemList.get(i);

holder.titleText.setText(coupon.getName());

holder.infoText.setText(coupon.getIntroduce());

SpannableString priceString;

// 根據不同的券型別展示不同的價格顯示方式

switch (coupon.getModelType()) {

default:

case CouponBO.TYPE_CASH:

priceString = CouponPriceUtil.getCashPrice(context, coupon.getFaceValue(), coupon.getEstimateAmount());

break;

case CouponBO.TYPE_DEBIT:

priceString = CouponPriceUtil.getVoucherPrice(context, coupon.getDebitAmount(), coupon.getMiniAmount());

break;

case CouponBO.TYPE_DISCOUNT:

priceString = CouponPriceUtil.getDiscountPrice(context, coupon.getDiscount(), coupon.getMiniAmount());

break;

}

holder.priceText.setText(priceString);

return view;

}

static class ViewHolder {

TextView titleText;

TextView infoText;

TextView priceText;

}

而券列表的Activity簡單實現如下：

public class CouponListActivity extends KBaseActivity implements SwipeRefreshLayout.OnRefreshListener {
    private SwipeRefreshLayout swipeRefreshLayout;
    private ListView listView;
    private CouponListAdapter listAdapter;
    private int currentPage = 1;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_coupon_list);

        initViews();
        getData();

        // TODO 新增上拉載入更多的功能
    }

    private void initViews() {
        swipeRefreshLayout = (SwipeRefreshLayout) findViewById(R.id.swipe_refresh_layout);
        swipeRefreshLayout.setOnRefreshListener(this);
        listView = (ListView) findViewById(R.id.list_view);
        listAdapter = new CouponListAdapter(this);
        listView.setAdapter(listAdapter);
    }

    private void getData() {
        this.appAction.listCoupon(currentPage, new ActionCallbackListenerListCouponBO>>() {
            @Override
            public void onSuccess(ListCouponBO> data) {
                if (!data.isEmpty()) {
                    if (currentPage == 1) { // 第一頁
                        listAdapter.setItems(data);
                    } else { // 分頁資料
                        listAdapter.addItems(data);
                    }
                }
                swipeRefreshLayout.setRefreshing(false);
            }

            @Override
            public void onFailure(String errorEvent, String message) {
                Toast.makeText(context, message, Toast.LENGTH_SHORT).show();
                swipeRefreshLayout.setRefreshing(false);
            }
        });
    }

    @Override
    public void onRefresh() {
        // 需要重置當前頁為第一頁，並且清掉資料
        currentPage = 1;
        listAdapter.clearItems();
        getData();
    }
}

public class CouponListActivity extends KBaseActivity implements SwipeRefreshLayout.OnRefreshListener {

private SwipeRefreshLayout swipeRefreshLayout;

private ListView listView;

private CouponListAdapter listAdapter;

private int currentPage = 1;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_coupon_list);

initViews();

getData();

// TODO 新增上拉載入更多的功能

}

private void initViews() {

swipeRefreshLayout = (SwipeRefreshLayout) findViewById(R.id.swipe_refresh_layout);

swipeRefreshLayout.setOnRefreshListener(this);

listView = (ListView) findViewById(R.id.list_view);

listAdapter = new CouponListAdapter(this);

listView.setAdapter(listAdapter);

}

private void getData() {

this.appAction.listCoupon(currentPage, new ActionCallbackListenerListCouponBO>>() {

@Override

public void onSuccess(ListCouponBO> data) {

if (!data.isEmpty()) {

if (currentPage == 1) { // 第一頁

listAdapter.setItems(data);

} else { // 分頁資料

listAdapter.addItems(data);

}

swipeRefreshLayout.setRefreshing(false);

}

@Override

public void onFailure(String errorEvent, String message) {

Toast.makeText(context, message, Toast.LENGTH_SHORT).show();

swipeRefreshLayout.setRefreshing(false);

}

});

}

@Override

public void onRefresh() {

// 需要重置當前頁為第一頁，並且清掉資料

currentPage = 1;

listAdapter.clearItems();

getData();

}

完結

終於寫完了，程式碼也終於放上了github，為了讓人更容易理解，因此很多都比較簡單，沒有再進行擴充套件。
github地址：https://github.com/keeganlee/kandroid

Android 專案重構之路：架構篇
2015-11-19
Android架構
Android 專案重構之路：介面篇
2015-11-19
Android
記某次專案的中期重構工作 - 實戰篇
2018-02-12
App專案實戰之路(三):原型篇
2019-03-04
APP原型
App專案實戰之路(四):UI篇
2016-09-03
APPUI
App專案實戰之路(二):API篇
2016-08-12
APPAPI
專案重構之路——Fresco非侵入式替換Glide
2017-06-25
IDE
前端之路: 用github的webhooks實現專案自動化構建
2019-02-21
前端GithubWebHook
重構 Rails 專案之最佳實踐
2013-03-06
AI
專案重構之架構
2017-12-13
架構
Android :“萬能” Activity 重構篇
2016-06-01
Android
我的Android重構之旅：架構篇
2018-05-31
Android架構
實戰 | 使用maven 輕鬆重構專案
2021-01-27
Maven
android開源專案【專案篇】
2014-07-11
Android
大型Android專案的工程化之路：編譯與構建
2017-12-07
Android編譯
對以前專案的重構
2007-12-14
【quickhybrid】Android端的專案實現
2019-02-21
UIAndroid
記一次專案重構
2020-08-10
重構一次外包專案
2017-07-07
專案重構之多Activity多Fragment
2017-12-13
Fragment
iOS專案重構週記（一）
2015-07-05
iOS
我的Android重構之旅：外掛化篇
2018-07-09
Android
得物複雜 C 端專案的重構實踐
2022-06-23
android開源專案【developer篇】
2014-07-11
AndroidDeveloper
SSM(十) 專案重構-網際網路專案的Maven結構
2017-03-03
SSMMaven
CA 雲架構的實現之路
2011-11-24
架構
Android專案架構搭建
2019-11-23
Android架構
Android 專案最新架構
2017-07-02
Android架構
從零開始的Android新專案（1）：架構搭建篇
2016-03-19
Android架構
專案重構之網路篇根據OkHttp封裝簡單的框架
2017-12-13
HTTP封裝框架
Android 專案實戰--手機衛士（實現splash）
2016-09-23
Android
一個重構眼中的“專案管理”
2014-06-19
專案管理
用Unity重現《空洞騎士》的苦痛之路（4）——特效篇
2019-04-15
Unity特效
Vue.js專案重構，輕鬆實現上拉載入滾動位置還原
2017-06-19
Vue.js
Android關機重啟實現
2014-09-19
Android
從零開始搭建架構實施Android專案
2016-01-12
架構Android
Android 架構演化之路
2015-10-31
Android架構
Android開源mvp專案,實現玩Android客戶端
2019-02-22
AndroidMVP客戶端

Android 專案重構之路：實現篇

專案搭建

建立業務物件模型

介面層的封裝

核心層的邏輯

介面層

完結

相關文章