[Eclipse] Java ORM Plugin 다운로드, 수동 설치, 설치 오류 해결 및 사용법

Mybatis를 시작하면서 Java ORM Plugin을 설치하게 되었습니다. 아주 필요한 부분은 아니지만, 손으로 직접 타이핑해야 할 작업을 줄여주고, 문법을 기억할 수 있도록 도움을 주는 부분이 있어서 간단히 설치할 수 있으면 사용해도 괜찮은 플러그인입니다.

 

다만 개발 후 버전 관리가 되지 않으면서 이클립스 마켓에서 사라지게 된 플러그인입니다. 덕분에 수동 설치만 가능합니다. 그런데 수동 설치 방법이 간단하게 해결되기도 하고, 설치해도 동작하지 않기도 합니다. 저는 후자에 해당되어 제가 경험한 내용을 공유하려고 포스팅합니다. 

---

1. Java ORM Plugin 다운로드

 

아래 링크로 접속해 압축 파일을 다운로드합니다.

https://sourceforge.net/projects/java-orm-plugin/

---

2. Java ORM Plugin 설치

설치 과정은 간단합니다. 

 

이클립스 종료 후, 다운로드한 파일의 압축을 풀고, 폴더 전체를 이클립스 dropins 폴더에 복사한 다음, 이클립스를 재구동해 보면 설치가 되어 있는 것을 확인할 수 있습니다. 

 

이 방법이 제대로 동작하지 않으면 조금은 번거로운 방법으로 설치를 시도해볼 수 있습니다. 저는 이 방법으로 성공했습니다.

2.1 간단한 설치 방법

 

다운로드한 JavaORMPlugin.zip의 압축을 풀어줍니다.

폴더 생성은 되지 않아서, 압축을 풀 때 압축 파일명으로 폴더를 생성하고 풀어줍니다.

압축 파일의 내역은 아래와 같습니다.

 

---

 

본인이 설치한 이클립스 폴더를 살펴보면 dropins 폴더가 있습니다.

이 폴더에 압축을 풀었던 폴더를 그대로 복사합니다. 

 

 

다시 이클립스를 실행하고 New > other -> wizard를 실행한 다음 

Mybatis로 검색을 해서 아래와 같이 검색이 되면 설치가 잘 된 것입니다.

저는 이 방법이 통하지 않아서 아래 추가적인 작업을 해 주었습니다.

 

2.2 추가 작업 내역 확인

구글링을 통해 살펴보면 위 방법 외에 한 땀 한 땀 수작업으로 처리하는 설치방법도 있습니다.

그렇지만 조심해야 하기도 하고, 번거 로워 보이는 방법입니다. 그래서 좀 더 구글링을 해보니 과거 이클립스 오류가 보고된 자료가 있었습니다. 

 

 

eclipse 폴더 이름이 변경된 경우, dropins 폴더가 동작하지 않는 오류였습니다.

여기서 힌트를 얻어서 이클립스 폴더명을 다르게 변경하고 실행한 다음, 다시 원래 폴더 명으로 변경하는 과정을 통해 Java ORM Plugin을 설치할 수 있었습니다. 

 

한 번 이 작업을 거치 고나니, 이후에는 계속 정상 동작하는 것으로 보이는데, 실행 과정에서 이클립스 내부 설정이 일부 변경이 되는 것을 확인할 수 있었습니다. 

 

2.3 폴더 변경 작업을 통한 설치

2.3.1 eclipse 설치 폴더 확인

 

본인이 설치한 이클립스 폴더를 확인합니다.

 

2.3.2 JavaORMPlugin 폴더를 dropins에 복사

혹시 JavaORMPlugin 폴더가 dropins에 없다면 다시 복사해 줍니다.

절차는 2.1 절을 따라 하시면 됩니다.

 

2.3.3 이클립스 폴더명 변경 후 실행

 

저는 간단히 eclipse1로 폴더명을 변경하고, 해당 폴더에서 이클립스를 실행했습니다.

2.3.4 이클립스 폴더 및 파일 생성 확인

 

실행을 하고 나면, 기존에 이름을 변경한 eclipse1 폴더 외에 eclipse 폴더가 만들어집니다.

새로 만들어진 eclipse 폴더를 살펴보면 아래와 같이 artifacts.xml 파일이 생성이 됩니다. 

 

 

2.3.5 이클립스 폴더 리네임 및 병합

 

eclipse1 폴더 명을 eclipse로 복원합니다.

 

 

Windows 확인 메시지가 나타납니다. "예(Y)"를 선택해 병합합니다.

 

 

artifacts.xml 파일이 기존 폴더에 병합된 것을 볼 수 있습니다.

이다음 이클립스를 실행하면 정상적으로 Java ORM Plugin이 동작하는 것을 확인할 수 있었습니다.

 

2.3.6 추가 설명

상황을 재현해보려고 artifacts.xml을 삭제하고 다시 시도해봤습니다. 

그런데 이클립스 내부 설정이 변경되었는지 폴더명을 변경하지 않고도 잘 동작하였습니다. 

 

 

좀 찾아보니 eclipse.ini 파일도 수정이 되어 위와 같은 -install 옵션이 활성화되고,

이클립스 configuration/org.eclipse.equinox.simpleconfigurator/bundles.info 파일도 수정이 되어 있었습니다.

 

 

3. Java ORM Plugin 사용법

3.1 Mybatis Configuration XML

이 기능은 Mybatis Configuration XML 파일을 생성해 줍니다.

기본 파일명으로 생성하면 mybatis-config.xml, db.properties 2개의 파일입니다.

 

 

New > other - Java ORM Plugin에서 Mybatis Configuration XML을 선택합니다.

 

 

여기서 잠깐 헷갈리는데, Container는 프로젝트 명이라고 생각하면 됩니다.

 

 

컨테이너 목록에서 원하는 프로젝트를 선택합니다.

 

 

Finish를 선택하면 아래와 같이 mybatis-config.xml과 db.propertes 두 개의 파일이 생성됩니다.

 

 

저는 이미 Mapper도 생성해서 Mapper.xml 파일도 있습니다.

 

파일이 생성되는 위치는 선택할 수 없고, 고정인 것 같습니다. 

몇 번 해봐도 프로젝트에 src 폴더에 생성이 됩니다.

 

mybatis-config.xml

기억하기 힘든 xml 설정의 뼈대를 생성해 줍니다.

#으로 시작하는 몇몇 설정 부분만 자신의 프로젝트에 맞게 수정하고 사용할 수 있습니다. 

 

db.properties

db.proerties 파일은 mysql을 기본으로 설정되어 있습니다.

본인이 사용하는 DB에 맞게 조금씩 수정해서 사용할 수 있습니다.

3.2 Mybatis Mapper XML

이 기능은 Mybatis Mapping XML 파일을 생성해 줍니다.

기본 파일명으로 생성하면 Mapper.xml 파일입니다.

 

New > other - Java ORM Plugin에서 Mybatis Mapping XML로 Mybatis Mapper Wizard를 실행합니다.

Container는 3.1절과 같이 프로젝트 명을 선택합니다.

 

src 경로에 Mapper.xml 파일이 생성됩니다.

 

Mapper.xml

 

Mapper.xml 파일은 샘플 코드가 들어있습니다.

참고용으로 사용할 수 있으며, 필요한 부분만 남기고 삭제한 다음, 수정해서 사용이 가능합니다.

3.3 Mybatis ORM Framework

결론부터 이야기하면 이 기능은 사용할 수 없습니다.

예전에 폴더 구조인 프로젝트명/src 폴더를 기반으로 자동 생성을 지원하기에 파일 생성 과정에서 오류가 납니다. 

 

위의 두  파일들도 src 폴더에 바로 생성되는 것과 같이 src 폴더를 기준으로 생성합니다. 그러나 이 외에 DAO 파일이나 VO 객체도 생성을 하려 하지만 경로 문제로 실패하게 됩니다.

---

4. 결론

이 프레임워크는 엉뚱한 구조를 생성해 냅니다.

 

파일들을 src 폴더를 기준으로 생성합니다. 지금은 src/main/java 와 src/main/resources 폴더를 기준으로 작성하기 때문에, 간단하게 config.xml 파일을 편리하게 생성하는 용도로만 사용하는 것이 좋을 것 같습니다.

 

 

참고

 

https://sourceforge.net/projects/java-orm-plugin/

https://bugs.eclipse.org/bugs/show_bug.cgi?id=231120

https://mybatis.org/mybatis-3/ko/getting-started.html