<h3>Action 소개</h3>
<p>XpressEngine의 모든 입력과 출력은 index.php를 통해서 이루어집니다.</p>
<p>입력된 요청을 분석후 대상 Module을 찾은 후 그 Module의 어떤 동작을 해야 하는지 결정하는 것이 Action입니다.<br />
보통 이 동작을 결정하는 Action은 Request Argument의 <strong>$act</strong> 변수값을 이용합니다..</p>
<p> </p>
<p>이 Action에 대한 선언은 모듈의 ./conf/module.xml에 정의되어 있습니다.</p>
<p> </p>
<ul class="checkListType">
<li><strong>Action 명세</strong></li>
</ul>
<ol class="code" style="margin-left: 2em;">
<li><?xml version="1.0" encoding="utf-8"?><br />
<module><br />
<grants /></li>
<li> <permissions /><br />
<actions><br />
<action name="dispFileAdminList" type="view" admin_index="true" standalone="true" /><br />
<action name="dispFileAdminConfig" type="view" standalone="true" /><br />
<action name="procFileUpload" type="controller" standalone="true" /><br />
<action name="procFileDelete" type="controller" standalone="true" /><br />
<action name="procFileDownload" type="controller" standalone="true" /><br />
<action name="procFileAdminDeleteChecked" type="controller" standalone="true" /><br />
<action name="procFileAdminInsertConfig" type="controller" standalone="true" /><br />
</actions><br />
</module></li>
</ol>
<ul style="margin-left: 2em;">
<li><strong><action ... /></strong><br />
Action의 선언</li>
<li><strong>name</strong><br />
Action의 이름이며 이 이름은 해당 모듈의 method 이름이기도 합니다.<br />
* 주의 : Action 이름에 Admin이라는 문자열이 있으면 관리 권한이 있어야 동작을 합니다.</li>
<li><strong>type</strong><br />
모듈을 구성하는 view, model, controller 중 어디에 선언되었는지를 정의합니다.<br />
이 type을 이용하여 모듈.view.class.php 등의 파일을 찾을 수 있습니다.<br />
Action이름에 Admin 문자열이 있으면 모듈.type.admin.php 파일을 찾게 됩니다.</li>
<li><strong>standalone</strong><br />
별도의 mid없이 모듈 자체로도 실행 가능한지 선언할 수 있습니다.<br />
모든 모듈이 mid를 생성하지 않고 모듈 자체적으로 동작할 수도 있는데 이럴 경우 mid없이 사용해도 된다는 것을 알립니다.</li>
<li><strong>index</strong><br />
특정 모듈이 요청될때 $act값이 없거나 선언된 $act에 속하는것이 없을 때 기본 Action으로 지정한다는 것입니다.<br />
하나의 Action만 적용됩니다.</li>
<li><strong>admin_index</strong><br />
Admin모듈에서 특정 모듈의 관리자 view를 표시할때 기본 관리자 view를 찾을 때 사용됩니다.</li>
</ul>
<p> </p>
<h3>Action 이용</h3>
<p>Action은 $act 라는 변수를 통해서 호출할 수 있습니다.</p>
<p>호출은 GET/ POST/ JSON/ XMLRPC 어떤 경우에도 act라는 이름을 이용하게 됩니다.</p>
<p> </p>
<p>예) editor 모듈의 dispEditorPopup() 호출 (./modules/editor/editor.view.php)</p>
<ol class="code">
<li>?module=editor&<strong>act=dispEditorPopup</strong>&editor_sequence=1&component=image_editor</li>
</ol>
<p> </p>
<p> </p>
<h3>Action Forward</h3>
<p>일반적으로 XE의 Action은 모듈에 귀속됩니다.</p>
<p>즉 별다른 지시가 없을 경우 $act 변수에 의해 Action이 호출되면 현재 동작중인 모듈의 Action으로 인정이 되어 실행됩니다.</p>
<p>하지만 경우에 따라서 현재 동작중인 모듈이 아닌 다른 모듈의 Action이 호출될 경우가 있습니다.</p>
<p> </p>
<p>대표적인 예가 RSS 입니다.</p>
<p>$act = rss 는 게시판모듈에서 정의된 Action이 아니지만 Action Forward 기능을 통해 호출되어 실행이 됩니다.</p>
<p>Action Forward는 모듈 독립적인 기능을 수행하기를 원할때 사용할 수 있습니다.</p>
<p> </p>
<ol class="code">
<li>?mid=board&act=rss</li>
</ol>
<p> </p>
<p>위와 같은 요청의 경우 board 라는 mid를 찾게 되고 이 mid가 게시판 모듈의 mid일 경우 rss라는 Action이 없습니다.</p>
<p>이럴 경우 XE는 Action Forward 등록된 것중에 rss라는 것이 있는지 찾게 됩니다.</p>
<p>rss라는 Action은 RSS모듈의 View type으로 DB에 등록이 되어 있어서 XE는 board라는 mid의 정보를 모두 설정하고 나서 RSS 모듈의 View 객체를 생성해서 rss method를 실행하게 됩니다.</p>
<p> </p>
<p>이 Action Forward는 현재 요청된 모듈의 레이아웃이나 정보를 유지한채 다른 동작을 원할 경우 필요합니다.</p>
<p>다른 예로 친구 목록을 보는 Action은 Communication 모듈의 dispCommunicationFriend 라는 Action으로 동작을 합니다.</p>
<p>이 Action은 현재 보고 있는 모듈의 레이아웃등을 그대로 유지한채 내용을 친구 목록으로 대체합니다.</p>
<p> </p>
<p>즉 컨텐츠 영역을 약속된 Action에 따라서 바꾸어서 출력할 수도 있고 요청된 모듈의 정보를 바탕으로 다른 결과를 유도할 수도 있는 기능입니다.</p>
<p> </p>
<ul>
<li>
<p><strong>Action Forward의 등록</strong><br />
보통 Action Forward는 모듈.class.php 에서 moduleInstall() 시에 저장이 됩니다.<br />
아래와 같이 등록할 수가 있습니다.</p>
<ol class="code">
<li>$oModuleController = &getController('module');<br />
$oMdouleController->insertActionForward('모듈명','타입','Action이름');</li>
</ol>
</li>
<li>
<p><strong>Action Forward의 검증</strong><br />
Action Forward가 잘 등록되었는지는 아래와 같은 코드로 확인할 수가 있고 보통 모듈.class.php의 checkUpdate() method에서 이용됩니다.</p>
<ol class="code">
<li>$oModuleModel = &getModel('module');<br />
if($oModuleModel->getActionForward('Action이름')) ...</li>
</ol>
</li>
</ul>
<p> </p>
<p> </p>
<p> </p>