목차 >> 개발환경 설정 
+- Maven 설치 
+- Eclipse 설치 
----+- Glue Plug-In 설치 
----+- GlueSDK 설치

3장 개발환경 설정

Eclipse 설치

  1. download Eclipse
  2. unzip Eclipse

Eclipse 사이트의 다운로드 페이지에서 다음 패키지를 다운로드해서 압축을 풀면 됩니다.
설치 폴더는 편의상 ECLIPSE_HOME 이라고 합니다. (Eclipse 관련 How to는 Eclipse 사이트의 가이드를 따릅니다.)

  • Eclipse IDE for Java EE Developers
  • Eclipse IDE for Java Developers
그림 : Eclipse Download
Eclipse Download

다음은 Eclipse를 압축 해제한 모습입니다.

그림 : Eclipse 설치 결과
Eclipse 설치 결과
  • TIP
    • Juno(4.2), Kepler(v4.3), Luna(v4.4), Mars(4.5), Neon(4.6) 버전의 패키지를 선택해서 사용합니다.
    • 설치폴더인 ECLIPSE_HOME은 한글이나 공백이 포함되지 않도록 합니다.
    • Eclipse 실행용 Java VM은 ECLIPSE_HOME/eclipse.ini 파일에서 명시적으로 지정할 수 있습니다.
      그림 : eclipse.ini
      eclipse.ini
    • Eclipse 설치시 users 폴더와 workspace 폴더를 미리 생성해 둡니다.

Eclipse를 설치한 후에는 Glue Framework 과 관련해서 다음 과정을 진행합니다.

  1. GlueSDK와 Plugin 다운로드 : Welcome 페이지를 참고합니다.

  2. Glue Plug-In 설치 : ECLIPSE_HOME/dropins 위치에 설치합니다.

  3. GlueSDK 설치 : Eclipse의 Preference를 통해 GlueSDK를 지정합니다.

Glue Plug-In 설치

다운로드한 Glue Plug-In을 ECLIPSE_HOME/dropins 폴더에 압축을 풉니다.
Glue Plug-In은 plugins에도 설치해도 되지만, 향후 Glue Plug-in 패치시에는 dropins가 편리합니다.

그림 : Plug-In 설치 결과
Plug-In 설치 결과

Glue Plug-in은 다음과 같습니다.

  • com.poscoict.glueframework.activity.designer-[version].jar
  • com.poscoict.glueframework.activity.model-[version].jar
  • com.poscoict.glueframework.project.startup-[version].jar
  • com.poscoict.glueframework.query.editor-[version].jar
Glue Plug-In 패치/업그레이드

Glue Plug-In의 패치/업그레이드는 2가지 방법을 선택해서 수행할 수 있습니다.

  1. "-clean" 옵션 이용

    이 방법을 사용하기 위해서는 -clean 옵션이 포함된 바로가기를 필요로 합니다(그림 참고).
    ECLIPSE_HOME / dropins 에서 4개 파일을 변경(패치/업그레이드)한 후, "-clean" 옵션이 포함된 바로가기를 통해 Eclipse를 실행하면 패치/업그레드가 반영됩니다.

    그림 : 바로가기 -clean 적용
    바로가기 -clean 적용
  2. 재설치(삭제후 설치)

    이 방법은 다음과 같은 순서대로 진행하는 방법입니다.

    1. 실행중인 Eclipse 종료.
      종료전 Activity Diagram 및 Query Editor 등의 파일들은 닫아 주는것이 좋습니다.
    2. 기존 plugin 삭제 후 Eclpse 실행.
      Glue Plug-In이 삭제되었음을 Eclipse가 인지하게 하는 과정입니다.
    3. Eclipse 종료.
      Eclipse가 종료된 상태에서 새로운 Plug-In을 복사합니다.
    4. 새로운 plugin 복사 후 Eclipse 실행.
    5. GlueSDK SDK Location 재 설정 ( Window --> Preferences --> Glue Framework )

GlueSDK 설치

  1. 다운로드한 GlueSDK를 ECLIPSE_HOME/users 폴더에 압축을 풉니다.
    GlueSDK의 디렉토리 구조는 유지할 수 있도록 합니다. 이후 편의상 압축을 해제한 위치는 GlueSDK_HOME 라고 합니다.

    그림 : GlueSDK 설치 결과
    GlueSDK 설치 결과
  2. Preference 를 통해 Glue SDK Location 를 지정합니다. (그림 참고)
    Eclipse의 Window 메뉴에 Preference 가 있습니다. Preference에서 'Glue Framework' 을 찾아 GlueSDK_HOME 를 지정합니다.

    그림 : SDK Location 설정
    GlueSDK Location 설정
  3. GlueSDK_HOME / templateFolder / maven 위치의 pom.xml을 수정합니다.
    pom.xml의 repositories를 찾아서 url을 file://GlueSDK_HOME/repo 로 변경해두면 Glue Maven Project 생성시 pom.xml을 수정해야 하는 번거로움을 줄일 수 있습니다.

    <project ... 중략 ...>
        ... 중략 ...
        <repositories>
            <repository>
                <id>repo</id>
                <name>repo</name>
                <url>file://C://eclipse/users/GlueSDK/repo</url>
            </repository>
        </repositories>
    </project>
    
GlueSDK 패치/업그레이드

Glue Framework Library가 바뀌었다면, 즉 GlueSDK가 Patch/Upgrade 되었다면, Eclipse를 재실행하거나, Preferences 창에서 GlueSDK Location을 재설정하면 됩니다.
GlueSDK을 덮어쓰기 하셨다면 [그림 : SDK Location 설정]과 같은 Preference 창에서 Apply 버튼을 이용하면 GlueSDK가 갱신됩니다.

GlueSDK 란

GlueSDK란 개발에 필요한 모든 작업환경을 설정하고 Upgrade 자동화를 지원하는 Glue Standard Development Kit 입니다. GlueSDK의 내용은 개발자가 개별적으로 설정하지 않고, PL이 설정해서 해당 프로젝트의 개발자가 동일 GlueSDK를 사용하기를 권장합니다.

GlueSDK에는 다음과 같은 5가지 폴더로 나뉘어져 있습니다.

  • config : config 폴더에는 glue-config.xml 파일이 있으며, Glue Plug-In 과 관련된 설정정보를 관리하고 있습니다.
  • GlueAPI : GlueAPI 폴더에는 site-javadoc.zip 파일이 있으며, 프로젝트 정보가 문서화 되어 있습니다. 여기서 프로젝트는 glue-framework 라는 Maven project를 의미하며, Glue Framework 의 의존물 정보, 라이선스 등과 java doc를 포함합니다.
  • lib : lib 폴더는 gluelib 와 gluestd로 구분되며, 그외 폴더는 gluestd_<etc#> 형태를 갖습니다. Glue Plug-In에서는 gluelib와 gluestd의 속한 library만 User Library로 자동 인식합니다.
    gluelib 에는 Glue Framework 의 모듈들이 위치합니다. glue-schema 모듈과 glue-core 모듈은 필수이며, 그외는 선택해서 사용할 수 있습니다.
    gluestd에는 Glue Framework 의 각 모듈의 의존 library 들이 위치합니다. gluestd 의 의존 library들은 gluestd_<etc#> 에서, 일부 의존 library는 site에서 직접 다운받아 사용자가 직접 재 구성해야 합니다.
    logback libarary는 logback site에서 사용자가 직접 다운로드해서 GlueSDK에 구성해야 합니다.
  • repo : repo 폴더는 lib/gluelib 에 속한 library가 maven 형태로 구성되어 있습니다. maven 구조(group, artifact, version)로 library가 존재하며, pom.xml 에 repo 폴더를 repository 로 지정해서, 로컬에서 사용할 수 있습니다.
  • templateFolder : templateFoler에는 2종류의 project template을 포함합니다.
    Glue Plug-In에서 Glue Project생성시 java type과 maven type 을 선택할 수 있으며, 이때 templateFolder에 내용물이 사용됩니다.

제공되는 GlueSDK는 다음과 같은 디렉토리 구조로 되어 있습니다.

GlueSDK                                                    : GlueSDK root
GlueSDK / config                                           : Glue Plug-In 관련 config파일 위치
GlueSDK / GlueAPI                                          : Java Doc
GlueSDK / lib 
GlueSDK / lib / gluelib                                    : Glue Java Project용 USER Library(GLUE_CORE) 경로
GlueSDK / lib / gluestd                                    : Glue Java Project용 USER Library(GLUE_STD) 경로
GlueSDK / lib / gluestd / jdbc 
GlueSDK / lib / gluestd_<etc1>
GlueSDK / lib / gluestd_<etc2>
GlueSDK / lib / gluestd_<etc ..>
GlueSDK / repo /                                           : Glue Maven Project 용 Library.
GlueSDK / repo / com / poscoict / <artifactId> / <version>  
GlueSDK / templateFolder / java                            : Glue Java Project 생성시 사용됨
GlueSDK / templateFolder / java / src 
GlueSDK / templateFolder / java / src / layout
GlueSDK / templateFolder / java / src / service
GlueSDK / templateFolder / java / src / query
GlueSDK / templateFolder / java / model 
GlueSDK / templateFolder / java / WebContents
GlueSDK / templateFolder / java / WebContents / WEB-INF
GlueSDK / templateFolder / maven                           : Glue Maven Project 생성시 사용됨
GlueSDK / templateFolder / maven / src
GlueSDK / templateFolder / maven / src / main
GlueSDK / templateFolder / maven / src / main / java
GlueSDK / templateFolder / maven / src / main / model
GlueSDK / templateFolder / maven / src / main / resource
GlueSDK / templateFolder / maven / src / main / resource / service
GlueSDK / templateFolder / maven / src / main / resource / query
GlueSDK / templateFolder / maven / src / main / webapp
GlueSDK / templateFolder / maven / src / main / webapp / WEB-INF
GlueSDK / templateFolder / maven / src / test