apklug插件托管服务开发教程之按条件查询云端插件-01

注:本文是基于托管服务TuoCloudService1.0.0讲解的 项目地址为http://git.oschina.net/plug/ApkplugCloudServiceDemo

 

一，插件托管服务支持的功能

      v1.0.0支持的功能如下:

        注:它们都是以OSGI服务对外提供服务的,关于OSGI可百度查询,但同时我们提供模板代码，我们希望大家可以利用模板代码渐进式的学习  <apkplug中OSGI服务基本原理>

        1.插件托管:

            开发者可将宿主应用与插件上传到服务器上,并随意绑定宿主与插件的对应关系。

        2.客户端多条件查询: 

            OSGI服务名:"com.apkplug.service.SearchApp.appSearch"

            目前支持的插件查询条件有 插件名(appname) 设置的关键词(b_keywords) 可按插件添加日期排序

            注:插件必须与宿主绑定才可被查询到

        3.插件版本状态查询:

            OSGI服务名:com.apkplug.service.update.checkupdate

           可批量查询该宿主对应的插件版本状态

        4.插件文件下载:

            OSGI服务名:"com.apkplug.service.download.AppDownload"

            通过查询(2)或插件版本更新功能(3)可获取appBean，通过它可下载插件文件。

二，宿主应用集成插件托管服务

    1)插件托管服务是一个jar包我们只需要将其放置于宿主文件夹的libs目录中即可。如图

    

    2)将插件托管的OSGI服务注册到apkplug框架中

      详细代码在 com.apkplug.cloudservicedemo.ProxyApplication 类中  

try{
     //com.apkplug.appServiceManager 为TuoCloudService1.0.0.jar包提供的插件托管服务启动BundleActivator
     List activators=new java.util.ArrayList<BundleActivator>();
     //将服务加入框架，框架将在启动时启动这些服务
      activators.add(new appServiceManager());
     frame=FrameworkFactory.getInstance().start(activators,this,new MyProperty(this.getApplicationContext()));
    }catch (Exception ex){
     System.err.println("Could not create : " + ex);
     ex.printStackTrace();
     int nPid = android.os.Process.myPid();
     android.os.Process.killProcess(nPid);
}

三， 使用插件托管服务接口查询

    上一步我们将托管服务已经全部注册到apkplug框架里面了，所以当使用时只需要找到服务,如下为模板代码:

    注:代码位置  com.apkplug.cloudservicedemo.activity.SearchActivity

/**
* appSearch 插件搜索服务
* @param context  插件上下文
* @param bean     查询条件填充 bean
* @param callback 查询结果回调接口
*/
public void search(BundleContext context,appSearchBean bean,AppSearchCallBack callback){
    ServiceReference reference=context.getServiceReference(appSearch.class.getName());
    if(null!=reference){
    	appSearch service=(appSearch)context.getService(reference);
    	if(service!=null){
    		service.search(bean,callback);
    	}
    	context.ungetService(reference);
    }
 }

    以上有两个需要我们填充

    appSearchBean bean 是插件条件bean ，我们可以通过填充它来设置一些查询条件

    AppSearchCallBack callback 查询过程或结果将通过该接口返回

  

public void updataDate(BundleContext context){
    bean=new appSearchBean();
    //按插件被添加到分组(宿主)的时间逆序查询
     bean.setG_order(appSearchBean.order_desc);
    //插件的关键词keyword
    bean.setB_keywords("工具");
    bean.setPagenum(10);
    bean.setPage(0);
    //查询
     search(context,bean,new impAppSearchCallBack());
}

class impAppSearchCallBack implements AppSearchCallBack{
	public void onFailure(int arg0, final String arg1) {
		//服务查询失败
	}
	public void onSuccess(int stutas, CallBackMSG msg,appSearchBean arg2) {
		//服务查询成功
         		if(stutas>=0){
			if(msg.getStutes()>=0){
				//查询正确
				//获取查询到的插件
				List<appBean> aps=(List)msg.getMsg();
			}else{
				//查询条件异常
			}
		}else{
			//网络异常
		}
	}  
}

注:查询完成后返回的appSearchBean arg2可以获取到该条件下服务端插件总体数量以及当前返回页