웹마스터 팁
[모듈 개발] 테이블 스키마 파일 이름은 테이블명과 동일하게
2014.05.12 15:56
1. 상황
모듈 개발 중 테이블 스키마와 쿼리를 아래처럼 만들고 excecuteQuery를 때렸습니다.
[schemas/items.xml]
1 2 3 4 | <table name="test_items"><column name="item_srl" type="number" size="11" notnull="notnull" auto_increment="auto_increment" primary_key="primary_key " /> <column name="display_name" type="varchar" size="50" /></table> |
[queries/insertItem.xml]
1 2 3 4 5 6 7 8 | <query id="insertItem" action="insert"> <tables> <table name="test_items" /> </tables> <columns> <column name="display_name" var="display_name" maxlength="50"/> </columns></query> |
당연히 insert가 되었을 줄 알았지만 에러가 났습니다.
error: Unknown column 'xxx' in 'field-list'
헐... 'xxx'는 값인데 컬럼이라니.
쿼리문을 찍어 봤습니다.
INSERT INTO `xe_test_items` (`display_name`) VALUES (`xxx`)
값에 `(어퍼스트로피)가 씌워져 있는 것이 문제의 원인이었습니다.
2. 추적
끊질긴 추적 끝에 쿼리 캐쉬 파일(files/cache/queries/)이 다른 것들과 차이가 있음을 발견했습니다.
* 쿼리 캐쉬 파일은 DB.class.php의 checkQueryCacheFile 함수를 통해 만들어 집니다.
정상)
1 2 3 4 5 6 | ${'document_srl206_argument'} = new Argument('document_srl', $args->{'document_srl'});${'document_srl206_argument'}->checkFilter('number');${'document_srl206_argument'}->checkNotNull();if(!${'document_srl206_argument'}->isValid()) return ${'document_srl206_argument'}->getErrorMessage();if(${'document_srl206_argument'} !== null) ${'document_srl206_argument'}->setColumnType('number'); |
비정상)
1 | if(isset($args->display_name)) {${'display_name14_argument'} = new Argument('display_name', $args->{'display_name'});if(!${'display_name14_argument'}->isValid()) return ${'display_name14_argument'}->getErrorMessage();} else |
정상과 달리 setColumnType이 누락되어 있었습니다.
다시 쿼리 캐쉬 파일을 만들어 내는 부분을 추적해봤습니다.
QueryTag.class.php 클래스의 setTableColumnTypes 함수에서 QueryParser::getTableInfo 함수를 통해 가져온 테이블 정보가 비어 있었습니다.
QueryParser::getTableInfo는 다음 과정을 통해 테이블 스키마 파일을 찾아 냅니다.
1) 인자로 넘어 온 $query_id 문자열을 .(도트) 문자로 분리.
2개로 분리되면
target : 'modules'
module : $id_args[0]
query id : $id_args[1]
3개로 분리되면
target : $id_args[0] ( modules or addons or widgets )
module : $id_args[1]
query id : $id_args[2]
2) 위 정보를 토대로 modules 디렉토리 아래에 있는 module 디렉토리로부터 인자로 들어온 테이블 이름에 해당하는 스키마 파일을 가져 옵니다.
3) 없으면, modules 디렉토리의 하위 디렉토리들의 shemeas 폴더를 순회하면서 일치하는 것이 있는지 검사합니다.
3. 원인
테이블 이름은 test_items이지만 스키마 파일 이름은 items.xml이다보니,
modules 하위 디렉토리 순회 과정에서 스키마 파일을 찾지 못해 결과적으로 setColumnType 코드를 쿼리 캐쉬 파일에 기록하지 못한 것이었습니다.
스키마 파일을 못 찾았을 때 에러를 출력해주면 좋았을텐데 TT
시간을 좀 낭비했지만 덕분에 매뉴얼에도 없는 소중한 정보들을 몇가지 알게 되어 공유합니다. ^^
댓글 3
-
산하2
2014.05.13 12:03
꼼꼼하시네요 ^^ 제목을 수정했습니다.
-
joowonx
2015.03.05 15:42
:_) 감사합니다 덕분에 해결했어요 .. 모듈에서 다른 모듈이 만든 테이블을 손대려고할때... 같은 스키마가 필요하더군요 ㅠㅠ
스키마 이름은 모듈과 무관합니다. 모듈_테이블명.xml 로 할 필요가 없습니다.
그냥, 스키마 이름을 테이블명과 동일하게만 하면 됩니다.
스키마 이름은 items 이고, 테이블명은 test_items 여서 안 되었던거기에
test_items 로 통일하거나, 아니면 items 로 통일하면 됩니다. ( test 가 모듈명이었나보네요 ^^;)