第三十二章 使用 CSP 进行基于标签的开发 - 服务器端方法
第三十二章 使用 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
以供浏览器显示。这可能是当前表单或不同页面的重新显示。