Interception?

서���

플러그인 개���자��� 플러그인에서 필요한 기능을 구현하기 위해서는 XpressEngine 코어의 동작이 실행되는 시점에 플러그인이 끼어들어 코어의 행동을 바꾸거나 추���적인 행동을 할 수 있어야 합니다.

예를 들어, 사이트에 새���운 회원이 가입할 때, 가입한 회원에��� 가입���하 메일을 보내는 기능을 플러그인으로 만들 수 있습니다. 코어가 회원���입을 처리할 때, 플러그인이 끼어들어 메일을 전송해야 합니다.

이러한 '끼어들��'�� 일반적으로 hook 또는 event라고 칭합니다. XpressEngine1에서는 trigger라는 명칭을 사용했습니다. XpressEngine3에서는 '가������다'는 의미의 interception이라는 명칭을 사용합니다.

XpressEngine3에서는 interception을 구현하기 위하여 AOP�� 사용하였습니다. AOP는 Aspect Oriented Programming의 약어입니다.

기본 사용법

위에서의 예와 같이 XpressEngine에서 회원���입을 처리할 때, 메일 전송 코드��� 실행되도��� 하려�� intercept() 함수를 사용할 수 있습니다.

		
		
// 가입 축하 메일 보내�� 등록
intercept('Member@create', 'welcome_mail::send_mail', function($createMember, array $data) use ($mailer) {

// 회원���입 코드를 실행
$member = $createMember($data);

// 메일 전송
$mailer->sendWelcomeMail($member->email, $member->getDisplayName);

// 회원���입 처리 결과 반환
return $member;
});

intercept 함수의 원형은 아래와 같습니다.

intercept($pointCut, $name, Closure $advice)

파라메터

• 첫���째 파라메터 $pointCut 포인트��(pointcut)은 '끼어들��'�� 할 타��� 메소드를 칭합니다. 위의 예에서는 Member@create에 해당합니다. 사용가능한 포인트컷의 목���은 이 페이지 아래에 명시되어 있습니다.

• 두���째 파라메터 $advisor AOP에서 '끼어들��'�� 하는 주체�� 어드���이저(Advisor)라고 합니다. 두���째 파라메터인 $name은 이 어드���이저의 '이름'입니다. 원하는 이름을 하나 지정하십시오. 단 이 이름은 다�� 어드���이저와 중복되��� 않아야 합니다. 해당 플러그인의 아이디(디렉토리명)�� 이름의 접두사로 사용하십시오. 위의 예에서는 welcome_mail::send_mail에 해당하며, welcome_mail이 플러그인 아이디에 해당합니다. ::을 사용하여 접두사�� 연결하십시오.

• 세번째 파라메터 $advice 세번째 파라메터인 $advice는 '끼어들��'�� 한 후 실행될 코드입니다. 클로저 형식으로 입력해야 합니다. 이 클로저 내부에서는 반드시 타��� 메소드(회원���입���소드)�� 실행해주어야 합니다.(데코레이터 패턴) 타��� 메소드는 첫���째 파라메터($createMember)�� 사용하여 호출할 수 있습니다. 대상���드를 호출하기 전이나 후에 원하는 코드를 추���하여 실행시킬 수 있습니다. 위의 예에서는 회원���입 처리�� 한 후에 해당 회원에��� 메일을 전송하는 코드��� 추���되어 있습니다.

  이 클로저에 대해 자세히 설명하���습니다.

  이 클로저의 첫���째 파라메터는 타��� 메소드입니다. 위의 예에서 $createMember가 이에 해당합니다. 클로저 내부에서 항상 이 대상 메소드를 호출해주어야 합니다. 또, 클로저는 타��� 메소드의 리턴값을 다시 리턴해야 합니다. 물��� 리턴값을 변경해도 됩니다.

  두���째 파라메터부터는 대상 메소드��� 호출될 때 받은 파라메터�� 그대��� 전달받습니다. 위의 예에서는 $data에 해당하며, 가입할 회원의 정보가 담겨있습니다. 물��� 대상 메소드에 따라 파라메터의 수와 내용이 달라집니다.

  // 항상 대상���소드(첫���째 파라메터)�� 호출해주어야 한다.
  	$member = $createMember($data);
  
  // 항상 대상���드의 반환���을 다시 반환해야 한다.
  	return $member;