第三十二章 使用 CSP 进行基于标签的开发 - 服务器端方法
CSP提供了两种从HTML客户机调用服务器端方法的技术。
- 使用
HTTP提交机制。 - 使用超事件，
#server(同步)或#call(异步)。
也可以使用%CSP.Page的HyperEventCall()方法。
使用HTTP Submit的优点是客户端编程简单，不需要客户端组件。
它的缺点是在方法调用之后由客户机重新绘制页面，并且服务器端编程更加困难。
如果使用超级事件，#SERVER和#CALL是使用XMLHttpRequest来实现的。#Call是异步的：如果(作为用户)在网页上输入值，则该页面不会立即更新；在更新时，可能已移动到另一个页面。#SERVER是同步的；页面在从调用返回时立即更新。
请注意，同步XMLHttpRequest已被许多浏览器弃用，通常情况下，移动趋势是只支持异步XMLHttpRequest.
HTTP提交和超级事件将在以下各节中进一步描述。
Caché and AJAX
缩写AJAX通常用来指代一组技术，这些技术允许从服务器更新客户端页面的数据，而不必请求新的浏览器页面。Caché超链接允许AJAX交互，而不需要程序员处理所有与服务器的通信。允许AJAX事务的两种方式:
- 对于
CSP，使用#server()和#call()命令允许从客户端直接调用服务器端方法。(也可以使用%CSP.Page的HyperEventCall()方法。) - 对于
Zen，程序员可以定义ZenMethods来处理客户端-服务器交互。这些可能是同步的，也可能是异步的，具体取决于方法签名:
同步AJAX请求的签名
Method XYZ(arg) as %Status [ZenMethod]
异步AJAX请求的签名
Method XYZ() [ZenMethod]
用Ajax实现并行处理
由于^%cspSession全局节点上的锁，对CSP的AJAX请求在服务器上按顺序处理。要使AJAX请求能够并行处理，如果正在使用的应用程序没有在会话全局/对象中设置任何内容(因此只读)，可以使用%CSP.Session.Unlock()方法为该会话和%Session.Lock解锁该会话的CSP全局。
通过HTTP提交调用服务器端方法
使用HTTP提交调用服务器代码只需要很少的浏览器功能。对于拥有广泛受众并且必须支持多种浏览器的应用程序来说，这是一种很好的技术。使用HTTP提交时，用户每次单击提交按钮时都会重新显示请求的页面。
可以通过以下方式处理HTTP提交：
- 提供包含提交按钮的
HTML表单：
<form name="MyForm" action="MyPage.csp" method="GET">
User Name: <input type="TEXT" name="USERNAME"><br>
<input type="SUBMIT" name="BUTTON1" value="OK">
</form>
它定义了一个简单的表单，其中包含一个名为UserName的文本字段和一个名为BUTTON1的提交按钮。表单的action属性指定表单提交到的URL。方法属性指定使用哪种HTTP协议提交表单：POST或GET。
- 当用户单击提交按钮
BUTTON1时，浏览器将收集表单中所有控件的值，并将它们提交给表单的action属性指定的URL。(请注意，页面可以通过使用action属性指定其名称或将action属性保留为空来提交回其自身。)。无论表单是通过POST还是GET提交的，CSP都会将提交的值视为URL参数。在这种情况下，提交表单相当于请求以下URL：
MyPage.csp?USERNAME=Elvis&BUTTON1=OK
包括SUBMIT按钮的名称和值。
如果表单上有多个SUBMIT按钮，则请求中只包含实际按下的数据按钮。
这是检测何时发生SUBMIT的关键。
- 服务器代码(在本例中是
MyPage.csp)检测到提交已经发生。这是通过测试%request对象中的名称BUTTON1来实现的:
<script language="Cache" runat="SERVER">
// test for a submit button
If ($Data(%request.Data("BUTTON1",1))) {
// this is a submit; call our method
Do ..MyMethod($Get(%request.Data("USERNAME",1)))
}
</script>
- 在调用所需的服务器端逻辑后，服务器代码继续运行并返回
HTML以供浏览器显示。这可能是当前表单或不同页面的重新显示。