IOT command （based on sip）client API设计 for java

我们实现的物联网设备控制是通过扩展sip协议来实现的。
由于是基于pjsip来实现的，而pjsip是使用C编程，如何使得业务层（android端，使用java）更容易使用提供的command API
是重点，原始的方法就是从底层C开始往上层层封装（c--->jni--->java），这样存在明显的缺陷：
1. 对于第三方开发开发难度大，工作量多，API设计不合理；
2. 不同的设备控制业务接入代码都需要集成到主程序iot_sip_cli，高耦合，这是不能接受的（特别对于第三方开发）。

所以倒过来考虑，利用IOC原则(don't call us, we'll call you)，让第三方开发直接在java层来实现，提供接口给第三方让其将实现注册到iot_sip_cli_jni层，最后jni层的调用被iot_sip_cli驱动。

举例： 接入一个叫test_plugin的设备类型， 它有两个方法test1, test5.

1. 第三方开发首先定义方法的响应处理：
public class TestPluginCallBack {
//以下两个方法最终被iot_sip_cli调用

};

2.第三方开发将上面的对象，方法传递给 sdk(由sdk内部的IOTCmdAttachment负责):



3. 第三方开发，写设备控制的请求发送：
att.inputCommand("test_plugin", "test1", reqJson, toUri); //响应结果retJson通过第一步的方法传到业务层。

这样，第三方开发只要通过上面3个步骤，就能完成对接入设备控制的实现。

过程原理如下图所示（提供给第三方的sdk由CMD_API_4JAVA jar包，和IOT_CMD_JNI so构成）：





主要步骤在于IOTCmdAttachment方法registerCmdHandlers的使用：
利用自定义的java注解CmdCBAnnotation, 识别出需要调用的函数，将其传给 jni_reg_cmdcb（它内部调用reg_handler）,

public int registerCmdHandlers(Object obj) {
int status = 0;
for (Method m : obj.getClass().getMethods()) {
CmdCBAnnotation a = m.getAnnotation(CmdCBAnnotation.class);
if (a != null) {
Log.d(LOG_TAG, "" + a.dev_type() + ":" + a.method_name());
status =  jni_reg_cmdcb(a.dev_type(), a.method_name(), obj, m);
if (0 != status)
return status;
}
}

return status;
}

static int reg_handler(jstring dev_type,  jstring method_name,  jobject jobj,
jobject jmeth)
{
__android_log_print(ANDROID_LOG_INFO, TAGSTR, "reg_handler");

JNIEnv *env = get_jni_env();
std::string str_devtype = jstring2str(env, dev_type);
std::string str_methname = jstring2str(env, method_name);

//生成DeviceCmdHandler对象，存储设备类型名，设备方法名（即上面注解@CmdCBAnnotation dev_type, method_name值）,
//TestPluginCallBack对象，和被注解的java方法
DeviceCmdHandler * pt_dchdl = new DeviceCmdHandler(str_devtype,
str_methname, jobj, jmeth);

//DeviceCmdHandler::methodCallBack4c会使用pt_dchdl作为参数，并且它作为回调函数将被iot_sip_cli调用
int ret = cmd_cb_reg4cpp(str_devtype.c_str(), str_methname.c_str(),
&DeviceCmdHandler::methodCallBack4c, pt_dchdl);
if (0 != ret)
{
__android_log_print(ANDROID_LOG_ERROR, TAGSTR, "reg_handler fail ret %d:%s %s", ret, str_devtype.c_str(),
str_methname.c_str());
}
else
{
__android_log_print(ANDROID_LOG_INFO, TAGSTR, "reg_handler succ:%s %s", str_devtype.c_str(), str_methname.c_str());
}
return ret;
}

　　

DeviceCmdHandler类如下：





int DeviceCmdHandler::methodCallBack4c(int ret_i, const char * ret_json,
void * pt_obj) {
return ((DeviceCmdHandler *) pt_obj)->methodCallBack(ret_i, ret_json);
}
而 DeviceCmdHandler::methodCallBack(int ret_i, const char * ret_json)方法，最终调用
CallObjectMethod(env, this->mJmethod, mid, jo, (jobjectArray) texts); 即调用java层的TestPluginCallBack两个注解的方法。

mid获取， 使用java.lang.reflect.Method:
JLocalRef<jclass> clazz = env->GetObjectClass(this->mJmethod);
jmethodID mid = env->GetMethodID(clazz, "invoke", "(Ljava/lang/Object;[Ljava/lang/Object;)Ljava/lang/Object;")