PBnTierBase
帮助
Version 1.2
一. PBnTierBase 简介
在 Web 应用迅速发展的今天和客户需求的不断升级，使用 PowerBuilder 开
发的单机版或 C/S 架构程序在很多情况已经不能满足新形势下的市场需要，对
于主要以 PowerBuilder 为开发工具的公司或个人，如何在不投入高额成本的情
况下使用 PowerBuilder 开发可运行在互联网（广域网）上的程序，以满足新形
势下的客户需求和增加产品的持久竞争力，已经是摆在我们面前和需要我们去
解决的一个至关重要的问题，为此我们开发了 PBnTierBase。PBnTierBase 是使
用 PowerBuilder 快速开发三层应用的框架，开发人员不需要掌握中间层的开发
技术，也不需要做中间层的开发工作，直接调用 PBnTierBase 中间层服务组件
的相关功能进行客户端开发，即可实现使用 PowerBuilder 开发三层应用，大大
降低了开发人员使用 PowerBuilder 开发三层应用的技术门槛和开发难度。目前
PBnTierBase 支持部署在 EAServer 或 IIS 应用服务器上，也可以以 COM+组件形
式进行部署。采用 PBnTierBase 开发的客户端程序，在不需要更改任何程序代码
的情况下，通过切换对应版本的中间层服务组件，即可实现以 EAServer、.NET
WebService、EasySoap WebService 或 COM+任意形式的分发和部署，从而满足不
同应用规模和不同类型用户的需要。
PBnTierBase 主要特点：
1、大大降低了 PowerBuilder 开发三层应用的技术门槛和开发难度，实现了使用
PowerBuilder 快速开发三层应用
2、压缩数据传输
3、分页数据检索
4、任意加载 PBD 库文件
5、实现了 PowerBuilder 原有的对 DataWindow 和 SQL 的绝大部分操作
6、支持 Blob 类型字段的操作
7、一次开发，以 EAServer、.NET WebService、EasySoap WebService 或 COM+任意
形式分发和部署
8、支持 Ftp 相关操作，可实现客户端的自动更新
…
二. 开发环境要求及安装
1.要求
（1）PowerBuilder 11.5 3127（或更高版本)
（2）Microsoft SQL Server 2005
PBnTierBase for EAServer：
（3）Sybase EAServer5.5
1
PBnTierBase for IIS：
（4）Microsoft IIS 5.0（或更高版本)
（5）Microsoft .NET Framework SDK 2.0
2.安装
（6）导入 PBnTierBase 数据库到 Microsoft SQL Server 2005
（7）采用 ODBC 建立名称为“PBnTierBase”的数据源
PBnTierBase for EAServer：
（8）采用 JDBC 建立名称为“PBnTierBase”的 EAServer 数据库连接池。
（9）导入 PBnTierBase Service 包到 EAServer
PBnTierBase for IIS：
（10）采用 ADO.NET 建立名称为“PBnTierBase”的数据源。
（11）把 PBnTierBase Service 部署到 IIS 下面。
PBnTierBase for COM+：
（12）采用 ADO.NET 建立名称为“PBnTierBase”的数据源。
（13）安装 PBnTierBase Service 服务器端应用程序
三. PBnTierBase 组件
1.n_pbntierbaseadapter 对象
1.1 属性
（1）zip
boolean zip 是否启用压缩传输数据
1.2 函数
（1）of_retrieve
of_retrieve ( string as_datawindow, ref blob ablb_data ) returns long
功能描述：
返回检索数据
参数说明：
as_datawindow 数据窗口名
2
ablb_data 返回的数据
返回值：
成功 返回行数
-1 数据检索错误
-2 数据压缩错误
-99 发生异常错误
-100 数据库连接错误
（2）of_setssretrieve
of_setssretrieve ( string as_datawindow, string as_statement, ref blob
ablb_data ) returns long
功能描述：
通过 SetSQLSelect 设置检索参数后，返回检索数据
参数说明：
as_datawindow 数据窗口名
as_statement 条件表达式
ablb_data 返回的数据
返回值：
成功 返回行数
-1 数据检索错误
-2 条件语句设置错误
-3 数据压缩错误
-99 发生异常错误
-100 数据库连接错误
（3）of_setssdwretrieve
of_setssdwretrieve ( string as_datawindow, string as_statement, ref blob
ablb_data ) returns long
功能描述：
通过 SetSQLSelect 设置数据窗口 SQL 后，返回检索数据
参数说明：
as_datawindow 数据窗口名
as_statement 条件表达式
ablb_data 返回的数据
返回值：
成功 返回行数
-1 数据检索错误
-2 SQL 语句设置错误
-3 数据压缩错误
-99 发生异常错误
-100 数据库连接错误
3
（4）of_modretrieve
of_modretrieve ( string as_datawindow, string as_modstring, ref blob
ablb_data ) returns long
功能描述：
通过 Modify 设置检索参数后，返回检索数据
参数说明：
as_datawindow 数据窗口名
as_modstring 条件表达式
ablb_data 返回的数据
返回值：
成功 返回行数
-1 数据检索错误
-2 条件语句设置错误
-3 数据压缩错误
-99 发生异常错误
-100 数据库连接错误
（5）of_sqldwretrieve
of_sqldwretrieve ( string as_sql, ref blob ablb_data ) returns long
功能描述：
通过 SQL 语句动态创建数据窗口后，返回检索数据
参数说明：
as_sql SQL 语句
ablb_data 返回的数据
返回值：
成功 返回行数
-1 数据检索错误
-2 生成数据窗口对象语法错误
-3 建立数据窗口对象错误
-4 数据压缩错误
-99 发生异常错误
-100 数据库连接错误
（6）of_syndwretrieve
of_syndwretrieve ( string as_syntax, ref blob ablb_data ) returns long
功能描述：
通过数据窗口语法动态创建数据窗口后，返回检索数据
参数说明：
as_syntax 数据窗口语法
4
- 1
- 2
- 3
- 4
- 5
- 6
前往页