47.3. 메서드 별칭

종종 Java API에 표시되는 표준 메서드 이름 외에 지정된 메서드에 대한 추가 이름(별칭)을 정의하는 것이 유용할 수 있습니다. 특히 일반적인 경우는 속성 이름(예: 위젯)을 접근자 메서드(예: getWidget 또는 setWidget)의 별칭으로 사용할 수 있도록 허용하는 위치입니다.

aliases 요소는 다음과 같이 하나 이상의 alias 하위 요소로 정의할 수 있습니다.

<aliases>
  <alias>
    <methodPattern>MethodPattern</methodPattern>
    <methodAlias>Alias</methodAlias>
  </alias>
  ...
</aliases>

여기서 MethodPattern 은 Java API에서 메서드 이름과 일치하는 정규식(java.util.regex 구문)이며 일반적으로 패턴에는 캡처 그룹을 포함합니다. 별칭 은 이전 캡처 그룹의 텍스트를 사용할 수 있는 대체 표현식입니다(예: 첫 번째, 두 번째 또는 세 번째 캡처 그룹의 텍스트에 대해 $ 1,2 로 지정 또는 $3 ).

다음 추출에 표시된 것처럼 aliases 요소는 선택적으로 apis 요소의 자식으로 및/또는 api 요소의 자식으로 표시될 수 있습니다.

<configuration>
  <apis>
    <api>
      <apiName>...</apiName>
      ...
      <aliases>...</aliases>
    </api>
    <aliases>...</aliases>
    ...
  </apis>
</configuration>

다음 범위에서 aliases 요소를 정의할 수 있습니다.

다음 예제에서는 공통 get/set useful 메서드 패턴에 대한 별칭을 생성하는 방법을 보여줍니다.

<aliases>
  <alias>
    <methodPattern>[gs]et(.+)</methodPattern>
    <methodAlias>$1</methodAlias>
  </alias>
</aliases>

이전 별칭 정의를 사용하면 getWidget 또는 setWidget 중 하나의 별칭으로 위젯 을 사용할 수 있습니다. 캡처 그룹 (.+) 을 사용하여 메서드 이름의 후자 부분(예: )을 캡처합니다.