ado|编程
现在让我们更深入的了解一下PRADO框架。这一章我们会介绍一些框架的基本概念和如何使用现有的PRADO组件来开发一个PRADO应用。
2.1 组件
根据Clemens Szyperski的说法, ``软件组件是一个具有特定接口的组合单元,可以独立存在,参与组成其它组建。''
在PRADO中, 组件是 TComponent 或者其子类的实例。PRADO框架中已经包括了 TComponent
类,它主要实现了组件的属性和事件机制。
一个完整的组件类定义包括两个文件:
注意:PRADO 是区分大小写的,组件类型,属性名称,事件名称,文件名等等这些都是区分大小写的。
2.1.1 控件
控件是定义了用户界面的PRADO 组件。每一个控件都有一个父控件和一些子控件(注意,这里的父,子这些关系和面向对象中的父类子类的概念是完全不一样的。一个控件是另外一个控件的父控件只是说明了前者拥有后者,这个拥有关系可以理解为一个目录下包含了一个子目录;而绝不是后者是前者的子类、是从前者继承而来的这个概念)。页面是最高级别的控件,它没有父控件(当然你也可以认为Application是它的父控件)。一个PRADO的应用是一个页面的集合,每一个页面都代表了一个层次树状结构的控件集,控件与控件之间关系是通过父子关系联系在一起的。
这种父子关系可以通过模板文件来建立。模板文件的格式和HTML是很像的,只不过在HTML的基础上增加了一些特殊的标签来定应控件。如果一个控件的标签被另外一个控件的标签所包括,那么前者就被认为是后者的子控件。静态文本也被认为是子控件。
控件可以拥有一个模板文件来描述它的界面内容。缺省情况下模板文件和类文件在同一个目录下,而且文件名是相同的,模板文件的后缀则为 .tpl 。同规格文件一样,如果你需要把模板文件放在不同地方或者用鳖的文件名,可以通过设置类常量 TEMPLATE_FILE 的值来指明模板文件的位置。
每一个控件都有一个ID,它可以在同一级别的控件中来唯一标识控件本身。ID路径则是在控件的树状结构中,从当前控件到目标控件的所有控件ID的序列,它可以用于访问一个控件。比如,在
HomePage中,有一个 Menu 控件,它拥有一个子控件 Button 。对于控件HomePage而言,可以通过ID(Menu,Button)路径来访问 Button 控件。如果用PHP代码来书写,就是 $this->Menu->Button .
2.1.2 实例化组件
组件有两种方式来实例化。一种方法是在一个控件的模板文件中定义它,当这个控件被创建的时候,框架会自动的去实例化这个组件。还有一种方法是在PHP代码中手动的实例化。我们先来看一下前面一种静态的创建方法,稍后再来看一下动态的创建方法。
通常只有控件在模板文件中被静态创建。
一个控件在模板文件组件标签来声明,其语法如下:
......
....body contents....
......
这里 ComponentType, PropertyName, 和 EventName 应该被真正的组件类名,属性名和事件名所替代。 ID 属性是可选的。如果定义了ID 属性,那么ID 的值必须在平级的控件中是唯一的。如果没有定义,那么框架会自动为这个控件分配一个唯一的ID的。当然,这要求组件的标签被正确的嵌套,每一个开放的组件标签都应该和一个闭合的组件标签组成一对,这个规则和XML的规则是一样的。(译者著:如果你对XML一点都不了解,建议你先看一下一些基本的XML概念,要求并不高,你只需要知道如何正确书写一个XML文件即可。)
注意:控件的ID必须是一个以字母开头的,后面只包含字母,数字和下划线的字符串。
模板文件中属性的初始值字符串会被自动转换为正确的属性类型。目前有六种属性类型: string, integer, float, boolean, array face="Courier New">和 object. 前面三种类型的字符串格式是非常简单的。 boolean 类型只允许使用两个字符串: true face="Courier New">和 false。 array 类型接受如 (value1,value2,key3=>value3,...) 格式一样的字符串,这和 PHP 数组的初始化是一样的。 而 object 类型就比较复杂了,它取决于属性是如何被定义的。一些属性可以允许使用字符串,并会把它转换为对象,但是有些属性就不行了。
当组件被创建(实例化)的时候,通过规格文件定义的组件的属性和对应事件处理方法就会立刻生效了。
动态创建组件
PRADO
允许开发者在自己的PHP代码中实例化组件。组件可以通过调用一个静态类方法Application::createComponent($type)来被实例化,该方法的参数$type 指明了要创建的组件的名称。组件也可以使用new 操作符来实例化。这两者方法的区别是:前者会使用一种缓存机制,下一次创建相同的组件时速度会快很多;而后者不会使用缓存机制,每次都要完全重复执行实例化的步骤。通常情况你应该使用TApplication::createComponent($type) 来实例化(如果你想了解更多,请参考下面的注释)。
如果新创建的组件是一个控件,那么可以通过调用把这个控件作为其他控件的子控件。注意,如果你需要指定这个控件的ID,应该在将它添加作为其他控件的子控件之前就指定ID;否则的话框架会自动为它分配一个ID,而且这个ID是不能更改的。
注:如果在构造函数中使用或申请了资源句柄的话,只能使用 new 操作符来实例化。因为PRADO使用了缓存机制来实例化组件,因此如果在构造函数中使用了资源句柄的话,下次实例化的时候从缓存读出来的数据中的资源句柄部分依然对应着原来的那块内存地址,这样就极容易导致系统崩溃。所以如果你要设计一个自己的组件,也尽可能的不要在构造函数中使用和申请资源句柄,而是应该把这些代码组织在一个别的方法中,在页面的OnInit事件或其它事件中调用。一般来说构造函数只需要实现简单的变量初始化即可。在PRADO的核心代码中,所有的组件的构造函数都没有使用到资源句柄。你在开发自己的组件的时候,可以参考一下它们的源代码。
2.1.3 访问组件属性
PHP 5 使用了一种很好的方式来访问组件的属性。你可以把一个组件的属性当作组件的成员变量来使用。比如要设置TButton 控件的Text 属性,你可以使用$button->Text="xxx"的代码,这里$button 代表了控件的实例。对于控件来说,你还可以使用它的ID路径来访问属性。假定现在HomePage页面有一个子控件MenuBar ,MenuBar 控件有一个子控件HyperLink ,那么在页面环境中,可以使用的代码$this->MenuBar->HyperLink->NavigateUrl来读取HyperLink 控件的NavigateUrl 属性。
注意,由于PHP5.0中的一个BUG,如果你需要设置一个属性的值,那么你必须首先通过它的控件的ID路径来获得控件,然后再来设置这个属性的值。在上面这个例子中,需要用下面两行代码来设置NavigateUrl 属性。
$link=$this->MenuBar->HyperLink;<br> $link->NavigateUrl="...";<br>
如果直接使用 $this->MenuBar->HyperLink->NavigateUrl 来设置属性值会产生一个错误。但是你还可以下面这段代码来设置属性的值,这样就可以避免那个错误了。
$this->MenuBar->HyperLink->setNavigateUrl("...");
2.1.4 使用事件
事件响应函数通常在规格文件或者模板文件中指定给对应的事件,指定事件响应函数和指定属性的初始值是类似的。注意,在规格文件或者模板文件中指定的事件响应函数,必须在此规格文件或模板文件对应的组件中定义,它的语法如下:
function handlerName($sender,$param)<br> {<br> ...<br> }
这里 $sender 指向的是触发这个事件的控件, $param 是事件的参数,它的内容取决于事件的类型。
在编程的时候也可以使用TComponent::addEventHandler() 方法来动态的指定一个事件响应方法。
你可以为一个事件指定多个响应方法。当这个事件被触发的时候,所有指定的响应方法都被自动调用。所以,PRADO实现的是多点派发事件触发机制。
2.1.5 数据绑定(Data Binding)
只有控件才可以数据绑定。
你可以给控件的属性绑定一个表达式,当这个控件的dataBind() 方法被调用的时候,这个属性的值回自动被设置为这个表达式的值。数据绑定在开发数据组件时是非常有用的,这些组件的很多属性值都是来源于数据源提供的数据的。你可以在组件的规格或者模版文件中设定数据绑定,也可以在代码中设定。
在模版中设定数据绑定的话,只要给属性的值指定一个有效的PHP表达式的字符串,并在前面加上一个# 作为前缀。比如在页面模版文件中使用如下的代码:
<com:TLabel Text="#$this->Page->ID" /><br>
这段代码给TLabel 组件的Text 属性绑定了一个的表达式$this->Page->ID 。这个表达式的作用是获得当前控件所在页面的ID。注意,这个表达式中的$this指的是TLabel控件本身,因为$this所在上下文环境是在TLabel 中。
在代码中要设定数据绑定,可以调用组件的bindProperty() 方法,这时候不需要在前面加上字符# 。
注意,给属性绑定的表达式只有在dataBind() 被调用时才会计算该表达式的值,并把它赋值给属性。具体内容可以参考dataBind() 的相关文档。
另外,如果在模板文件中你需要给一个属性赋初始值,而不是数据绑定的话,如果这个值是以#开头的,那么应该将#重复一次,就像PropertyName="##...." 一样。
2.1.6 PRADO 组件类树
目前发布的 PRADO 包括如下所示的组件树,这些组件的属性,事件和类的方法在PRADO文档中都可以查到。
TComponent
TAdodb
TControl
TExpression
TForm
TLiteral
TPage
TPlaceHolder
TRepeater
TRepeaterItem
TStatements
TWebControl
TButton
TCheckBox
TRadioButton
TDropDownList
THyperLink
TImage
TImageButton
TLabel
TLinkButton
TListBox
TPanel
TTextBox
TDatePicker
THtmlArea
TValidationSummary
TValidator
TCompareValidator
TCustomValidator
TRangeValidator
TRegularExpressionValidator
TEmailAddressValidator
TRequiredFieldValidator
2.2 页面
页面是 TPage 或者它的子类的一个实例。它是最高级别的组件,即没有父组件也不包含在一个容器中。PRADO的应用是由一些页面组成的。
2.2.1 页面的生命周期
理解页面的生命周期对掌握PRADO编程是非常重要的。
首先我们要介绍一下postback的概念。我们把一个form的提交称之为postback,如果form的数据是提交给包含该form的页面的。postback可以被认为是由用户在客户端触发的一个事件。PRADO会区分出把postback事件交给哪一个服务器端的组件来响应。如果找到了这个组件,比如是一个TButton
,那么我们就把这个TButton 组件称为事件的发送者(sender)。
页面在被请求调用的时候会经过几个状态。当一个页面是由于它发生了一个postback而被调用的时候,这个页面会经历以下的生命周期:
当页面是第一次被请求的时候,上述的生命周期会简单一些。具体来说,导入显示状态,导入提交的数据,产生提交数据变化事件,输入验证和postback事件这几个状态是没有的。
2.3 应用
每一个 PRADO Web应用都有且只有一个的实例。它主要是负责编码解码用户请求,服务器的页面请求,和维护应用级别的参数。
2.3.1 应用的配置
每一个PRADO应用都应该有一个XML格式的配置文件。在"hello world"这个例子中,这个文件的文件名为 application.spec .
应用配置文件的格式如下:
<?xml version="1.0" encoding="UTF-8"?><br> <application default-page="..." cache-path="..."<br/> session-class="..." user-class="..."><br> <alias name="..." path="..." /><br> <alias name="..." path="..." /><br> <using namespace="..." /><br> <using namespace="..." /><br> <secured page="..." role="..." /><br> <secured page="..." role="..." /><br> <parameter name="...">...</parameter><br> <parameter name="...">...</parameter><br> <parameter file="..." /><br> </application><br>
alias 元素定义了文件路径的别名,路径可以是绝对是绝对路径也可以是相对路径。
using 元素定义了要增加到 PHP搜索路径 include_path 变量中的命名空间。命名空间是用"."号连接的。第一段是路径的别名,之后是子目录。比如System.Web.UI 代表了框架所在目录下的Web/UI/子目录。框架的目录的别名已经被定义成System 。在编程的时候,也可以调用using() 函数来增加一个命名空间。
secured 标签知名了页面是否需要验证/授权,page 属性指名的是页面的名称或者是页面名称的匹配表达式。如果一个页面被标明是的,那么说明这个页面需要用户验证的。另外如果role 属性不是空的,那么要求用户是属于指定的角色的。
parameter 元素定义了用户参数。可以通过设置parameter 元素的file 属性来导入一个参数文件。参数文件的格式如下:
<?xml version="1.0" encoding="UTF-8"?><br> <parameters><br> <parameter name="...">...</parameter><br> <parameter name="...">...</parameter><br> </parameters><br>
default-page 属性和 cache-path 属性分别知名了缺省的页面和缓存路径。如果应用需要使用session, session-class 属性也需要设置。如果应用需要使用框架的验证/授权支持,那么还应该指定user-class 属性。
2.3.2 页面服务
PRADO 使用 GET 变量 page 来指明要请求的页面。比如下面的这个URL:
/examples/phonebook.php?page=AddEntryPage<br>
这段代码将会请求 AddEntryPage 页面。如果没有指定page 变量,那么就会调用应用配置中的缺省页面。
你也可以使用 TApplication::constructUrl() 方法来请求一个页面。
2.3.3 数据编码和解码
缺省情况 TApplication 会对所有的POST和GET数据进行HTML编码。 ', ", <, >, & 会被转化为',"e;,<,>和&。之所以要进行编码主要是为了让这些字符能被保存到数据库中,并且能正确显示回给用户。如果有必要的话,可以调用pradoDecodeData()函数来进行解码。也可以重载TApplication::beginRequest() 函数不进行编码。
有两种方法来定义新的组件类:继承和组合。
继承是面向对象的设计概念。派生类定义它的父类的一些内容,还可以提供一些其他的功能。在PRADO框架中,组件的属性和事件都是可以继承的。派生类也可以提供更多的属性和事件。所有的组件类都应该从TComponent 或者它的派生类继承。
所有父组件的属性和事件会被派生组件类继承。
组合是用于基于组件的框架的。在PRADO中,主要对控件使用。一个新的控件类可以被定义为几个其他几个控件的组合。新的类负责协调这些控件之间的通信,并代表它们和外界通信。比如可以定义一个LabeledTextBox 控件类(继承TControl ),它由TLabel 一个控件和一个TLabel
控件组成。新的类负责配置这两个组成控件的属性和方法。
一般的约定(并不强求),控件的ID和属性的首字母应该大写,比如HomePage, NavigateUrl,
LogoPict;事件以On开头,比如OnClick 。ID和属性的名字命名和变量命名一样,必须是以字母开头的,仅包括字母数字和下划线的字符串。
要定义一个新的组件通常需要写一个组件类文件,一个规格文件和一个模板文件。有些时候后面两个文件可以不要的。
2.4.1 定义属性
组件的属性在组件类的规格文件中定义,规格文件的语法如下:
<?xml version="1.0" encoding="UTF-8"?><br> <component><br> ......<br> <property name="<property name>"<br> get="<getter method>"<br> set="<setter method>"<br> type="<property type>"<br> default="<default value>" /><br> ......<br> </component><br>
在这里,name 用来唯一标识属性;get 定义了一个类方法来读取属性,set 定义了一个类方法来写属性,type 定义了属性的类型(string, integer, float, boolean, array 和object),default 标识了属性的缺省值。其中name 属性是必须的。getter方法的语法如下:
function getterMethodName()<br> {<br> ....<br> return $value.<br> }
如果一个属性是不可读的,那么不要设置get 属性。setter方法的语法如下:
function setterMethodName($value)<br> {<br> // set some variable with $value<br> }
如果一个属性是不可写的,那么不要设置set 属性。如果这个属性的类型是string,那么也可以不指明。类型的属性用来自动转换配置在规格文件或者模板文件中的属性初始值。default
属性一般用来作为引用的目的,也是可选的。如果一个属性是可读的而且之前没有被设置,那么getter方法应该返回一个缺省值。
可以用下面的语法定义组件的组件属性:
<?xml version="1.0" encoding="UTF-8"?><br> <component><br> ......<br> <component type="component type" ID="component ID"><br> <property name="property name" value="property value"/><br> ....<br> <event name="event name" handler="function name"/><br> ....<br> </component><br> ......<br> </component>
这里type 属性指明了组件类的名称,IDID 属性指明了属性名称。property 元素和event 元素指明了对应的初值。
当组件被创建的时候,它的组件类型属性会自动被实例化。
2.4.2 定义事件
组件事件在规格文件中定义,而其内在的实现机制在类文件中定义。在规格文件中定义事件的语法如下:
<?xml version="1.0" encoding="UTF-8"?><br> <component><br> ......<br> <event name="..." /><br> ......<br> </component>
事件的name应该是一个合法的变量名。
在类文件中,通常会实现这么一个对应的方法(假定事件的名称叫 OnClick):
function onClick($param)<br> {<br> $this->raiseEvent('OnClick',$this,$param);<br> }<br>
当这个事件实际发生的时候,这个 onClick 方法应该确实被调用了(参考框架的TButton.php
文件)。raiseEvent 方法在TComponent 类中实现,它调用了所有对应OnClick 的事件响应函数,并把参数$param 传递给它们。
2.4.3 编写模板文件
在这一节里,会讲一些关于如何编写模板文件。模板是用于控件的,当时也不是所有的控件都需要模板。比如TTextBox, TButton 这些控件因为没有内容,因此就不需要模板。模板文件一般用于页面或者基于组合定义的控件。
模板中的注释,比如 被作为静态文本处理。
可以在组件标签之外通过属性标签
...<br> <com:TTextBox ID="profile"><br> <prop:Text><br> ...<br> </prop:Text><br> </com:TTextBox><br> ...<br>
在一对属性标签中间的内容作为对应的组件属性的值。如果一些属性的值需要很大的数据,这样就很方便。
在模板文件中可以使用3种特殊的标签:
2.5 总结
这一节我们来总结一下如何基于PRADO来开发一个Web应用。
首先需要创建两个文件:应用的入口文件和应用的配置文件。这一部分请参考本手册前面的"Hellow,world!"这个例子。
完全な Web アプリケーションを作成するには、1 つ以上のページを作成する必要もあります。各ページにはページ クラス ファイルが必要で、場合によってはテンプレート ファイルまたは仕様ファイルも必要になります。テンプレート ファイルでは、ユーザーに表示する必要がある最終的な外観に応じて、コンポーネントとその他の静的テキストをグループ化できます。仕様ファイルでは、ページのプロパティ、イベント、およびサブコントロールを定義でき、これらの定義はテンプレート ファイルおよびコードで使用できます。どちらもコンポーネントの初期値と指定したイベントの応答関数を設定できます。イベント応答関数などをページクラスファイルに記述します。
コードを再利用するために、新しいコンポーネントを定義できる場合があります。たとえば、ユーザーに表示されるメニューを表示する SideBar コンポーネントを定義すると、この SideBar コンポーネントを直接使用して各ページにメニューを表示できます。
PRADO では、スタック内のエラー情報を表示できる PHP5 の新しい例外処理メカニズムが導入されています。こうすることで、デバッグ時にどのメソッドでどのエラーが発生したかを正確に見つけることができます。
PRADO アプリケーションの公開は非常に簡単です。フレームワークでは相対パスの使用を推奨しているため、相対パスを使用する場合は、アプリケーションを含むコードを、それを配置するディレクトリにコピーするだけです。