라이믹스/라우터 편집하기 (부분)

== 개발자 가이드 ==
=== 모듈에서 라우터 사용 ===
라우터 기능을 사용하기 위해서는 <nowiki>`module.xml`</nowiki> 파일에서 <nowiki>`route`</nowiki> 속성을 정의해야 한다. 예를 들어, 게시판 모듈에서 특정 글을 삭제하는 URL을 정의하려면 다음과 같이 설정할 수 있다.

<syntaxhighlight lang='xml'>
<action name="dispBoardDelete" type="view" route="$document_srl/delete" />
</syntaxhighlight>

이렇게 하면 <nowiki><code>/board/123/delete</code></nowiki>와 같은 URL을 사용할 수 있다. 또한, <nowiki>`<route>`</nowiki> 태그를 사용하면 하나의 액션에 여러 개의 짧은주소를 정의할 수 있다.

<syntaxhighlight lang='xml'>
<action name="dispBoardWrite" type="view">
    <route route="write" />
    <route route="$document_srl/edit" />
</action>
</syntaxhighlight>

위 설정을 적용하면 <nowiki><code>/notice/write</code></nowiki>와 <nowiki><code>/notice/123/edit</code></nowiki>와 같은 URL을 사용할 수 있다.

=== 우선순위 설정 ===
여러 개의 짧은주소가 동일한 변수들을 사용하여 충돌할 경우, <nowiki>`priority`</nowiki> 속성을 사용하여 우선순위를 지정할 수 있다.

<syntaxhighlight lang='xml'>
<action name="dispBoardExample" type="view">
    <route route="downtown/$baby" priority="20" />
    <route route="hasta/la-vista/$baby" priority="10" />
</action>
</syntaxhighlight>

우선순위가 높은 라우트가 먼저 적용된다.

=== 404 에러 처리 ===
라우트가 정의되지 않은 URL 요청이 들어오면, 모듈에서 404 에러 핸들러를 지정하여 사용자 친화적인 에러 페이지를 제공할 수 있다.

<syntaxhighlight lang='xml'>
<action name="dispBoardNotFound" type="view" error-handlers="404" />
</syntaxhighlight>

이렇게 설정하면 잘못된 URL이 요청될 경우 <nowiki>`dispBoardNotFound`</nowiki> 메소드가 실행된다.

=== 전역 짧은주소 사용 ===
mid 없이도 작동하는 기능(예: 통합검색)의 경우, <nowiki>`global-route="true"`</nowiki> 속성을 추가하여 전역 라우트를 설정할 수 있다.

<syntaxhighlight lang='xml'>
<action name="IS" type="view" global-route="true">
    <route route="search" />
</action>
</syntaxhighlight>

이를 통해 <nowiki><code>https://example.com/search</code></nowiki>와 같은 URL이 사용 가능하다. 다만, 전역 라우트는 다른 모듈과 충돌할 위험이 있으므로 신중하게 사용해야 한다.