第三十三章 使用 CSP 进行基于标签的开发 - 使用Hyperevents #server和#call调用服务器端方法

使用Hyperevents #server和#call调用服务器端方法

hyperevent是我们对web浏览器事件的CSP扩展，是一种用于创建交互式web动作的web开发技术。使用hyperevents，可以在Caché服务器上运行类的方法来响应客户端web浏览器中的事件，而无需在客户端重新加载HTML页面。在更广阔的世界里，这种能力通常被称为AJAX。Caché hyperevents在许多情况下非常有用，特别是在数据库应用程序中，可能希望对数据库执行验证或搜索功能，而不必重新加载和重新格式化整个网页。通常，超级事件是使用XMLHttpRequest实现的。

如果正在使用类开发CSP页，则需要调用..HyperEventHead方法在< Head >部分的输出期间加载hyperevents所需的JavaScript。

使用#server调用服务器端方法

在CSP文件中，可以使用#server指令调用服务器端方法。可以在任何允许JavaScript的地方使用这个指令。

#server指令的语法是:

#server(classname.methodname(args,...))#

其中classname是服务器端Caché类的名称，methodname是该类中方法的名称。args是传递给服务器端方法的客户端JavaScript参数列表。注意，开始和结束#符号之间的所有代码必须都在一行上。

例如，要调用Caché类MyPackage中名为Test的服务器端方法，请使用:

<script language="JavaScript">
function test(value)
{
   // invoke server-side method Test
   #server(MyPackage.Test(value))#;
}
</script>

CSP编译器将每次出现的#server指令替换为调用服务器端方法的JavaScript代码。

从给定的CSP页面，可以调用属于为其生成的类的方法，方法使用..方法名语法。例如:

#server(..MyMethod(arg))#

使用#call调用服务器端方法

同步性由被调用的方法、#server或#call决定。#server是同步的；##call是异步的。

同步调用可能会导致UI响应明显暂停(挂起)。然而，异步调用有其自身的优点和问题。例如，如果用户在网页上输入一个值，页面不会立即更新；更新时，用户可能已经移动到另一个页面。

server同步。

当调用服务器端方法时，#server向客户端返回一个值(因为客户端正在等待)*，*返回JavaScript供客户端执行

#call是异步的:当调用服务器端方法时，#call不等待返回值。
相反，应用程序依赖于服务器发回的JavaScript在客户机上执行任何需要的操作。

当使用异步##call时，在进行多个连续调用时必须非常小心。
如果在前一个方法完成之前通过#call调用了一个方法，web服务器可能会决定取消你前一个方法调用。
或者用户可能在JavaScript执行之前转移到另一个页面，因此JavaScript在错误的页面上执行，从而导致错误。
因此，大多数情况下，在启动可能需要一段时间的工作时使用#call，并提供指向显示长时间运行的job状态的另一个页面的链接。

和#server一样，可以在任何允许JavaScript的地方使用#call指令。

#call指令的语法是:

#call(classname.methodname(args,...))#

其中classname是服务器端Caché类的名称，methodname是类中的方法的名称。
args是传递给服务器端方法的客户端JavaScript参数列表。
注意，在#号开始和结束之间的所有代码都必须在一行中。

例如，要在Caché类MyPackage中调用一个名为Test的服务器端方法，使用:

<script language="JavaScript">
function test(value)
{
  // invoke server-side method Test
  #call(MyPackage.Test(value))#;
}
</script>

CSP编译器用调用服务器端方法的JavaScript代码替换#call指令的每次出现。

从给定的CSP页面，可以使用..调用属于为其生成的类的方法。
MethodName语法。
例如:

#call(..MyMethod(arg))#