====== Mapper Configuration Editor ======
===== 개요 ======
Mapper Configuration Editor 는 Mapper 설정 파일을 편리하게 작성할 수 있도록 도와주는 개발도구이다. 
Mapper Configuration Editor 는 TypeAlias 와 Mapper 목록으로 구성되어 있으며, 
주요 기능은 다음과 같다. 

  * TypeAlias 편집 기능이다.
  * Mapper 목록 편집 기능이다.


{{:egovframework:dev3.8:imp:editor:dbio_editor:mapperconfig1-1.png}}
\\ <sup> <그림 1> Mapper Configuration Editor </sup>

===== 설명 ======

==== TypeAlias ====

Mapper Configuration Editor 는 개발자가 간단한 선택작업과 입력작업만으로도 TypeAlias 를 설정할 수 있다. TypeAlias 의 설정항목은 Alias, Type 이며, 세부사항은 다음과 같다. 

=== TypeAliases ===

TypeAlias 의 Alias, Type 속성은 설정을 좀 더 일반화하기 위해서 이름/값 쌍의 리스트를 제공한다.  

== Add ==
사용자가 필요한 Alias, Type 를 추가한다. 

== Remove ==
TypeAlias 항목 중에 불필요한 항목을 선택하여 Alias, Type 를 제거한다. 

== Init ==
TypeAlias 항목을 모두 초기화한다. 



==== Mapper 목록 ====

Mapper 목록에서는 사용할 Mapper 맵핑 파일을 지정한다. 

== Add ==
Mapper 맵핑 파일을 추가한다. 

== Remove ==
Mapper 목록 중에서 불필요한 Mapper 맵핑 파일을 선택하여 제거한다. 
단, Mapper 목록에서 제거될 뿐, 실제 파일이 삭제되는 것은 아니다. 

== New ==
Mapper 맵핑 파일을 새로 생성하는 동시에 Mapper 목록 중에 새로 생성된 Mapper 맵핑 파일을 추가한다.

===== 사용법 ======

==== Mapper Configuration File 새로 만들기 ===

  - 상단 메뉴의 (("eGovFrame" 메뉴는 eGovFrame Perspective 환경에서만 나타난다.)) eGovFrame -> Implementation -> New Mapper Configuration 또는 Context Menu의 New -> mapperConfiguration 를 통해 파일을 생성한다.\\ {{:egovframework:dev3.8:imp:editor:dbio_editor:mapperconfig-new.png|}}\\ <sup> <그림 2> mapperConfiguration 생성방법 1 </sup>\\ \\ {{:egovframework:dev3.8:imp:editor:dbio_editor:mapperconfig-new2.png|}}\\ <sup> <그림 3> mapperConfiguration 생성방법 2 </sup> \\ \\
  - mapperConfiguration 파일이 위치할 폴더를 선택하고 파일명을 입력한다.(<그림 4> 참조) \\ \\

==== Mapper Configuration Editor 열기 ==== 

Package Explorer 에서 해당 Mapper Configuration File을 선택하고 더블클릭하거나 열기를 누르면 자동으로 Mapper Configuration Editor 로 열리게 된다.

{{:egovframework:dev3.8:imp:editor:dbio_editor:mapperconfig1-2.png|}}
\\ <sup> <그림 4> Mapper Configuration File의 선택 </sup> 


단, Mapper Configuration file에 이상이 있거나, 다른 이유로 Mapper Configuration Editor 로 열리지 않을 때에는 context menu 의 open with 기능을 사용하여 editor 를  Mapper Configuration Editor 로 선택해야 한다. (<그림 5> 참조)

{{:egovframework:dev3.8:imp:editor:dbio_editor:mapperconfig1-3.png|}}
\\ <sup> <그림 5> Mapper Configuration Editor 로 자동으로 열리지 않을 경우  </sup> 
 

==== TypeAlias 사용법 ==== 
  - Mapper Configuration Editor에서 "TypeAlias" 타이틀을 클릭하면 "TypeAlias" Tab 이 확장되면서 편집가능한 상태가 된다. 
  - Alias, Type 항목에 적절한 값을 입력한다. 
  - 필요한 경우, TypeAlias 항목을 추가 또는 삭제하려면 TypeAlias 목록 우측에 있는 "Add", "Remove" 버튼을 활용한다. TypeAlias 를 초기화할 경우에는 "Init" 버튼을 눌러 모든 항목을 초기화한다. 

{{:egovframework:dev3.8:imp:editor:dbio_editor:mapperconfig1-4.png|}}
\\ <sup> <그림 6> TypeAlias </sup> 


==== Mapper 목록 사용법 ==== 

{{:egovframework:dev3.8:imp:editor:dbio_editor:mapperconfig1-5.png|}}
\\ <sup> <그림 7> Mapper 목록 </sup> 


  - Mapper 목록 우측에 있는 "add" 버튼을 클릭하여 Mapper 파일을 검색하고 하나 이상의 Mapper 파일을 선택하여 추가할 수 있다. (<그림 8> 참조)
  - Mapper 목록에 불필요한 Mapper 파일이 있는 경우 해당항목을 선택하고 "Remove" 버튼을 클릭하여 선택된 항목을 제거한다. 단, 실제 파일이 삭제되는 것은 아니다. 
  - 사용할 Mapper 파일이 존재하지 않는 경우 "New" 버튼을 클릭하여 새 Mapper 파일을 생성함과 동시에 새로 생성된 Mapper 파일을 목록에 추가할 수 있다. (<그림 9> 참조)
  - Mapper 목록의 항목이 하나이상인 경우  Mapper 목록 바로 위에 있는 filter 를 사용하여 Mapper 파일 항목을 선택적으로 조회할 수 있다. (<그림 10> 참조)
 

{{:egovframework:dev3.8:imp:editor:dbio_editor:mapperconfig1-6.png|}}
\\ <sup> <그림 8> Mapper 파일 검색   </sup> 


{{:egovframework:dev3.8:imp:editor:dbio_editor:mapperconfig1-7.png|}}
\\ <sup> <그림 9> Mapper 파일 신규 생성 화면  </sup> 


{{:egovframework:dev3.8:imp:editor:dbio_editor:mapperconfig1-8.png|}}
\\ <sup> <그림 10> Mapper 목록의 filter 적용  </sup> 


==== Mapper Configuration File의 소스 직접 수정하기 ==== 

  - Mapper Configuration Editor 에는 Form UI 를 사용하지 않고 XML 을 직접 수정할 수 있는 기능을 제공하고 있다. 
  - Mapper Configuration Editor 에서 편집화면 하단에 보이는 "파일명.xml" 이라는 제목의 Tab 을 클릭하면 Form UI를 사용하지 않고 XML Source 를 직접 수정할 수 있다. (<그림 11> 참조)


{{:egovframework:dev3.8:imp:editor:dbio_editor:mapperconfig1-9.png|}}
\\ <sup> <그림 11> Mapper Configuration 파일 직접 수정  </sup>