移動web中間件phonegap三（插件編寫）

前言

   現在phonegap雖然提供了很多中插件API，但難免會不夠全，不夠滿足我們的需求！這時候我們就可以通過自己編寫插件來完善這些功能。

   phonegap的插件主要分兩部分：一部分是前臺頁面js調用插件的接口，還有一部分就是后臺做的處理。

下面我以我寫的一個刪除文件功能為例，先來看前臺js代碼：

removefile : function(path,cb){
    //定義插件刪除方法
    window.deletebook = function(path, callback) {
        //自定義插件的核心
        cordova.exec(callback, function(err) {
            callback('Nothing to echo.');
        }, "MyEcho", "deletebook", [path]);
    };
    //調用插件刪除方法
    document.addEventListener("deviceready", onDeviceReady, false);
    function onDeviceReady() {
        window.deletebook(path, function(echoValue) {
            //console.log(echoValue + " success");
            if(echoValue == "true"){
                cb();
            }
        });
    }
}

插件的核心在于cordova.exec(successCB，failedCB,pluginName,action,data);

這個函數中五個參數分別為：

successCB 調用成功后的回調函數

failedCB 調用失敗后的回調函數

pluginName 插件名

action 插件方法

data 調用插件向后臺傳遞的參數,格式為數組

接下來我們來看一下后臺的代碼：

package org.apache.cordova;
import org.apache.cordova.api.CallbackContext;
import org.apache.cordova.api.CordovaPlugin;
import org.join.messenger.MessageCode;
import org.json.JSONArray;
import org.json.JSONException;
import android.os.Bundle;
import com.lemote.ebook.Ebook;
public class MyEcho extends CordovaPlugin {
    @Override
    public boolean execute(String action, JSONArray args, CallbackContext callbackContext) throws JSONException {
        System.out.println("================action:"+action);
        if(action.equals("deletebook")){
            System.out.println("deletebook!");
            String filepath = args.getString(0);
            String returninfo = "false";
            String whole_filepath = "/mnt/sdcard/"+filepath;
            System.out.println("whole_filepath:"+whole_filepath);
            if(MyFileUtil.removeFile(whole_filepath)){
                System.out.println("刪除成功！");
                returninfo = "true";
            }
            this.echo(returninfo, callbackContext);
            return true;
        }
        return false;
    }
    //調用回調函數，返回成功
    private void echo(String message, CallbackContext callbackContext) {
        if (message != null && message.length() > 0) {
            callbackContext.success(message);
        } else {
            callbackContext.error("Expected one non-empty string argument.");
        }
    }
}

execute(String action, JSONArray args, CallbackContext callbackContext)中三個參數分別為：

   action 插件方法

   args 傳遞過來的參數，獲取方法為args.getString(數組中的位置);

callbackContext 回調函數

回調成功的函數callbackContext.success(message)

回調失敗的函數callbackContext.error(message)

除了前臺js接口和后臺方法，還有一個非常重要的就是串聯前后臺的東西：

在res/xml/config.xml中加入如下代碼：

<plugin name="MyEcho" value="org.apache.cordova.MyEcho" />

"MyEcho"為前臺js調用的pluginName

"org.apache.cordova.MyEcho"為插件在后臺的類文件

這樣phonegap插件還做不到的就可以通過自己編寫java代碼來實現了！