一、PBNI环境搭建及初步使用

时间:2024-09-11 18:36:38

  PowerBuilder Native Interface(PowerBuilder本机接口PBNI)允许将第3方程序转换为PowerBuilder对象,供PowerBuilder直接使用,也允许将PowerBuilder虚拟机嵌入到C++应用中。对于每个版本的PowerBuilder都需要编译对应版本的PBNI程序。

  下面讲解如何使用VS2013开发PB12.5版本PBNI组件环境搭配及简单PBNI应用实例:

  实现一个PBNI对象的函数of_hellopbni将参数传递进来,然后pbni函数返回,

  

//PowerBuilder代码
string ls_rtn
ls_rtn = pbni_obj.of_hellopbni("wxj")

  将wxj这个字符串原封不动的从of_hellopbni函数返回。

  1.   先不要启动VS2013,在系统属性中设置PB12.5的PBNI环境变量,系统属性->环境变量->新建(W)….,在编辑系统变量窗口中输入变量名称“PBNISDK125”(此名称可按自己爱好取),变量值为PB125.2PBNI安装目录,这里为“C:\Program Files (x86)\Sybase\PowerBuilder12.5\SDK\PBNI”(根据实际安装情况填写)
    一、PBNI环境搭建及初步使用
  2. 启动VS2013,菜单中选择“文件”->“新建”->“项目”,建立空白解决方案,如下图:
    一、PBNI环境搭建及初步使用
    单击确定。
  3. 建立一个VC++win32 dll项目:在解决方案资源管理器中的“解决方案PBNI”上右击弹出菜单选择“添加”->新建项目…,在弹出的添加新项目窗口中输入名称PBNIHello(名称可随意取)。
    一、PBNI环境搭建及初步使用
    点击确定,VS切换到win32应用程序向导,单击下步,在应用程序设置中将应用程序类型选择“dll”
    一、PBNI环境搭建及初步使用
    点击完成。在VS2013中,解决方案资源管理器中如下:
    一、PBNI环境搭建及初步使用
  4. 设置PBNI的Include和Lib路径:

    在解决方案资源管理器的PBNIHello项目上右击,弹出右键菜单选择属性,在配置属性的常规页中设置如下:配置选择所有配置,平台为win32,平台工具集为VS2013Visual studio2013 – windowsXP,字符集为UNICODE(若编译PB9的PBNI选择为使用多字节字符集)
    一、PBNI环境搭建及初步使用
    点击应用按钮。

    在C/C++的常规下的附加包含目录选择编译,弹出窗口中新增输入$(PBNISDK125)\include
    一、PBNI环境搭建及初步使用
    点击确定返回到PBNIHello属性页。
    一、PBNI环境搭建及初步使用
    点击应用按钮。

    在链接器的常规页的附加库目录选择编辑,弹出的窗口中新增输入$(PBNISDK125)\lib
    一、PBNI环境搭建及初步使用
    点击确定返回到PBNIHello属性页。一、PBNI环境搭建及初步使用点击应用按钮。

    在链接器的输入页的附加依赖项中选择编辑,在弹出窗口中新增输入pbni.lib一、PBNI环境搭建及初步使用点击确定返回到PBNIHello属性页,并在该属性页上点击确定。

  5. 打开头文件下的stdafx.h,在文件最后输入一行#include <PBEXT.H>
    一、PBNI环境搭建及初步使用
  6. 建立一个头文件PBNIHello.h:在解决方案资源管理器的头文件上右击弹出菜单选择“添加”“新建项目”弹出窗口中选择vc++头文件,名称为PBNIHello.h
    一、PBNI环境搭建及初步使用按添加返回,并在PBNIHello.cpp中输入#include "PBNIHello.h"
    一、PBNI环境搭建及初步使用
  7. 声明定义PBNIHello类:在头文件PBNIHello.h中声明PBNIHello类
     #pragma once
    
     class PBNIHello :
    public IPBX_NonVisualObject
    {
    private:
    IPB_Session * m_pSession;
    pbobject m_pbobject;
    public:
    PBNIHello(IPB_Session * pSession, pbobject obj)
    :m_pSession(pSession),
    m_pbobject(obj)
    {
    };
    ~PBNIHello(void){};
    PBXRESULT Invoke(IPB_Session * session, pbobject obj, pbmethodID mid, PBCallInfo * ci);
    void Destroy()
    {
    delete this;
    }
    enum Function_Entrys
    {
    mid_HelloPBNI=,
    NO_MORE_METHODS
    };
    protected:
    PBXRESULT HelloPBNI(PBCallInfo* ci);
    };

    在PBNIHello.cpp中实现PBNIHello类的Invoke和HelloPBNI方法:

     #include "stdafx.h"
    #include "PBNIHello.h" PBXRESULT PBNIHello::Invoke(IPB_Session * session, pbobject obj, pbmethodID mid, PBCallInfo * ci)
    {
    PBXRESULT pbxr = PBX_OK;
    switch (mid)
    {
    case mid_HelloPBNI:
    pbxr = HelloPBNI(ci);
    break;
    default:
    pbxr = PBX_E_INVOKE_METHOD_AMBIGUOUS;
    }
    return pbxr;
    }
    PBXRESULT PBNIHello::HelloPBNI(PBCallInfo * ci)
    {
    PBXRESULT pbxr = PBX_OK;
    LPCTSTR userName = m_pSession->GetString(ci->pArgs->GetAt()->GetString());
    ci->returnValue->SetString(userName);
    m_pSession->ReleaseString(userName);//PB9版本的PBNI没有此方法,编译时需要注释掉
    return pbxr;
    }
  8. 在dllmain.cpp中实现导出PBX_GetDescription、PBX_CreateNonVisualObject函数,以便生成PowerBuilder对象
     #include "stdafx.h"
    #include "PBNIHello.h"
    BOOL APIENTRY DllMain( HMODULE hModule,
    DWORD ul_reason_for_call,
    LPVOID lpReserved
    )
    {
    switch (ul_reason_for_call)
    {
    case DLL_PROCESS_ATTACH:
    case DLL_THREAD_ATTACH:
    case DLL_THREAD_DETACH:
    case DLL_PROCESS_DETACH:
    break;
    }
    return TRUE;
    }
    PBXEXPORT LPCTSTR PBXCALL PBX_GetDescription()
    {
    static const TCHAR classDesc[] = {
    _T("class n_pbnihello from nonvisualobject \n") \
    _T(" function string of_hellopbni(string username) \n") \
    _T("end class \n")
    };
    return (LPCTSTR)classDesc;
    }
    PBXEXPORT PBXRESULT PBXCALL PBX_CreateNonVisualObject(
    IPB_Session * session,
    pbobject obj,
    LPCTSTR className,
    IPBX_NonVisualObject ** nvobj
    )
    {
    if (_tcscmp(className, _T("n_pbnihello")) == )
    *nvobj = new PBNIHello(session, obj);
    return PBX_OK;
    }

    细心的你会发现

    _T("class n_pbnihello from nonvisualobject \n") \
      _T(" function string of_hellopbni(string username) \n") \
      _T("end class \n")
     这段代码很像PowerBuilder中非可视对象的代码。此字符串就是供PowerBuilder工具生成一个PowerBuilder非可视对象的壳。

  9. 选择解决方案配置为Debug,解决方案平台为win32
    一、PBNI环境搭建及初步使用
    在解决方案资源管理器中的PBNIHello项目上右击弹出选择生成,VS2013开始编译代码。如有错误请修改错误直到编译成功。
  10. 在编译成功后,在解决方案的根目录下的Debug文件夹中生成一个PBNIHello.dll文件
    一、PBNI环境搭建及初步使用
  11. 在这个Debug目录下用PB125建立一个PB测试应用
    一、PBNI环境搭建及初步使用
  12. 在PBNItest库上右击弹出菜单选择“Import PB Extension….”,选择PBNIHello.dll文件打开导入PBNI对象到PB开发环境中。
    一、PBNI环境搭建及初步使用
    导入成功后如图
    一、PBNI环境搭建及初步使用
  13. 创建窗体调试运行n_pbnihello.

一、PBNI环境搭建及初步使用

    如果你按照步骤成功操作到此处,那么恭喜你,你学会了PBNI。 部署PBNI对象时候,请选用Release选项编译。
      PBNI QQ交流群:119231276

本文代码

博客地址:http://www.cnblogs.com/wangxianjin/p/3994240.html