第十章 Caché 嵌入式代码
嵌入式HTML
嵌入的HTML语句通过&html指令与其余代码分开，如下例所示：
/// d ##class(PHA.TEST.ObjectScript).TestHTML()
ClassMethod TestHTML()
{
WRITE "start",!
&html<
I'm bold!
I'm italic
I'm underlined
>
WRITE "end"
}
DHC-APP>d ##class(PHA.TEST.ObjectScript).TestHTML()
start
I'm bold!
I'm italic
I'm underlined
end
-
&html指令必须缩进；它不能出现在第1列中。 -
&html指令不区分大小写；您可以指定&HTML,&Html,&html. -
&html指令可以与标签、命令或/* ... */注释出现在同一行。与所有ObjectScript代码一样，它必须与前面至少有两个空格的无参数命令分开。 -
&html指令后面跟一个左尖括号，中间没有空格、换行符或注释。嵌入的HTML代码由右尖括号结束。 - 嵌入的HTML和右尖括号中的HTML代码不必缩进。它们可以出现在第1列中，但是为了代码的清晰性，建议使用缩进。
- HTML代码不必包含
结构标记(或任何其他结构标记)；但是，完全支持结构标记。
&html指令的正文应该包含有效的HTML标记。可以使用缩进和空格以任何喜欢的方式设置HTML格式。HTML代码中的空行将被保留。Studio识别&html指令，并使用着色器对HTML标记进行语法着色。
宏预处理器在ObjectScript解析器处理任何嵌入的HTML代码之前展开宏。嵌入式HTML中不支持宏处理。例如，不能在嵌入的HTML中使用##；单行注释。但是，可以在嵌入的HTML代码中使用宏预处理器的结果，如下面的示例所示：
/// d ##class(PHA.TEST.ObjectScript).TestHTMLM()
ClassMethod TestHTMLM()
{
#Define NumFunc ##Expression(17+4)
WRITE "start",!
&html<
I'm bold!
I'm italic $$$NumFunc
I'm underlined
>
WRITE "end"
}
DHC-APP>d ##class(PHA.TEST.ObjectScript).TestHTMLM()
start
I'm bold!
I'm italic 21
I'm underlined
end
&html标记语法
可以使用用户定义的标记语法来标识特定的&html指令。此语法由“&html”和左尖括号字符之间指定的字符或字符串组成。此标记的反面必须紧跟在嵌入HTML末尾的右尖括号之后。以下示例使用7作为标记字符：
WRITE "start",!
&html7<
I'm bold!
I'm italic
I'm underlined
>7
WRITE "end"
请注意，在&html、标记和左尖括号之间不允许有空格(空格、制表符或换行符)，在结束尖括号和反转标记之间也不允许有空格。
标记可以是单个字符，也可以是一系列字符。标记不能包含以下标点符号：
<({ + - / \ | * })>
标记不能包含空格字符(空格、制表符或换行符)。它可能包含所有其他可打印字符和字符组合，包括Unicode字符。标记和反转标记区分大小写。
相应的反向标记必须包含与反向顺序的标记相同的字符。例如：&htmlABC< ... >CBA.如果标记包含[或(字符，反转标记必须包含相应的]或)字符。
以下是有效&html标记和反向标记对的示例：
/// d ##class(PHA.TEST.ObjectScript).TestHTMLM1()
ClassMethod TestHTMLM1()
{
&html@@< Be bold! >@@
&html[< Be bold! >]
&htmlMyTest< Be bold! >tseTyM
&htmlA16[a< Be bold! >a]61A
}
DHC-APP>d ##class(PHA.TEST.ObjectScript).TestHTMLM1()
Be bold!
Be bold!
Be bold!
Be bold!
选择标记字符或字符串时，请注意以下重要限制：HTML代码不能在代码中的任何位置包含字符序列“>reversemarker”，包括文字字符串和注释。例如，如果标记是“ABC”，则字符串“>CBA”不能出现在嵌入的HTML中的任何位置。
嵌入式JavaScript
嵌入式JavaScript允许您在ObjectScript程序中包含JavaScript代码。可以使用嵌入式JavaScript指令的以下任何语法形式：
/// d ##class(PHA.TEST.ObjectScript).TestJS()
ClassMethod TestJS()
{
&js< JavaScript code >
&jscript< JavaScript code >
&javascript< JavaScript code >
}
/// d ##class(PHA.TEST.ObjectScript).TestJS()
ClassMethod TestJS()
{
&js< var s=1 >
&jscript< var s= s+1 >
&javascript< var s= s+2 >
}
DHC-APP>d ##class(PHA.TEST.ObjectScript).TestJS()
JavaScript code
JavaScript code
JavaScript code
嵌入式JavaScript指令的语法和解析(包括标记语法的使用)与嵌入式HTML相同。
嵌入式SQL
嵌入式SQL允许在ObjectScript程序中包含SQL代码。语法为&sql()。例如：
/// d ##class(PHA.TEST.ObjectScript).TestSQL1()
ClassMethod TestSQL1()
{
&sql( SELECT Name INTO :n FROM Sample.Person )
WRITE "name is: ",n
}
DHC-APP>d ##class(PHA.TEST.ObjectScript).TestSQL1()
name is: Adams,Diane F.