47.3. 方法别名
概述 复制链接链接已复制到粘贴板!
复制链接链接已复制到粘贴板!
除了 Java API 中显示的标准方法名称外,对于给定方法定义附加名称(别名)通常很有用。特别常见的是,您可以允许将属性名称(如 widget)用作 accessor 方法的别名(如 getWidget 或 setWidget)。
语法 复制链接链接已复制到粘贴板!
复制链接链接已复制到粘贴板!
alias 元素可使用一个或多个别名子元素定义,如下所示:
其中 MethodPattern 是 Java API 中匹配方法名称的正则表达式(java.util.regex 语法),模式通常包含捕获组。Alias 是替换表达式(在 URI 中使用),它可使用以上捕获组中的文本(例如,指定为 $1、$2、$2 或 $3 (第一个、第二个或第三个捕获组)中的文本。
影响范围 复制链接链接已复制到粘贴板!
复制链接链接已复制到粘贴板!
如以下提取所示,别名 元素可以选择性地显示为 apis 元素的子项和/或作为 api 元素的子项:
您可以在以下范围内定义 别名 元素:
-
作为
api元素 containerruntime- alias mappings 的子项 ,别名映射只适用于api元素指定的 API 类。 -
作为
apis元素 modprobe- alias 的子项 映射默认应用于所有 API 类,但可以在api级别覆盖。
Example 复制链接链接已复制到粘贴板!
复制链接链接已复制到粘贴板!
以下示例演示了如何为 common get/set bean 方法模式生成别名:
在前面的别名定义中,您可以使用 widget 作为方法 getWidget 或 setWidget 的别名。请注意,使用捕获组 (.+) 来捕获方法名称中的后一部分(如 Widget)。