Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

47.3. 方法别名

概述
复制链接

除了 Java API 中显示的标准方法外，除了出现在 Java API 中的标准方法名称外，为给定方法定义其他名称（别名）通常很有用。特别常见的情形是允许属性名称（如 小部件）用作访问器方法的别名（如 getWidget 或 setWidget）。

语法
复制链接

alias 元素可以使用一个或多个别名子元素定义，如下所示： 

<aliases>
  <alias>
    <methodPattern>MethodPattern</methodPattern>
    <methodAlias>Alias</methodAlias>
  </alias>
  ...
</aliases>
Copy to Clipboard Toggle word wrap

其中 MethodPattern 是一个正则表达式(java.util.regex 语法)，用于匹配 Java API 中的方法名称，其模式通常包含捕获组。Alias 是替换表达式（用于 URI），它可以使用前面捕获组的文本（例如，指定为 $1、$2 或 $3，用于来自第一个、第二个或第三个捕获组的文本）。

影响范围
复制链接

如以下提取所示，alias 元素可以选择性地显示为 apis 元素的子级和/或作为 api 元素的子级： 

<configuration>
  <apis>
    <api>
      <apiName>...</apiName>
      ...
      <aliases>...</aliases>
    </api>
    <aliases>...</aliases>
    ...
  </apis>
</configuration>
Copy to Clipboard Toggle word wrap

您可以在以下范围中定义 aliases 元素：

  • 作为 api 元素的子级 ，则 别名 映射仅应用到 api 元素指定的 API 类。
  • 作为 apis 元素的子级 ，它默认应用于所有 API 类，但可以在 api 级别上覆盖。

Example
复制链接

以下示例演示了如何为通用 get/set bean 方法模式生成别名： 

<aliases>
  <alias>
    <methodPattern>[gs]et(.+)</methodPattern>
    <methodAlias>$1</methodAlias>
  </alias>
</aliases>
Copy to Clipboard Toggle word wrap

使用前面的别名定义，您可以使用 小部件 作为任一方法 getWidget 或 setWidget 的别名。请注意，使用 capture 组 (.+) 来捕获方法名称的后者部分（如 Widget）。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat