====== Mapper Configuration Editor ====== ===== 개요 ====== Mapper Configuration Editor 는 Mapper 설정 파일을 편리하게 작성할 수 있도록 도와주는 개발도구이다. Mapper Configuration Editor 는 TypeAlias 와 Mapper 목록으로 구성되어 있으며, 주요 기능은 다음과 같다. * TypeAlias 편집 기능이다. * Mapper 목록 편집 기능이다. {{:egovframework:dev3.8:imp:editor:dbio_editor:mapperconfig1-1.png}} \\ <그림 1> Mapper Configuration Editor ===== 설명 ====== ==== 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|}}\\ <그림 2> mapperConfiguration 생성방법 1 \\ \\ {{:egovframework:dev3.8:imp:editor:dbio_editor:mapperconfig-new2.png|}}\\ <그림 3> mapperConfiguration 생성방법 2 \\ \\ - mapperConfiguration 파일이 위치할 폴더를 선택하고 파일명을 입력한다.(<그림 4> 참조) \\ \\ ==== Mapper Configuration Editor 열기 ==== Package Explorer 에서 해당 Mapper Configuration File을 선택하고 더블클릭하거나 열기를 누르면 자동으로 Mapper Configuration Editor 로 열리게 된다. {{:egovframework:dev3.8:imp:editor:dbio_editor:mapperconfig1-2.png|}} \\ <그림 4> Mapper Configuration File의 선택 단, 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|}} \\ <그림 5> Mapper Configuration Editor 로 자동으로 열리지 않을 경우 ==== 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|}} \\ <그림 6> TypeAlias ==== Mapper 목록 사용법 ==== {{:egovframework:dev3.8:imp:editor:dbio_editor:mapperconfig1-5.png|}} \\ <그림 7> Mapper 목록 - 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|}} \\ <그림 8> Mapper 파일 검색 {{:egovframework:dev3.8:imp:editor:dbio_editor:mapperconfig1-7.png|}} \\ <그림 9> Mapper 파일 신규 생성 화면 {{:egovframework:dev3.8:imp:editor:dbio_editor:mapperconfig1-8.png|}} \\ <그림 10> Mapper 목록의 filter 적용 ==== 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|}} \\ <그림 11> Mapper Configuration 파일 직접 수정