应用程序中使用插件技术,有利于日后的版本更新、维护(比如打补丁)和功能扩展,是一种很实用的技术。其最大的特点是更新插件时无需重新编译主程序,对于一个设计良好的应用系统而言,甚至可以做到业务功能的在线升级。本文介绍了linux下用C++实现插件的一个简单实例,希望能对大家有所启发。
为了能做到更新插件时无需重新编译主程序,要求主程序中定义的接口是定死的,而接口的实现被放到了具体的插件中,这样主程序在运行时刻将插件加载进来,就可以使用这些接口所提供的功能了。在面向对象的系统中,各个功能模块被封装到类中,因此在C++中实现插件技术,就需要在主程序中提供基类,并为这些基类定义明确的接口,然后在插件(动态库或共享库)中定义派生类,并实现基类中所有的接口。
我们以计算多边形面积为例,首先定义一个基类CPolygon:
/* +******************************************************* */
/* +******************************************************* */
/* polygon.h */
#ifndef __POLYGON_H__
#define __POLYGON_H__
#include < iostream >
class CPolygon
{
public :
CPolygon() {}
virtual ~ CPolygon() {}
virtual double area( void ) const = 0 ;
} ;
#endif /* __POLYGON_H__ */
/* -******************************************************* */
/* -******************************************************* */
/* -******************************************************* */
注意基类不一定是虚类(有纯虚函数的类),但是接口一定要定义成虚函数,因为最终主程序是通过基类指针
来调派生类的接口函数,另外如果基类中有资源分配(new)的话,析构函数一定要定义成虚的,否则不会被
调用,造成内存泄漏。
接下来要定义派生类,并放到共享库(triangle.so)中:
/* +******************************************************* */
/* +******************************************************* */
/* triangle.h */
#ifndef __TRIANGLE_H__
#define __TRIANGLE_H__
#include " polygon.h "
#include < iostream >
class CTriangle : public CPolygon
{
public :
virtual double area( void ) const ;
} ;
#endif /* __TRIANGLE_H__ */
/* triangle.cpp */
#include " triangle.h "
extern " C "
{
void * create()
{
return new CTriangle;
}
}
double CTriangle::area( void ) const
{
std::cout << " area of triangle " << std::endl;
return 0 ;
}
/* -******************************************************* */
/* -******************************************************* */
/* -******************************************************* */
其中定义了函数“create”用来创建CTriangle类对象,该函数可让主程序获得CTriangle对象指针,从而
可以访问CTriangle类对象。主程序通过调用dlsym获取指向该函数的指针,需要指出的是,由于dlsym被
设计成c-style方式,因此调用c++定义的函数时,需要加上extern "C"
那么主程序是如何调用共享库的呢,代码片段如下:
/* +******************************************************* */
/* +******************************************************* */
typedef CPolygon * create_t();
void * handle = dlopen( " triangle.so " , RTLD_LAZY);
if ( ! handle )
{
std::cerr << dlerror() << std::endl;
exit( 1 );
}
create_t * create_triangle = (create_t * )dlsym(handle, " create " );
CPolygon * pObj = create_triangle();
if ( 0 != pObj )
{
pObj -> area();
}
delete pObj;
dlclose(handle);
/* -******************************************************* */
/* -******************************************************* */
/* -******************************************************* */
主程序通过dlopen打开triangle.so,然后通过dlsym得到库中的函数create指针,调用create后返回了
指向CTriangle类对象的指针,类型是CPolygon的,由于虚函数的多态性, pObj->area() 实际是调用
了CTriangle::area.
好了,插件技术就是这么简单,回顾一下实现过程:写一个基类,定义接口函数,然后在共享库中写
派生类,最后在主程序运行时刻打开共享库(dlopen),并通过create函数得到指向新创建的派生类
对象的指针,然后利用虚函数的多态性,调用派生类的各种方法。
不过进一步使用后你可能会发现,这样实现会有些问题:
1. 每写一个派生类就需要重写一个create函数
注意到CTriangle类实现时定义的create函数必须返回 new CTriangle:
{
void * create()
{
return new CTriangle;
}
}
那么如果再建一个类比如CRectangle, create函数必须重写,返回 new CRectangle
这样做一方面麻烦,另外CTriangle、CRectangle两个类不能放到同一个共享库中,否则会编译时刻
提示重复定义错误。
2. 主程序无法判断create函数返回的是哪个类所创建的对象
当只有一个基类(CPolygon)时主程序当然知道返回的是CPolygon派生类的对象指针:
create_t * create_triangle = (create_t *)dlsym(handle, "create");
CPolygon * pObj = create_triangle();
假如有多个基类,根据这些基类派生出不同类型的类时,无法在主程序中判断返回的是那个类的对象。
3. 操作繁琐
没有一个统一的操作界面,实现共享库的加载、卸载、派生类对象的创建,特别是当需要加载一个目录
下所有的共享库时,感觉一个一个地加载太麻烦了,能不能批量加载呢。
通过动态类加载和建立Helper类可以很好地解决上述问题,其中dynclass.h/dynclass.cpp中实现了动态
加载类对象,pluginhelper.h/pluginhelper.cpp实现了Plugin Helper,具体细节见附件。
下面简单介绍一下使用步骤:
1. 首先定义基类(CPolygon),方法同上
2. 在共享库中实现派生类
比如CTriangle:
/* +******************************************************* */
/* +******************************************************* */
/* triangle.h */
#ifndef __TRIANGLE_H__
#define __TRIANGLE_H__
#include " polygon.h "
#include < iostream >
class CTriangle : public CPolygon
{
public :
virtual double area( void ) const ;
} ;
#endif /* __TRIANGLE_H__ */
/* triangle.cpp */
#include " triangle.h "
#include " dynclass.h "
DYN_DECLARE(CTriangle);
double CTriangle::area( void ) const
{
std::cout << " area of triangle " << std::endl;
return 0 ;
}
/* -******************************************************* */
/* -******************************************************* */
/* -******************************************************* */
注意到此时派生类的实现(triangle.cpp)中已没有了那个讨厌的create了,被我偷偷放到
dynclass.cpp中了:
{
void * createByClassName( const char * strClassName)
{
return DYN_CREATE(strClassName);
}
}
由于对任何派生类而言,该函数的实现都一样,因此只需要实现一次,对使用者是不可见的,达到
了从派生类中拿走的目的。
另外增加了一个宏:DYN_DECLARE(CTriangle); 参数是类名(这里用到了RTTI),每个派生类对应
一个这样的宏,该类就可以支持类对象的动态加载了,需要包含头文件dynclass.h
2. 在主程序中如何使用
使用起来也非常简单,在主程序(main.cpp)中:
/* +******************************************************* */
/* +******************************************************* */
#include " pluginhelper.h "
#include " polygon.h "
CPluginHelper pluginHelper;
pluginHelper.Load( " ./plugin " , " *.so " );
CPolygon * pbase = (CPolygon * )pluginHelper.Create( " CTriangle " );
if ( 0 != pbase )
{
pbase -> area();
}
delete pbase;
pluginHelper.Unload( " ./plugin " , " *.so " );
/* -******************************************************* */
/* -******************************************************* */
/* -******************************************************* */
首先定义CPluginHelper对象,调用Load方法加载共享库,其中第一个参数是共享库的路径,第二
个参数是共享库的名称,共享库名支持模式匹配,这里表示要加载./plugin目录所有so共享库,
当然也可以是某个具体的共享库名。
随后可以通过CPluginHelper::Create方法,根据类名称创建该类的对象,实现了参数化创建对象
的目的,然后就是对该对象的调用,当不用该对象时,需要调用delete来删除。
最后,调用CPluginHelper::Unload将指定共享库卸载。