分类：
2008-05-17 16:17:14
XForms 库：下一个任务是什么？
此时，您所拥有的 PHP 库基本上可以正常运作，但是还未进行过测试。现在，我们来改善输出的外观、验证函数的输入（XForms 预处理器错误并非总是有用），并查看库的操作演示。
因此，现在开始执行这些任务。
库的核心部分现已完成，因此可继续对 PHP XForms 库进行增强，比如构建一些简单的抛出异常和处理异常的功能，这些功能会很有用，因为并非所有输入的设置都可以接受，或者说在结果的 XHTML 文档中会不可避免地出现错误。另外，您需要一些便利的函数将 XHTML 输出到 Web 浏览器，以及正确地处理数据缩进。我们从错误检查开始介绍。
在本节中，通过向库中添加错误检查，可以减少 XForms 处理器中需要调试的错误，从而减少编程时间。处理完这一切后对编程有很大帮助。您将以两种方式执行错误检查：
首先，转到 xforms_lib.php 类文件中的变量列表，添加另外两个变量，如清单 1 所示。
...
var $namespaceEvents;
var $allowed;
var $tag;
function xforms_lib($ns, $nsxforms, $nsevents){
...
$this->tag = '';
$this->allowed =
array('action' => array('dispatch', 'insert',
'setvalue', 'load'),
'model' => array('instance', 'submission',
'bind', 'action'),
'trigger' => array('label', 'action'),
'root' => array('trigger', 'submit', 'select1',
'repeat', 'input', 'output',
'label', 'model'));
... |
接下来，您将修改 dispatchTag 以利用这种新功能，如清单 2 所示。
function dispatchTag($name, $target){
$this->check('dispatch');
$xml = ' |
check（这个函数稍后将做定义）。其余部分应相同。
现在，您将定义 check 函数，由此函数执行实际的检查，如清单 3 所示。
function check($newTag, $action=''){
$openTag = $this->tag;
if($openTag == '')
$openTag = 'root';
if($action == 'close' && ($openTag != $newTag || $openTag == 'root'))
throw new Exception("Cannot close $openTag with a $newTag ".
"\"close tag\"statement!");
else if($action == 'close' && $openTag == $newTag)
return;
else if(!in_array($newTag, $this->allowed["$openTag"]))
throw new Exception("$newTag is not allowed within $openTag!");
} |
if 语句：注意，如果空字符串 ('') 是 $tag 类变量的当前值，则 $openTag 参数默认为 ‘root’。
if 语句：如果 $openTag 中指定的打开标记已关闭，且打开标记（$openTag）与关闭的标记（$newTag）不同（或打开标记是 root 标记，因为后者不能被关闭），则会抛出一个错误。
else if 语句：另一方面，如果关闭的标记（$newTag）与打开标记（$openTag）相等，则不会出现错误。
else if 语句：尽管如此，如果打开的/创建的标记（$newTag）不是当前打开标记（$openTag）中允许打开的标记（比如，尝试在 action 标记中创建的一个 repeat 标记），则会抛出一个错误。这里错误将被捕获并显示给用户。 现在，您将使用 check 函数，方法是将 check 语句添加到函数的其余部分，清单 4 中显示的部分内容可以作为您的指导（其余部分纱?源代码下载 获得）。
function loadTag($resource = '', $ref = '', $show='replace'){
$this->check('load');
$xml = ' |
$this->check() 函数调用。注意在 triggerTagOpen 和 triggerTagClose 函数中调用 check 函数的区别，在 triggerTagClose 函数中，需要根据标记的打开、关闭情况传入第二个参数（‘open’ 或 ‘close’）。
现在您将创建函数设置当前的打开标记（$this->tag），目前 清单 3 中引用了该标记。您将使用此函数设置当前打开标记的值，如清单 5 所示。
function setTag($t){
$this->tag = $t;
}
|
setTag('model')。在关闭标记后，您将不继续在 XForms XHTML 标记下操作，而执行如下调用：setTag('root')，将当前的开放标记重新设置为 root。
现在，系统出现错误时将通过抛出异常来验证输入。只有以下五个函数需要这种错误检查功能：submission、bind、load、select1 和 instance。从 submission 开始介绍，如清单 6 所示。
function submissionTag($id, $action, $method = 'post', $ref='',
$instance = '', $replace = ''){
$this->check('submission');
if(($instance != '' || $replace != '') &&
$replace != '' && $instance != '')
throw new Exception("instance or replace is set, but not both ".
"in a submission tag!");
$xml = ' |
该思想在四个函数中类似，如清单 7 所示。
function bindTag($nodeset, $relevant = '', $calculate = '',
$required = ''){
$this->check('bind');
if($relevant == '' && $calculate == '' && $required == '')
throw new Exception("Must set one of: relevant, calculate or ".
"required in a bind tag!");
$xml = ' |
bindTag 函数的输入 $required、$calculate 或 $required 中，必须要设置其中一个。对于 loadTag 函数，$resource 和 $ref 输入不能同时设置，但是必须设置其中一个。select1Tag 函数也需要设置 $itemArray 和 $itemset 中的一个但不能同时设置。最后，instanceTag 函数要求对 $instanceXML 和 $src 都不进行设置。
至此，错误处理一节全部结束。稍后在测试一节中，您将了解如何处理抛出的错误并将错误消息显示给用户。
要完成错误处理，您需要添加几个便利函数，帮助开发人员在 XForms 开发中使用 PHP。
首先，您将再定义几个类变量，如清单 8 所示。
var $allowed;
var $print;
var $indentation;
var $indentationValue;
function xforms_lib($ns, $nsxforms, $nsevents){
...
$this->namespaceEvents = $nsevents;
$this->print = 0;
$this->indentation = 0;
$this->indentationValue = " ";
$this->allowed =
...
}
|
printData（稍后定义）在类函数中将 XHTML 直接输出到浏览器（用 echo 语句）。$indentation 变量指定了调用 indentation 函数（稍后定义）时所需输出的缩进级数，$indentationValue 变量指定了需要显示为缩进的内容（这里有四个空间用作 $indentationValue）。
现在，您将创建几个函数设置 $print、$indentation 计数增减量的值，如清单 9 所示。
function incrementIndentation(){
$this->indentation++;
}
function decrementIndentation(){
$this->indentation--;
}
function setPrint($p){
if($p)
$this->print = 1;
else
$this->print = 0;
} |
前两个函数对构造函数中初始化为零的类变量 $indentation 进行增减，而第三个函数将 $print 设置为 1，前提是传入的变量为 true；否则，$print 设置为 0。
下一个函数显示了缩进，如清单 10 所示。
function indentation(){
$xml = '';
for($i = $this->indentation; $i > 0; $i--)
$xml .= $this->indentationValue;
return $xml;
}
|
decrementIndentation 及 incrementIndentation 函数使得到的 XHTML 代码具有正确的缩进格式。
清单 11 展示了如何使用 printData 函数显示 XHTML。
function printData($xml){
if($this->print){
echo $this->indentation();
echo $xml."\r\n";
return 0;
}
return 1;
} |
每个函数的末尾调用 printData 函数，根据 $print 类变量的值返回 XHTML 数据，或显示到浏览器。将其添加到所有的标记创建函数中，如清单 12 中的示例所示。将 incrementIndentation 函数添加到所有的 tagOpen 函数中，并将 decrementIndentation 添加到所有的 tagClose 函数中。
function submissionTag($id, $action, $method = 'post', $ref='',
$instance = '', $replace = ''){
$this->check('submission');
...
$xml .= ' replace="'.$replace.'"';
$xml .= " />";
$this->printData($xml);
return $xml;
}
function triggerTagOpen($ref, $submission = '', $label = 'default'){
$this->check('trigger', 'open');
$xml = ' |
这里，您会发现上面 清单 12 中的每个函数都使用了 $this->printData 函数。注意，即使已经调用 printData 在浏览器上显示数据，XHTML 数据仍然会返回到调用函数的语句。还要注意，triggerTagOpen 函数使用 incrementIndentation 函数的方式。因此，在打开 trigger 标记后所有内容都将拥有额外的缩进，直至调用 triggerTagClose 关闭 trigger 标记。这将在调用 triggerTagOpen 函数之前将缩进减至原始值。
将 $this->printData($xml); 语句添加到函数其余部分的适当位置（您可以使用 源代码下载 作为指导）。另外，将 $this->decrementIndentation(); 语句添加到所有的 tagClose 语句中，并将 $this->incrementIndentation(); 语句添加到所有的 tagOpen 语句中，使用 清单 12 和 源代码下载 作为指导。
最后，还有几个便利函数让您更轻松地使用 PHP XForms 库，如清单 13 所示。您可以在 PHP 文件中使用这些函数显示所需的常见 标记。
function doctypeTag(){
$xml = '';
$this->printData($xml);
return $xml;
}
function headTitle($title){
$xml = " |