第四十三章在CSP应用程序中本地化文本 - 本地化的基础

本地化的基础

当本地化应用程序的文本时，将用一种语言创建文本字符串的目录，然后建立一种约定，在应用程序地区不同时用另一种语言替换这些消息的翻译版本。

Caché支持以下本地化字符串的过程:

开发人员在他们的代码中包含可本地化的字符串。
在CSP应用程序中，最简单的方法是使用基于类的开发并使用$$$Text宏之一。
在硬编码字面值字符串的地方，包含$$$Text宏(或相关宏)的实例，为宏参数提供如下值:

&html<"Hello world">

包括:

set hello=$$$Text("Hello world","sampledomain","en-us")
&html<#(hello)#>

编译代码时，编译器为$$$Text宏(及其相关宏)的每个惟一实例在消息字典中生成条目。
消息字典是全局的，因此可以很容易地在管理门户中查看(例如)。
Caché提供类方法来帮助完成常见任务。
开发完成后，发布工程师为该域或所有域导出消息字典。

结果是一个或多个包含原始语言文本字符串的XML消息文件。

Caché提供了三个相关的$$$Text宏(在%occMessages中)。
包含在%occInclude.inc中):

每个宏都有三个参数:默认字符串、该字符串所属的域以及默认字符串的语言代码。编译代码时，编译器会在消息字典中为每组唯一的参数值生成条目。

$$$Text返回的%String可能会被赋给一个变量，可以用它来表示后续调用中的消息。例如:

 Set tmsg = $$$TextJS("Error saving production")
 &js

或者，可以在需要字符串的任何地方插入一个$$$Text宏:

&js

形式上，$$$Text、$$$TextJS和$$$TextHTML宏按顺序接受下列参数:

domain - (可选)为新消息指定域的字符串。如果未指定，domain默认为编译时DOMAIN类参数的值和%response。运行时的域。

(可选)RFC 1766在指定语言的新标签代码中打开。Caché将该字符串转换为全小写。如果未指定，语言默认如下:
- 编译时:$$$DefaultLanguage。
- 在运行时：%Response.Language，或者如果没有为%Response.Language定义值，则$DefaultLanguage。
language - 基于标签的CSP页面会自动从浏览器设置中获取%Response.Language的值，因此它可以作为默认语言使用。对于基于类的CSP页面则不是这样，它必须显式地为%Response.Language设置一个值以将其用作默认值。可以通过在类方法MatchLanguage()中为%Response.Language赋予%Library.MessageDictionary的返回值来为其赋值，本章稍后将对此进行讨论。在给定语言列表和域名的情况下，此方法使用HTTP1.1匹配规则(RFC2616在)在域中查找最佳匹配语言。

编译包含$TEXT、$TextJS或$TextHTML宏的调用的类时，每次调用都会在消息字典中生成一条消息，其中包含宏参数提供的文本、消息ID、域和语言。

第一次通过$$$Text将消息添加到域中时，无论是否指定了语言参数，都会使用$$$SessionLanguage。同一域的后续$$$Text宏会添加与第一个添加的消息语言相同的消息。

如果消息文本包含参数(%1，%2，%3，%4)，必须在显示文本之前指定相应的替换文本。因为$$$Text返回一个字符串，所以可以使用编码语言自带的任何字符串操作。例如，在JavaScript中:

 var prompt = '#($$$TextHTML("Remove user %1 from this Role?"))#';
 prompt = prompt.replace(/%1/g,member.userName);

还可以使用$$$$Text 字符串作为%response的第一个参数。FormatText方法或$$$FormatText宏。