建立和部署powerbuilder组件
（石骁騑　2001年07月20日 17:56）

一、研发组件
在介绍如何将pb组件部署到jaguar cts服务器之前，首先介绍一下如何利用powerbuilder 7研发一个组件。这一步很重要，因为在这里要设定许多选项，而这些选项又最终直接影响到pb组件的部署工作。

pb研发的jaguar组件是具备一些特别事件和属性的特别的pb非可视化对象（nvo）。这个对象除了要编写代码和在pb中配置一些属性之外，在jaguar中还需要设定一些特别的选项来控制组件的行为，而这些选项的配置即可通过手工设定也可通过pb的jaguar 组件向导来设定其中的一大部分。

采用jaguar组件向导创建组件，需要回答一系列的问题和配置一些选项，对这些配置和选项的理解是很重要的，因为他直接影响部署到jaguar服务器中组件的行为。

利用powerbuilder创建jaguar组件时一般都采用juguar组件向导，该向导引导您完成一系列的配置来创建一个新的jaguar组件。在向导引导过程中输入的值最后将影响到组件的事件、属性和部署选项。所以在该向导过程中，必须注意这些选项和属性的值。下面我们就开始一步步利用组件向导来创建一个jaguar组件，对涉及到的任何选项和属性作周详介绍。

选择“file | new” 菜单或直接在工具条中选择“new”。powerbuilder 弹出一个由许多标签组成的对话框。选择“start wizards”标签，再选择“jaguar component”，然后点击“ok”按钮，jaguar组件向导启动。在第一次创建组件时需要上述步骤，一旦利用该向导创建了一个组件应用，以后只需要在“object”标签下创建另外的组件。

向导的第一个屏幕首先介绍了该向导的功能和如何通过客户端应用来存取jaugar对象。点击"next"按钮，出现下一个对话框，这个对话框总结了向导需要的任何信息和将要回答的问题，点击"next"按钮，出现如图1所示对话框。该对话框提示用户输入应用的名称和库路径。在这里能够取一个能反映组件功能的应用名称，也能够选用默认的名称“genapp”，最后确认库路径，并点击"next"按钮。下一个屏幕显示库路径，假如需要的话，能够改变他，点击"next"按钮，弹出如图2所示对话框。该对话框需要用户输入powerbuilder的非可视化组件的名称和描述信息，系统默认为应用名称前加"n_"前缀。点击"next"按钮，弹出下一个对话框。该对话框需要用户输入jaguar组件名，这个名称默认为和powerbuilder对象名相同但用户也能够改变他。点击"next"按钮，下一个屏幕需要用户输入连接jaguar服务器的一些信息，如图3所示。当部署组件到jaguar服务器时，powerbuilder需要这些信息来取得和服务器的连接。假如jaguar组件服务器运行在本地机器上，则在“server name”处填入localhost，假如组件服务器没有运行在本地，则需要输入服务器的的名称或其ip地址。端口号为在jaguar服务器创建时指定的监听器端口号，确省为9000。登陆账号默认为jagadmin，口令默认为空（jaguar服务器管理员能够更改默认的登陆账号和口令），鼠标单击"next"按钮。



图1 指定新的应用名称和库

图2 指定组件名和描述信息

图3 指定服务器信息

下一个屏幕需要用户为组件指定一个包名。什么是包？一般来说，一个包就是一组功能相关的对象的集合。任何部署到jaguar服务器的组件都需要一个包名。在这里能够手工输入一个包名，也能够取jaguar服务器上已存在的一个包名，点击"next"按钮。

下一个屏幕需要用户选择组件的类型。这里有三种类型供选择：标准型（一般组件）、共享型（共享实例）和服务型（在服务器启动时装入，为jaguar客户端或组件执行后台服务）。一个共享组件的“sharing”属性被配置为true。服务组件不但被标志为共享，而且更有另外一些方法，如运行，启动和停止等。选择需要的组件类型，点击“next”按钮。

下一个屏幕用来指定实例缓冲选项，如图4所示。在选择“不支持（not supported）”情况下，能够通过在组件的“canbepooled” 事件中添加代码来改变组件实例为支持缓冲。也能够通过在jaguar manager中改变组件的缓冲属性。选择所需要的缓冲属性，点击“next”按钮。

图4 指定组件的实例缓冲选项

下一个屏幕用来指定事务支持（transaction support）和自动分界/自动清除（auto demarcation/deactivation）选项。这两个属性也能够通过jaugar manager来直接设定。下面对几种事务分别作一下解释。
“not supported（不支持）”：指组件在事务范围之外执行； “supports transaction（支持）”：指假如有一个事务在执行，则该组件在这个事务中执行，否则组件将在事务之外执行。 “requires transaction（请求事务）”：指组件将一直在一个事务内部执行。假如客户端向一个组件发出服务请求时，则一个新的事务开始。假如一个组件被另外一个已运行在一个事务中组件请求，则该组件将使用另外一个组件的事务。 “requires new transaction（请求新事务）”：指一个组件初始化后，一个新的事务开始启动。
假如选中“自动分界/清除”选项则指该组件在他的任何一个方法被调用后自动使之不活动；否则，组件直到收到一个 setabort 或 setcomplete 调用才使之不活动。选择完毕后，点击“next”按钮，下一个屏幕用来指定界面选项，这些选项容许您修改组件界面的方式。在这里强调一点，除非您对组件有特别的需求或对这些选项具备很清楚的理解，一般建议不要改变这些选项，保持默认值。点击“next”按钮。

下一个屏幕用来选择远程调试（remote debugging）和现场编辑（live editing）。远程调试选项在研发期间是很有用的，但是到了最终释放代码时，不要选中该选项，否则，用户能够看到您的组件代码。现场编辑指powerbuilder每次在对组件画板作过改变保存后都自动部署组件到jaguar。选择需要的选项，点击“next”按钮。

下面将进行pbd生成的一些选项选择。假如选择第一项，则powerbuilder将从任何库列表中的pbd创建一个单一合并的pbd，然后还需要为这个合并的pbd另外指定一些选项。假如在组件的数据窗口中有一些动态引用（如用到了数据窗口），则应该选中第二个选项（include unreferenced objects)。输入一个合并后的pbd的名称和使用的资源文档pbr的名字，这个资源文档能使组件具备和通常意义上的powerbuilder应用相同的功能。点击“next”按钮。

最后，向导显示出任何的选项并为这个组件生成一个“工作计划（to_do）列表”，点击“finish”按钮，至此，该组件将被生成。

二、修改pb对象为组件
有时候需要将一个已存在的pb对象升级为一个组件。这时就需要增加一些事件，还需要为部署该组件创建一个工程。
1. 添加事件
将一个传统的pb对象升级为一个jaguar组件，需要另外添加一些事件，包括 activate, deactivate 和可选的canbepooled事件。
activate – 该事件映射到“pbm_component_activate”。该事件代码每次在组件被激活时执行。这里需要注意的是映射事件是“pbm_component_activate”而不是平常很熟悉的pbm_activate。 deactivate – 该事件映射到“pbm_component_deactivate”。当组件不活动时激活该事件。 canbepooled –该事件映射到“pbm_component_canbepooled”。他用来程式控制组件的实例缓冲。返回1时，允许实例缓冲，返回0时，禁止实例缓冲。2. 创建一个部署工程
一旦将一个传统意义上的powerbuilder对象升级为一个jaguar组件，还需要另外创建一个部署工程，在下一节中对其进行周详讨论。
三、部署组件的过程和选项
在客户端应用程式使用组件之前，必须将该组件部署到一个应用服务器中。在powerbuilder 7中，能够利用pb和jaguar的集成特性，在pb中每次对组件进行修改保存后，直接将其部署到jaguar服务器中。这种特性在pb中被称为现场调试（live editing），这在研发和测试环境中是很有帮助的，但不能将其应用到实际应用环境中。
1. pb组件的组成powerbuilder pbds
一个部署过的powerbuilder组件具备许多的元素。第一个就是编译过的pb代码，存放在一个或多个pbd中。在操作系统中必须要指定这些组件库的路径，这样powerbuilder的 pbds才能够被jaugar中的powerbuilder运行时间库引擎存取。 idl
除了powerbuilder代码以外，还需要一个界面描述，他在客户端应用向服务器中的组件请求服务时使用。这些界面信息采用界面定义语言（idl）来描述。 resources
资源是组件动态应用需要的位图或数据窗口，这些资源保存在pbr文档中。
2. 部署过程

下面来看将一个powerbuilder组件部署到jaugar服务器上时，系统会进行那些操作。一般部署一个组件包括在jaguar知识库（repository）中配置一些文档和属性，这样当一个客户端应用请求时组件才能够被找到、定位和执行。这里需要注意的是最好不要手工操作jaguar知识库中的文档，但是假如您对这些属性文档了解较多，则能够直接编辑这些属性文档，很方便快捷。
jaguar知识库（repository）
在jaguar cts目录下，有一个文档夹叫“repository”。该目录包括了任何部署到该服务器的pb组件的相关文档。java组件（.calss文档）的可执行代码在jaguar cts 3.5\java\classes 目录下，不在repository目录下。
添加组件和包属性到知识库(repository)
每一个组件或包都有一系列的相关属性属性文档。在repository目录下包含了许多以“.props”为后缀的文档，这些文档保存了jaugar的安装（包括server）、包和组件的各个方面的信息。在jaugar manager中看到的任何属性就是这些.props文档。repository目录是这样组织的，每一个powerbuilder组件的属性文档在包目录下的组件目录里面，包的属性在包目录下面的.props文档中。
添加powerbuilder代码到repository
编译过的powerbuilder代码将被添加到知识库repository目录下的“components” 目录。部署到jaugar的每一个包在componets目录下都有一个子目录，包中的每一个组件都有一个目录存放在包目录的下面。假如组件是powerbuilder组件，那么就会有一系列的以“c”开头的目录在components目录下。
生成idl并且添加到repository
idl描述了一个组件是如何被客户端应用调用的。在repository目录下的idl目录下，能够看到jaguar组件的idl。idl文档是以包为单位组织的，在idl目录下每个包具备一个子目录，里面包含了任何包中组件的idl文档。
关于“cookies”
每当一个powerbuilder组件被部署到jaguar服务器上时，他都被放置到了repository目录下的一个新的目录，这些目录以c1开始顺序命名，能够在repository目录下的components目录下看到这些目录，其中每一个目录都包含了编译过的powerbuilder代码。jaguar对这些目录的管理是通过组件的属性－“com.sybase.jaguar.component.pb.cookie”进行的，该属性的值就是现在使用的“cookie”,也就是子目录号。我们能够删除任何数字比他小的目录而不会对组件构成任何影响，这样能够释放许多的磁盘空间出来。
三、jaugar工程向导1. 创建一个jaugar工程
创建一个组件后，还需要一个jaguar工程来部署组件。创建一个jaguar工程的步骤和前面谈到的创建一个组件的过程很相似。在powerbuilder中选择“file | new” ，然后在“projects”标签中选择“jaguar component wizard”，和组件向导不同的是在工程（projects）标签，而组件向导则在对象（objects）标签。

建立一个部署工程以后，就能够在powerbuilder中打开这个工程选择“design |build project”菜单来部署组件到jaguar服务器。
2. 现场编辑
在第一次利用组件向导创建一个组件时，能够选择“live editing”这个选项。然而，假如在第一次创建组件时没有选择该选项，那么以后更有没有办法选择该选项呢？回答当然是有，能够通过下面的步骤来使该功能有效。
在jaguar工程中选择组件； 在powerbuilder中打开组件。在属性面版选择该工程，就能够修改该选项。

3. 部署powerbuiler组件到另外的服务器

在实际研发中，经常碰到这样的问题，利用研发版部署powerbuiler组件到另外的服务器时，经常出现不能部署的问题。主要原因可能是：

1. 在powerbuilder研发环境中想存取商业服务器。

“现场编辑”选项在研发环境是个很有用的选项，但他不适于在商业服务器上工作。设想一下，假如每一个研发者对商业服务器均有部署存取权限，那么其中任何一个人的一个小小错误都将导致很严重后果。

2. 远程地址

另外一种情况就是将组件部署到不是本机的远程网络服务器上，这意味着现在的pb研发环境没有对目标远程服务器的存取权限。
四、包部署
相对于从powerbuilder部署组件，更有一种部署组件的方法就是包部署，也就是从研发服务器上将包导出到一个文档，然后再将其导入到目标服务器上。
1. 利用jaugar manager创建导出文档
jaguar manager提供了将一个包导出到文档的功能，该文档包含了部署组件任何有关的文档和信息，并以一个 .jar (java 文档)的文档格式保存。下面是具体步骤：
启动jaguar服务器管理器并登陆。默认登陆用户为jagadmin，口令为空，假如jaguar服务器运行在本地研发机器上，则主机名（hostname）为localhost，否则为远端的机器名或ip地址，默认端口号为9000。 在jaugar manager左边的树型目录下，在server/jaguar/installed package目录下，能够看到许多包名，其中包括从pb组件工程中提交的包，找到包含需要导出组件的包。 在包目录上点击鼠标右键，选择“export package”，弹出一个导出对话框。选择“export as jaguar package jar file”，然后选择将该包导出的路径，最后点击“export”按钮。在您选择的目录下，jaguar manager将创建一个名为“包名.jar”的文档，包名为jaguar manager中显示的包名称。2. 安装组件
一旦创建了一个名为jar的文档，就能够将其安装到任何一个jaguar服务器上。安装方法如下：
拷贝jar文档到目标jaguar服务器能够存取到的目录； 登陆jaguar manager，在左边的树型视图中找到“installed packages”目录； 在“installed packages”目录上，点击鼠标右键，选择“import”； 在弹出的对话框中选择“deploy from jaguar package jar file”，找到需要导入的jar文档，最后点击“ok”按钮。所选择的jar文档就被导入到目标jaguar服务器上。五、同步部署组件
前面介绍的包部署的方法是个很简单和有效的方法，然而他却存在一些缺点，如在一些大规模部署的情况下，就显得不是很适用，很的烦琐。在这种大规模部署的情况下，另外的一种称之为同步（synchronization）的方法就显示出了他的优越性。同步即能够在集群（cluster）和服务器（server）层面，也能够在包和组件层面上操作。

同步能够在任何能够连接到的服务器上进行，也能够在一个集群的服务器上执行。集群同步必须在集群的主服务器上进行。下面是同步部署组件的步骤：
启动jaguar manager，连接到主服务器。这里主服务器的概念就是组件和包所在的服务器； 在“servers”目录下，选择一个服务器、包或一个组件，然后在其上鼠标右键选择“synchronize”； 输入连接到的远端服务器或集群的用户名和口令。这里需要注意的是假如要连接到多个服务器或多个服务器在一个集群上，任何的服务器必须具备同样的用户名和口令； 假如要同步到一个集群的任何服务器上，点击“cluster”选择框，在旁边的编辑框中输入集群名称。注意，这些操作必须是在连接到集群的主服务器上进行。 在“servers”编辑框中输入需要同步的目标服务器的地址（url或ip地址）； 在“options”页面下，有一些选择框，下面分别一一对其进行解释。“all cluster files”：复制任何的集群属性到目标服务器上；. “all package files”：复制任何的源服务器上的包文档到目标服务器。这包括任何的idl文档、属性文档、执行文档（如pbd文档）和组件定义文档等； “all servlet files”：复制任何的servlets到远程目标服务器上； “verbose” ：在同步操作时产生周详的信息； “new primary”：在集群中指定源服务器为主服务器。在选择该选项时要很小心，选定该选项后，更改的任何配置将开始起作用； “new version”：当同步一个集群时指定一个新的集群版本号； “refresh”：在同步的最后执行刷新操作。 “restart”：在同步完成以后重新启动远程服务器。“then wait”对话框中填入的时间指主服务器等待远程服务器重新启动的时间。 选择了合适的选项后，鼠标单击“start sync” 按钮，开始执行同步操作。结论
深刻理解部署jaguar组件的各种选项是很重要的。在powerbuilder研发环境下，能够利用“live editing”或从部署工程中部署组件。在商业环境下，不能从研发环境中部署组件，这时能够选择导出/导出包的jar文档的方法或同步的办法来完成。

以上内容由 华夏名网 收集整理，如转载请注明原文出处，并保留这一部分内容。