pluginloader:简化go语言plugin函数和对象调用

go语言的plugin调用还是很繁琐，而且功能限制也不少，我开发了的这个程序包含一个包github.com/rocket049/pluginloader和一个命令行工具github.com/rocket049/pluginloader/cmd/pluginwrap。

包github.com/rocket049/pluginloader引用到程序中，用于简化函数调用。

命令行工具pluginwrap用于从plugin的源代码生成可导出对象struct对应的interface和可导出func。

使用pluginloader

安装命令： go get github.com/rocket049/pluginloader

可调用的函数：

type PluginLoader struct {
    P *plugin.Plugin
}

///Call return type must be: (res,error)
func (p *PluginLoader) Call(funcName string, p0 ...interface{}) (interface{}, error)

//CallValue Allow any number of return values,return type: []reflect.Value,error
func (p *PluginLoader) CallValue(funcName string, p0 ...interface{}) ([]reflect.Value, error)

//MakeFunc point a func ptr to plugin
func (s *PluginLoader) MakeFunc(fptr interface{}, name string) error 

pluginloader导出method的具体说明

• Call，直接通过函数名调用对应的函数，但是返回值形式受到限制。
• CallValue，直接通过函数名调用对应的函数，返回值形式不受限制。
• MakeFunc，根据名字把预定义的函数类型变量指向插件中的函数。

调用示例

import "github.com/rocket049/pluginloader"

p, err := pluginloader.NewPluginLoader( "foo.so" )
if err != nil {
    panic(err)
}

res, err := p.Call("NameOfFunc", p0,p1,p3,...)
// ...

ret := p.CallValue("NameOfFunc", p0,p1,p3,...)
// ...

var Foo func(arg string)(string,error)
p.MakeFunc(&Foo,"Foo")
ret, err = Foo("something")
// ...

使用pluginwrap

安装命令： go get github.com/rocket049/pluginloader/cmd/pluginwrap

用法

pluginwrap path/to/plugin/foo

生成的文件名字：
fooWrap.go

把这个文件加入你的工程就可以方便的调用plugin的导出函数了。

功能

1. 生成导出对象的接口，以便用于类型断言。
2. 生成导出函数。

限制

本程序基于标准包plugin和reflect实现，因为go语言的变量类型转换的使用有很多限制，所以本程序对导出函数的参数类型、返回值类型都有限制， 仅限于导出参数、返回值都是builtin类型的函数。

如果导出函数的参数或返回值使用了其他复杂类型，请使用 pluginloader.Call 或 pluginloader.CallValue 调用。

示例

 // foo.so export funcs: func Hello(s string) /  func NewFoo()*Foo
    p, err := pluginloader.NewPluginLoader("foo.so")
    if err != nil {
        panic(err)
    }

    // MUST call InitxxxFuncs(p) before call funcs, xxx = plugin名字
    InitfooFuncs(p)

    // call Hello
    Hello("friend")

    // call NewFoo
    iface, err := p.Call("NewFoo")
    if err != nil {
        panic(err)
    }
    // convert return value to interface IFoo
    foo := iface.(IFoo)