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