LynX's Time

Lost Space

Sky2 Layout

6.XML 쿼리 언어

SMaker님의 글을 전문인용하여 재구성하였다. - http://xe.xpressengine.net/wiki/18180631

개요

쿼리 사용방법

XML sample

Select query 예제

Join Select 예제

Letf Join Select 예제

Insert 예제

update 예제

delete 예제

Select Click Count 예제

개요

XpressEngine는 SQL 쿼리를 그대로 사용하지 않고 XML로 작성합니다.

이는 다양한 DBMS를 지원하기 위해서입니다.

XML Query문의 확장자는 .xml 입니다.

쿼리 사용방법

XML 쿼리는 모듈과 애드온, 위젯 등에서 다음과 같이 사용할 수 있습니다.

$args->name = 'zero';

$output = executeQuery('member.getMemberInfo', $args);

XML Query를 호출하여 실제 DB의 데이터를 받거나 조작하기 위해서 사용되는 executeQuery() 함수는 DB::executeQuery() 함수의 별칭(alias)입니다.

이 함수는 실제 DB 데이터를 조작하고 사용된 DB에 따라 XML 쿼리가 네이티브 SQL로 파싱된 후에 결과를 수신합니다.

function executeQuery($xml_query_name, $args = null);

첫번째 파라미터는 실행하고자 하는 XML 쿼리의 이름입니다. 이름은 모듈이나 위젯, 애드온에 따라 다음과 같이 사용합니다.

모듈에서 XML Query를 실행하고자 하는 경우 - 모듈이름.쿼리ID
ex) $output = executeQuery('communication.getMessage',$args, $columnList);

위젯에서 XML Query를 실행하고자 하는 경우 - widgets.위젯이름.쿼리ID
ex) $output = executeQueryArray('widgets.content.getMids', $obj);

애드온에서 XML Query를 실행하고자 하는 경우 - addons.애드온이름.쿼리ID
ex) $output = executeQueryArray('addons.piclens.getFileList', $obj);

두번째 파라미터 $args는 널(null)이 될 수도 있고 해당 XML Query에서 필요시 stdClass의 variables type으로 변수의 key, value를 설정 후 데이터를 쿼리에 전달하는데 사용됩니다.

결과는 Object class의 객체로 반환(return) 됩니다.

쿼리가 실패했다면 $output->toBool()이 FALSE 일 경우이고, TRUE이면 쿼리는 정상적으로 실행이 된 것을 의미합니다.

select문의 결과 데이터는 $ouptut->data 변수에 담겨져 return 됩니다.

XML 쿼리 예제(sample)

▶ 쿼리ID.xml

<queryid="쿼리아이디"action="select|update|delete|insert">

    <tables>

        <tablename="원테이블이름"alias="alias"/>

        ...

    </tables>

    <columns>

        <columnname="컬럼명"alias="alias"/>

        ...

    </columns>

    <conditions>

        <conditionoperation="조건절"column="Column명"var="변수명"filter="필터형식"default="기본값"notnull="notnull"minlength="최소길이"maxlength="최대길이"pipe="연결연산자"/>

        ...

        <grouppipe="연결연산자">

            <conditionoperation="조건절"column="Column명"var="변수명"filter="필터형식"default="기본값"notnull="notnull"minlength="최소길이"maxlength="최대길이"pipe="연결연산자"/>

            ...

        </group>

        ...

    </conditions>

    <navigation>

        <indexvar="이름"default="기본값"order="desc|asc"/>

        <list_countvar="변수명"default="기본값"/>

        <page_countvar="변수명"default="기본값"/>

        <pagevar="변수명"default="변수명"/>

    </navigation>

    <groups>

        <groupcolumn="GroupBy 대상"/>

    </groups>

</query>

XML 쿼리 요소와 속성

XML 쿼리에 사용되는 XML 요소와 속성은 다음과 같습니다.

▶ <query> - 쿼리 XML의 최상위 요소

id : 쿼리를 찾을 수 있는 아이디입니다. module.query_id를 사용해서 쿼리 XML 파일을 검색하고 사용합니다.

action : 액션은 select, update, delete, insert 4가지 타입입니다.

▶ <tables> - 쿼리에 사용될 테이블의 모음

<table> : 테이블 요소, 테이블 조인 시 여러 개의 <table>을 사용할 수 있습니다.

name : 원 테이블 명 (XE에서의 테이블 머릿말(접두어) prefix_는 무시)

alias : 열 지정이나 검색 등에서 사용할 테이블 별칭, join 또는 다른 용도로 원 테이블 명을 바꾸어 사용할 경우

▶ <columns> - 쿼리에 사용될 열 모음

<column> : 열 요소, 처리하고자 하는 컬럼명을 입력하시면 됩니다.

name : 열 이름(컬럼명)

alias : 원래 열의 이름을 변경할 때 사용(다른 이름으로 바꾸어 결과를 만들고자 할 경우 지정)

▶ <conditions> - 조건문을 만들 때 사용

조건절을 구성합니다.

조건절을 여러 개의 그룹으로 사용하고자 할 때에는 <group> 태그를 이용해 묶어 주실 수 있습니다.

▶ <group> ... </group> - 조건 그룹

조건문을 그룹으로 사용할 경우 pipe="and|or" 을 이용하여 그룹끼리의 조건을 지정할 수 있습니다.

▶ <column> - 조건문

▶ <navigation> - navigation은 정렬 순서(order by) 또는 페이징 기능을 지원합니다.

▶ <groups> - 조건문에 따라 그룹을 사용할 수 있게 합니다.(group by 절 사용시 작성)

<group> 그룹핑할 컬럼을 지정할 수 있습니다.

column : 그룹핑할 컬럼명 지정(group by 기준 열 이름)

Select query 예제

member.getMemberList : member테이블에서 특정 조건을 가진 회원들을 페이징을 하면서 select

<queryid="getMemberList"action="select">

<tables>

   <tablename="member"/>

</tables>

<columns>

   <columnname="*"/>

</columns>

<conditions>

    <conditionoperation="equal"column="is_admin"var="is_admin"/>

   <conditionoperation="equal"column="denied"var="is_denied"pipe="and"/>

   <grouppipe="and">

        <conditionoperation="like"column="user_id"var="s_user_id"/>

        <conditionoperation="like"column="user_name"var="s_user_name"pipe="or"/>

        <conditionoperation="like"column="nick_name"var="s_nick_name"pipe="or"/>

        <conditionoperation="like"column="email_address"var="s_email_address"pipe="or"/>

        <conditionoperation="like_prefix"column="regdate"var="s_regdate"pipe="or"/>

        <conditionoperation="like_prefix"column="last_login"var="s_last_login"pipe="or"/>

    </group>

</conditions>

<navigation>

    <indexvar="sort_index"default="member_srl"order="desc"/>

    <list_countvar="list_count"default="20"/>

    <page_countvar="page_count"default="10"/>

    <pagevar="page"default="1"/>

</navigation>

</query>

document.getMonthlyArchivedList : 모듈을 '년월'일을 기준으로 group by 한 결과를 가져옴

<queryid="getMonthlyArchivedList"action="select">

<tables>

    <tablename="documents"/>

</tables>

<columns>

    <columnname="substr(regdate,1,6)"alias="month"/>

    <columnname="count(*)"alias="count"/>

</columns>

<conditions>

   <conditionoperation="in"column="module_srl"var="module_srl"filter="number"/>

</conditions>

<groups>

    <groupcolumn="substr(regdate,1,6)"/>

</groups>

</query>

Join Select 예제

document.getTrashList 예제입니다.

<queryid="getTrashList"action="select">

    <tables>

        <tablename="documents"/>

        <tablename="document_trash"/>

    </tables>

    <columns>

        <columnname="documents.*"/>

        <columnname="document_trash.trash_srl"alias="trash_srl"/>

        <columnname="document_trash.module_srl"alias="module_srl"/>

        <columnname="document_trash.trash_date"alias="trash_date"/>

        <columnname="document_trash.description"alias="trash_description"/>

        <columnname="document_trash.ipaddress"alias="trash_ipaddress"/>

        <columnname="document_trash.user_id"alias="trash_user_id"/>

        <columnname="document_trash.user_name"alias="trash_user_name"/>

        <columnname="document_trash.nick_name"alias="trash_nick_name"/>

        <columnname="document_trash.member_srl"alias="trash_member_srl"/>

    </columns>

    <conditions>

        <conditionoperation="equal"column="document_trash.document_srl"default="documents.document_srl"notnull="notnull"/>

        <conditionoperation="in"column="document_trash.module_srl"var="module_srl"filter="number"pipe="and"/>

        <conditionoperation="equal"column="document_trash.member_srl"var="member_srl"filter="number"pipe="and"/>

        <grouppipe="and">

            <conditionoperation="like"column="documents.title"var="s_title"/>

            <conditionoperation="like"column="documents.content"var="s_content"pipe="or"/>

            <conditionoperation="like"column="documents.user_name"var="s_user_name"pipe="or"/>

            <conditionoperation="like"column="documents.user_id"var="s_user_id"pipe="or"/>

            <conditionoperation="like"column="documents.nick_name"var="s_nick_name"pipe="or"/>

            <conditionoperation="like"column="documents.email_address"var="s_email_addres"pipe="or"/>

            <conditionoperation="like"column="documents.homepage"var="s_homepage"pipe="or"/>

            <conditionoperation="like"column="documents.tags"var="s_tags"pipe="or"/>

            <conditionoperation="equal"column="documents.is_secret"var="s_is_secret"pipe="or"/>

            <conditionoperation="equal"column="documents.member_srl"var="s_member_srl"pipe="or"/>

            <conditionoperation="more"column="documents.readed_count"var="s_readed_count"pipe="or"/>

            <conditionoperation="more"column="documents.voted_count"var="s_voted_count"pipe="or"/>

            <conditionoperation="more"column="documents.comment_count"var="s_comment_count"pipe="or"/>

            <conditionoperation="more"column="documents.trackback_count"var="s_trackback_count"pipe="or"/>

            <conditionoperation="more"column="documents.uploaded_count"var="s_uploaded_count"pipe="or"/>

            <conditionoperation="like_prefix"column="documents.regdate"var="s_regdate"pipe="or"/>

            <conditionoperation="like_prefix"column="documents.last_update"var="s_last_update"pipe="or"/>

            <conditionoperation="like_prefix"column="documents.ipaddress"var="s_ipaddress"pipe="or"/>

        </group>

    </conditions>

    <navigation>

        <indexvar="sort_index"default="documents.list_order"order="order_type"/>

        <list_countvar="list_count"default="20"/>

        <page_countvar="page_count"default="10"/>

        <pagevar="page"default="1"/>

    </navigation>

</query>

Letf Join Select 예제

<queryid="getDocumentsExtraVars"action="select">

    <tables>

        <tablename="document_extra_keys"alias="extra_keys"/>

        <tablename="document_extra_vars"alias="extra_vars"type="left join">

            <conditions>

                <conditionoperation="equal"column="extra_keys.module_srl"default="extra_vars.module_srl"/>

                <conditionoperation="in"column="extra_vars.document_srl"var="document_srl"pipe="and"/>

                <conditionoperation="equal"column="extra_keys.eid"default="extra_vars.eid"pipe="and"/>

            </conditions>

        </table>

    </tables>

    <columns>

        <columnname="extra_keys.module_srl"alias="module_srl"/>

        <columnname="extra_keys.var_name"alias="name"/>

        <columnname="extra_keys.var_type"alias="type"/>

        <columnname="extra_keys.var_is_required"alias="is_required"/>

        <columnname="extra_keys.var_search"alias="search"/>

        <columnname="extra_keys.var_default"alias="default"/>

        <columnname="extra_keys.var_desc"alias="desc"/>

        <columnname="extra_keys.var_idx"alias="idx"/>

        <columnname="extra_vars.document_srl"alias="document_srl"/>

        <columnname="extra_vars.lang_code"alias="lang_code"/>

        <columnname="extra_vars.value"alias="value"/>

        <columnname="extra_keys.eid"alias="eid"/>

    </columns>

    <navigation>

        <indexvar="sort_index"default="extra_keys.var_idx"order="asc"/>

    </navigation>

</query>

Insert 예제

document.insertCategory : 문서 카테고리 추가

<queryid="insertCategory"action="insert">

<tables>

    <tablename="document_categories"/>

</tables>

<columns>

    <columnname="category_srl"var="category_srl"filter="number"notnull="notnull"/>

    <columnname="module_srl"var="module_srl"filter="number"default="0"notnull="notnull"/>

    <columnname="title"var="title"notnull="notnull"minlength="2"maxlength="250"/>

    <columnname="document_count"var="document_count"default="0"/>

    <columnname="regdate"var="regdate"default="curdate()"/>

    <columnname="last_update"var="last_update"default="curdate()"/>

    <columnname="list_order"var="list_order"default="0"/>

</columns>

</query>

update 예제

document.updateCategory : 특정 카테고리의 제목이나 순서, 최근 수정일을 변경

<queryid="updateCategory"action="update">

<tables>

    <tablename="document_categories"/>

</tables>

<columns>

    <columnname="title"var="title"/>

    <columnname="list_order"var="list_order"/>

    <columnname="last_update"var="last_update"default="curdate()"/>

</columns>

<conditions>

    <conditionoperation="equal"column="category_srl"var="category_srl"filter="number"notnull="notnull"/>

</conditions>

</query>

delete 예제

document.deleteCategory : 특정 카테고리를 삭제

<queryid="deleteCategory"action="delete">

<tables>

    <tablename="document_categories"/>

</tables>

<conditions>

    <conditionoperation="equal"column="category_srl"var="category_srl"filter="number"notnull="notnull"/>

</conditions>

</query>

Select Click Count 예제

Select 시 조회수 등의 정수의 숫자 컬럼을 +1 하는 기능입니다.
Cubrid의 경우에는 incr()이라는 함수를 사용하고 다른 데이타베이스의 경우 해당 컬럼을 Select후 Update 합니다.

document.getDocument XML Query에 Click Count 를 적용해 본 예제입니다. select시 정수 숫자 컬럼 node에 attribute는 click_count, 값은 Argument로 매핑되는 변수명을 기입합니다.

<queryid="getDocument"action="select">

    <tables>

        <tablename="documents"/>

    </tables>

    <columns>

        <columnname="document_srl"/>

        <columnname="module_srl"/>

        <columnname="category_srl"/>

        <columnname="lang_code"/>

        <columnname="is_notice"  />

        <columnname="is_secret"  />

        <columnname="title"  />

        <columnname="title_bold"/>

        <columnname="title_color"/>

        <columnname="content"  />

        <columnname="readed_count"click_count="incr_readed_count"/>

        <columnname="voted_count"/>

        <columnname="blamed_count"/>

        <columnname="comment_count"/>

        <columnname="trackback_count"/>

        <columnname="uploaded_count"/>

        <columnname="password"  />

        <columnname="user_id"  />

        <columnname="user_name"  />

        <columnname="nick_name"/>

        <columnname="member_srl"  />

        <columnname="email_address"  />

        <columnname="homepage"/>

        <columnname="tags"/>

        <columnname="extra_vars"/>

        <columnname="regdate"/>

        <columnname="last_update"  />

        <columnname="last_updater"/>

        <columnname="ipaddress"  />

        <columnname="list_order"  />

        <columnname="update_order"  />

        <columnname="allow_comment"  />

        <columnname="lock_comment"/>

        <columnname="allow_trackback"/>

        <columnname="notify_message"/>

    </columns>

    <conditions>

        <conditionoperation="equal"column="document_srl"var="document_srl"filter="number"notnull="notnull"/>

    </conditions>

</query>

click_count 의 매핑변수 값이 true이면 해당 컬럼을 +1 증가합니다.

$args->document_srl = $this->document_srl;

$args->incr_readed_count = true;

$output = executeQuery('document.getDocument', $args);