PowerBuilder 12.5实战：从零构建企业级C/S应用

1. 为什么现在还要学PowerBuilder？从“客户信息管理系统”说起

最近有朋友问我，现在都流行B/S架构、微服务、前后端分离了，为什么还要去折腾一个听起来有点“古老”的C/S开发工具——PowerBuilder 12.5？我的回答是：场景决定工具。在很多对数据一致性、操作响应速度、界面交互复杂度要求极高的企业内部场景里，比如财务系统、生产制造执行系统（MES）、仓储物流管理，C/S架构的“胖客户端”应用依然有着不可替代的优势。它无需依赖浏览器，能充分利用本地计算资源，处理海量数据时流畅度远超Web页面，而且与数据库（尤其是Oracle、SQL Server这类传统关系型数据库）的交互效率极高。

为了让学习过程不枯燥，我们这次就玩点真的。我打算带大家从零开始，用PowerBuilder 12.5构建一个小型但五脏俱全的“客户信息管理系统”。这个系统虽然简单，但会涵盖企业级应用的所有核心环节：登录验证、主界面导航、客户数据的增删改查、条件筛选、报表打印，最后打包成一个能独立安装的EXE。跟着我走完这一趟，你不仅能学会PB的基本操作，更能理解一个完整的C/S应用是如何从无到有搭建起来的。相信我，很多原理和思路，和你现在用的现代框架是相通的。

2. 搭建你的第一个“工作空间”：一切从这里开始

很多新手一打开PowerBuilder会被一堆概念搞晕：Workspace、Target、Library、Application都是啥？别急，我用盖房子来给你打个比方。

Workspace（工作空间）就是你买的那块地皮，一个空文件夹，未来你所有项目（房子）都建在这块地上。Target（目标）就是你计划盖的具体的房子，比如一栋别墅或一个公寓楼。在我们这个例子里，我们只盖一栋叫“客户管理系统”的别墅。Library（库）就是这栋房子的图纸库和建材仓库，你创建的所有窗口、菜单、数据窗口对象，都会像一份份图纸一样存放在这里。Application（应用对象）则是这栋房子的总大门和总电闸，是整个程序的入口点。

下面我们开始动手。打开PowerBuilder 12.5，点击菜单栏的File->New。在弹出的对话框里，选择Workspace标签页，然后选中Workspace，点击OK。

提示：我强烈建议你专门为PB项目建立一个清晰的目录，比如D:\PB_Projects。这样便于管理，也避免文件散落各处。

系统会让你选择保存位置。我们就在D:\PB_Projects下新建一个文件夹，命名为CustomerManager。然后，将工作空间文件命名为CustomerManager并保存。你会看到PB左侧的System Tree窗口顶部，出现了CustomerManager的工作空间图标。

接下来，我们要在这块“地皮”上规划我们的“房子”。再次点击File->New，这次选择Target标签页。你会看到好几种项目类型，我们选择最经典的Application。点击OK后，会弹出一个向导。

• Application Name（应用对象名）：这里输入customer_manager。注意，PB的命名习惯通常用小写字母和下划线，这会让你的代码更易读。
• Library（库文件路径）：它会自动生成一个路径，比如D:\PB_Projects\CustomerManager\customer_manager.pbl。.pbl是PowerBuilder Library的扩展名，这就是我们的“图纸库”。直接用它默认的就好。
• Target（目标文件路径）：同样会自动生成，如D:\PB_Projects\CustomerManager\customer_manager.pbt。.pbt文件是一个文本文件，里面记录了Target的基本信息，不用手动编辑。

点击Finish。瞬间，你的“地基”和“图纸库”就搭好了。在System Tree里，展开你的Target，你会看到自动生成了一个叫customer_manager的应用对象。双击它，会打开一个代码编辑器，里面默认有一个open()事件。这个open()事件，就是程序启动时第一个执行的地方，相当于房子的“总开关”。我们先在里面写一句最简单的代码：MessageBox("提示", "应用启动成功！")。然后点击画工具栏上那个红色的Run按钮（或者按Ctrl + R）。如果弹出一个消息框，恭喜你！你的第一个PB程序骨架已经成功运行了。虽然它现在还什么都做不了，但万事开头难，我们已经迈出了最关键的第一步。

3. 设计程序的“脸面”：窗口、菜单与控件

一个没有界面的程序就像没有脸的房子，没人知道怎么进去。在C/S时代，窗口（Window）就是程序的脸。我们接下来要创建登录窗口和主窗口。

首先关闭应用对象的代码窗口，回到System Tree。右键点击你的Target名称customer_manager，选择New。在弹出的New对话框里，选择PB Object标签页，然后选中Window。点击OK，一个全新的、空白的窗口设计器就打开了。

这个窗口将来是我们的登录窗口。我们先设置它的属性。在右侧的Properties（属性）视图中，找到Title属性，输入“客户管理系统 - 登录”。找到WindowType属性，从下拉框中选择response!。这个类型很重要，response!窗口是模态窗口，它会阻塞后面的操作直到自己关闭，非常适合做登录窗口。然后，把MaxBox和MinBox属性的勾选去掉，我们不需要登录窗口能最大化和最小化。最后，调整一下窗口的大小，让它看起来不那么庞大，比如宽度设为2500，高度设为1000（PB的单位是PBU，你可以大致理解为像素）。

现在，我们从左侧的Controls（控件）工具栏上，往窗口里“拖拽”组件。我们需要：

1. 两个StaticText（静态文本）：分别把它们的Text属性改为“用户名：”和“密码：”，作为标签。
2. 两个SingleLineEdit（单行编辑框）：放在标签旁边。把第二个用来输入密码的编辑框的Password属性勾选上，这样输入时就显示为星号*。
3. 两个CommandButton（命令按钮）：Text属性分别设为“登录”和“取消”。

简单排列一下，一个简陋但可用的登录界面就出来了。保存这个窗口，PB会提示你给窗口对象命名。遵循命名规范，我们给它起名叫w_login（w_是window的缩写）。保存后，这个窗口对象就存入了你的.pbl库中。

接下来，我们要让程序启动时显示这个登录窗口，而不是之前那个消息框。再次双击System Tree里的customer_manager应用对象，打开它的代码编辑器。把刚才写的MessageBox那句删掉，改为：Open(w_login)。这句代码的意思就是：程序一启动，就打开w_login这个窗口。现在再运行程序（Ctrl+R），弹出的就是你自己设计的登录窗口了！虽然点了按钮还没反应，但界面已经出来了。

主窗口的创建过程类似。我们再新建一个Window，将其WindowType属性设为mdi!或者main!。mdi!是多文档界面，适合内部有多个子窗口的应用；main!是普通主窗口。我们这里用main!就行。把它的Title改为“客户信息管理系统”，命名为w_main并保存。

光有窗口还不够，我们还需要菜单（Menu）来组织功能。右键Target，New->PB Object->Menu。这就打开了菜单设计器。在最顶层的菜单项上右键，选择Insert Submenu Item，可以添加一级菜单。我们依次创建“文件(&F)”、“客户管理(&C)”、“帮助(&H)”等。“&”符号表示快捷键，比如“文件(&F)”运行时显示为“文件(F)”，按Alt+F就能激活。

在“文件”菜单下，插入子菜单项“退出(&X)”。在“客户管理”下，插入“客户列表(&L)”、“新增客户(&N)”等。设计好后，保存菜单为m_main。最后，别忘了把这个菜单挂到主窗口上。打开w_main窗口的设计器，在属性视图里找到MenuName属性，点击后面的小按钮，选择我们刚创建的m_main菜单。这样，主窗口运行时顶部就会显示菜单栏了。

4. 连接数据的桥梁：配置数据库与事务对象

程序光有脸不行，还得有“记忆”和“大脑”，也就是数据库。PowerBuilder最强大的武器之一就是能极其方便地连接和操作数据库。我们以连接本地的 Microsoft SQL Server 数据库为例（连接其他数据库如Oracle、Sybase过程类似）。

首先，你得确保本地或网络上有可用的SQL Server实例，并且创建好了一个数据库，比如叫CustomerDB，里面有一张customer表，包含id,name,phone,address等字段。

然后，我们需要在PB里配置一个数据库连接参数。点击PB工具栏上的Database图标（或者从菜单Tools->Database Painter打开），会启动数据库画板。在Objects窗口，展开ODB ODBC->Utilities->Create ODBC Data Source。你可以在这里创建一个指向CustomerDB的ODBC数据源（系统DSN或用户DSN都行），命名为DS_Customer。

配置好后，在数据库画板的Objects窗口，找到ODB ODBC下的DS_Customer，右键选择Connect。如果连接成功，你就能展开它，看到里面的表、视图等对象了。这一步确保了PB能通过ODBC找到你的数据库。

但是，在程序代码里，我们不会直接使用这个配置。PB通过一个名为事务对象（Transaction Object）的全局对象SQLCA（SQL Communications Area）来管理数据库连接。你需要告诉SQLCA连接参数。通常，我们在应用对象的open()事件里，或者在一个全局函数里进行配置。

我们修改应用对象customer_manager的open()事件代码。在Open(w_login)之前，加上数据库连接配置：

// 配置默认事务对象 SQLCA 的连接参数 SQLCA.DBMS = "ODBC" SQLCA.AutoCommit = False // 通常设置为手动提交事务 SQLCA.DBParm = "ConnectString='DSN=DS_Customer;UID=sa;PWD=你的密码'" // 尝试连接数据库 CONNECT USING SQLCA; // 检查连接是否成功 IF SQLCA.SQLCode <> 0 THEN MessageBox("数据库连接失败", "错误原因：" + SQLCA.SQLErrText) RETURN // 连接失败，直接返回，不打开登录窗口 END IF Open(w_login) // 数据库连接成功，再打开登录窗口

这段代码做了几件事：设置了DBMS类型为ODBC，关闭了自动提交，给出了连接字符串。然后执行CONNECT语句。SQLCA.SQLCode是执行SQL语句后的返回码，0表示成功，非0表示失败。如果失败，我们用MessageBox显示错误信息并停止启动。

注意：在实际项目中，像数据库密码这样的敏感信息，绝对不应该硬编码在代码里。更安全的做法是将其存储在加密的配置文件或注册表中，程序启动时读取。这里为了演示简化了。

5. 数据的灵魂画笔：创建与使用数据窗口对象

如果说窗口是程序的脸，那数据窗口（DataWindow）就是PB的“灵魂”和“王牌”。它是PB中用于显示、操作和验证数据的核心对象，功能强大到令人惊叹。你可以把它理解为一个高度智能、可定制的数据表格或表单。

数据窗口对象有很多表现风格（Presentation Style），比如Grid（网格，像Excel）、Tabular（列表）、Freeform（自由格式，常用于数据录入）、Label（标签）等。我们为“客户列表”创建一个Grid风格的数据窗口。

在System Tree中右键Target，New->DataWindow。选择Grid风格，点击Next。选择数据源，这里我们选最常用的SQL Select，点击Next。然后选择customer表，把id,name,phone,address等字段勾选上。你甚至可以在Syntax页面直接编辑SQL语句，添加WHERE条件或ORDER BY排序。设计好后，点击工具栏的Return按钮。

现在进入了数据窗口对象的设计界面。上半部分是数据预览区，下半部分是设计区。在设计区，你可以调整列标题（Header Band里的文本）、列的位置和宽度。你还可以在Detail Band里插入计算字段、按钮等。比如，我们觉得id列不需要显示，可以右键点击id列，选择Properties，在Expressions标签页里，找到Visible属性，输入表达式0（表示不可见）。设计得差不多后，保存这个数据窗口对象，命名为d_customer_list。

光有数据窗口对象还不够，它需要被“放置”到一个窗口里才能显示。我们打开之前的主窗口w_main。从控件工具栏上找到DataWindow控件（图标像一个表格），把它拖到窗口上，调整好大小。这个控件是一个容器，用来承载和显示数据窗口对象。选中这个控件，在属性视图里，找到DataObject属性，点击后面的小按钮，选择我们刚创建的d_customer_list。这样就把两者关联起来了。给这个控件起个名字，比如叫dw_1。

现在，我们需要在窗口打开时，让这个数据窗口控件去数据库里把数据“捞”出来显示。在w_main窗口的open()事件里写代码：

// 将全局事务对象 SQLCA 分配给窗口内的数据窗口控件 dw_1 dw_1.SetTransObject(SQLCA) // 执行检索操作，将数据从数据库填充到数据窗口 dw_1.Retrieve()

SetTransObject方法告诉数据窗口控件dw_1使用哪个事务对象（这里是SQLCA）来与数据库通信。Retrieve()方法则执行关联的SQL语句，将查询结果拉取到数据窗口缓冲区中并显示出来。

6. 让程序“活”起来：编写业务逻辑与事件脚本

界面有了，数据也能显示了，现在要让程序能“动”起来，响应用户的操作。这就是写业务逻辑代码，在PB里主要是为各种事件（Event）编写脚本（Script）。

首先，完成登录功能。打开登录窗口w_login，双击“登录”按钮，会打开它的clicked事件代码编辑器。在这里，我们要做几件事：

1. 获取用户输入的用户名和密码。
2. 到数据库的用户表（假设我们有个sys_user表）里去验证。
3. 验证通过，关闭登录窗口，打开主窗口；验证失败，提示错误。

// 声明变量 string ls_username, ls_password // 获取两个单行编辑框里的文本 ls_username = sle_1.text // 假设用户名输入框叫 sle_1 ls_password = sle_2.text // 假设密码输入框叫 sle_2 // 简单的非空校验 if Trim(ls_username) = "" or Trim(ls_password) = "" then MessageBox("提示", "用户名和密码不能为空！") return end if // 构造SQL语句，查询用户表 string ls_sql ls_sql = "SELECT user_id FROM sys_user WHERE username = '" + ls_username + "' AND password = '" + ls_password + "'" // 声明一个游标（或使用数据窗口、动态SQL，这里用游标简单演示） DECLARE cur_user CURSOR FOR SQLSA ; PREPARE SQLSA FROM :ls_sql ; OPEN cur_user; FETCH cur_user INTO :ll_user_id; // 假设 ll_user_id 是之前声明的long型变量 // 判断是否查询到结果 IF SQLCA.SQLCode = 0 THEN // 查询成功且有数据 CLOSE cur_user; // 登录成功，关闭登录窗口，打开主窗口 Close(Parent) // Parent 指代这个按钮所在的窗口，即 w_login Open(w_main) ELSE CLOSE cur_user; MessageBox("登录失败", "用户名或密码错误！") END IF

注意：上述代码直接拼接SQL字符串，存在SQL注入风险，仅用于演示。实际项目中应使用参数化查询或数据窗口对象来安全地验证用户。

其次，实现主窗口的数据增删改查。在主窗口w_main上，我们除了显示数据的dw_1，还需要添加“新增”、“保存”、“删除”、“查询”等按钮。

• 新增：在按钮的clicked事件中写dw_1.InsertRow(0)。参数0表示在最后插入一行。然后可以用dw_1.ScrollToRow(dw_1.RowCount())滚动到新行。
• 删除：获取当前选中行dw_1.GetRow()，然后用dw_1.DeleteRow(0)删除当前行（参数0表示删除当前行）。
• 保存：这是关键。数据窗口在内存中维护着数据的修改状态（新增、删除、修改）。调用dw_1.Update()方法，它会自动根据状态生成相应的INSERT,DELETE,UPDATE语句，并通过SQLCA事务对象提交到数据库。通常我们会这样写：

  IF dw_1.Update() = 1 THEN COMMIT USING SQLCA; // 提交事务 MessageBox("提示", "保存成功！") ELSE ROLLBACK USING SQLCA; // 回滚事务 MessageBox("错误", "保存失败：" + SQLCA.SQLErrText) END IF

  这里用到了事务控制。Update()方法返回1表示所有SQL语句执行成功。我们在成功后才用COMMIT永久保存更改，失败则用ROLLBACK撤销所有更改，保证数据一致性。
• 查询：我们可以增加几个输入框，让用户输入查询条件。在“查询”按钮的脚本里，使用数据窗口的SetFilter()和Filter()方法。例如，按姓名模糊查询：

  string ls_filter ls_filter = "name like '%" + sle_name.text + "%'" // sle_name是输入姓名的编辑框 dw_1.SetFilter(ls_filter) dw_1.Filter() dw_1.Retrieve() // 如果数据窗口对象SQL有参数，可能需要带参数Retrieve

7. 最后的临门一脚：调试、编译与发布

代码写完了，但难免有bug。PB提供了方便的调试器。在你觉得可能有问题的代码行前点击设置断点（红色圆点），然后以调试模式运行（Debug按钮或Ctrl+D）。程序运行到断点处会暂停，你可以查看所有变量的当前值，单步执行，观察程序逻辑是否正确。

调试无误后，就要把我们的项目编译成可执行文件（EXE）了。点击菜单File->New，选择Project标签页，然后选中Application Wizard或Application。我们一步步跟着向导走。

1. 指定可执行文件路径和名称：比如D:\PB_Projects\CustomerManager\bin\CustomerManager.exe。
2. 选择程序运行方式：是生成机器码（Machine Code）还是P-Code。生成机器码执行效率更高，但编译时间长；P-Code编译快，文件小，但需要解释执行。对于小型应用，P-Code也足够。我们选P-Code。
3. 选择需要包含的动态库：PB程序运行需要一些运行时动态链接库（DLL），比如PBVM125.DLL（P-Code虚拟机）。向导会帮你列出，通常保持默认选择即可。
4. 资源文件：如果你的程序用了图片、图标等外部资源，需要在这里指定一个.pbr（资源）文件，将资源编译进EXE，避免发布时丢失。
5. 版本信息：可以设置EXE文件的版本号、公司名、描述等。

配置完成后，保存这个工程文件（比如叫p_customer_manager）。然后，在System Tree里找到这个工程，右键选择Deploy（部署）。PB就会开始编译，最终在指定目录生成CustomerManager.exe以及一堆必需的DLL文件。

发布给用户时，你不能只给一个EXE。你需要将整个输出目录（比如上面的bin文件夹）打包。里面至少包含：

• CustomerManager.exe（你的主程序）
• PBVM125.DLL,LIBJCC.DLL等PB运行时库（具体需要哪些，编译日志里会列出）
• 数据库客户端连接库（比如SQL Server的ntwdblib.dll）
• 一个安装程序脚本（如使用Inno Setup制作安装包），用来在用户电脑上创建快捷方式、写入必要的注册表项（如ODBC数据源）等。

走到这一步，一个完整的、可独立运行的C/S架构客户信息管理系统就诞生了。从环境搭建、界面设计、数据库连接、核心功能开发到最终打包发布，我们完成了一个小型企业级应用的全生命周期开发。这个过程虽然基于“古老”的PowerBuilder，但其蕴含的模块化设计、数据绑定、事务控制、打包发布等思想，在任何软件开发中都是相通的。希望这次实战能帮你不仅学会PB这个工具，更能理解桌面应用开发的精髓。