第十章 扩展数据块

描述XData块的结构。

介绍

XData块是包含在类定义中的命名数据单元，通常由类中的方法使用。最常见的情况是，它是一个XML文档，但是它可以由其他形式的数据组成，例如JSON或YAML。

详情

XData块具有以下结构:

/// description 
XData name [ keyword_list ]  
{ 
data 
}

• description 描述(可选)旨在显示在“类别参考”中。默认情况下，描述为空白。
• name(必需)是XData块的名称。这必须是有效的类成员名称，并且不能与任何其他类成员名称冲突。
• data 数据(可选)包含扩展数据块的有效载荷。如果是XML，则它必须是格式良好的文档(只有一个根元素)，开头没有XML声明。
• keyword_list(可选)是以逗号分隔的关键字列表，进一步定义了XData块。如果省略此列表，也要省略方括号。

示例

Class Demo.CoffeeMakerRESTServer Extends %CSP.REST
 {
  Parameter HandleCorsRequest = 1

  XData UrlMap [ XMLNamespace = "http://www.intersystems.com/urlmap" ]
  {
    <Routes>
      <Route Url="/test" Method="GET" Call="test"/>
      <Route Url="/coffeemakers" Method="GET" Call="GetAll" /> 
      <Route Url="/coffeemaker/:id" Method="GET" Call="GetCoffeeMakerInfo" /> 
      <Route Url="/newcoffeemaker" Method="POST" Call="NewMaker" /> 
      <Route Url="/coffeemaker/:id" Method="PUT" Call="EditMaker" /> 
      <Route Url="/coffeemaker/:id" Method="DELETE" Call="RemoveCoffeemaker"/>
   </Routes> 
  }