기존 프로젝트를 Maven으로 변환

기존 Java™ EE 프로젝트를 Maven으로 변환할 수 있습니다.

시작하기 전에

필요한 경우 원래 프로젝트 상태로 돌아갈 수 있도록 작업공간을 백업합니다.

이 태스크 정보

프로젝트 변환에 대해 제안되는 태스크 순서는 다음과 같습니다.

  1. 권장되는 환경 설정 설정.
  2. 비EAR 프로젝트 변환.
  3. EAR 프로젝트 변환.
    1. 컨텐츠 폴더 작성.
    2. EAR 프로젝트 변환.
    3. EAR에 모듈 추가.
    4. 다른 모듈에 종속성 추가.
    5. EAR 라이브러리 디렉토리에 라이브러리 추가.

권장되는 환경 설정 설정

이 태스크 정보

Maven 프로젝트에 대한 작업공간을 사용하려면 권장되는 환경 설정을 먼저 설정합니다.

프로시저

  1. Maven 프로젝트 설정의 환경 설정에 액세스하십시오. > 환경 설정 > Java EE > Maven > Maven 프로젝트 설정을 클릭하십시오.
  2. 모든 Maven 값 설정을 클릭하십시오. Maven 구성에 대한 우수 사례를 나타내는 환경 설정이 설정됩니다.
  3. 확인을 클릭하여 환경 설정의 설정을 완료하십시오.

웹, EJB, 커넥터, 애플리케이션 클라이언트, 유틸리티, 웹 단편, ejb 클라이언트 프로젝트 변환

이 태스크 정보

프로젝트를 변환할 때 다른 아티팩트에 대해 보유한 종속성과 프로젝트에서 아티팩트에 액세스하는 방법을 명심하십시오. 비Maven 프로젝트에서 이 정보는 프로젝트 메타데이터 및 MANIFEST.MF 파일에 직접 지정됩니다. 그러나 Maven 프로젝트에서 종속성은 pom.xml 파일에 지정됩니다. 예를 들어 아티팩트는 MANIFEST.MF 파일을 통해 액세스되거나 프로젝트를 포함하는 EAR의 라이브러리 디렉토리에 배치될 수 있습니다. 웹 프로젝트의 경우 아티팩트는 WEB-INF/lib 디렉토리에 배치될 수 있습니다.

먼저 배치 어셈블리 페이지를 사용하여 종속성 정보를 수집하십시오.
  1. 프로젝트를 마우스 오른쪽 단추로 클릭하십시오.
  2. 특성 > 배치 어셈블리를 선택하십시오.
  3. Manifest 항목 탭을 클릭하십시오. 프로젝트에서 참조하는 모든 항목을 기록해 두십시오.
  4. 웹 프로젝트의 경우 배치 어셈블리 탭도 클릭하십시오. WEB-INF/lib로 시작하는 배치 경로에서 모든 프로젝트 및 JAR 파일을 기록해 두십시오.
참고: 프로젝트를 포함하는 EAR 프로젝트에 EAR 패싯 버전 5 또는 6이 있는 경우 프로젝트는 EAR 파일의 라이브러리 디렉토리에 있는 JAR 파일 또는 프로젝트의 클래스를 참조할 수 있습니다. 이 참조도 기록해 두십시오.

필수 정보를 수집한 후에는 프로젝트를 Maven으로 변환할 수 있습니다.

프로시저

  1. 프로젝트를 마우스 오른쪽 단추로 클릭하고 구성 > Maven 프로젝트로 변환을 선택하십시오.
  2. Maven POM 대화 상자를 완료하십시오. 그룹 ID, 아티팩트 ID, 버전을 입력하거나 기본값을 승인하십시오. 선택적으로 이름설명을 입력하십시오. 패키징의 경우 다음 프로젝트 유형에 따라 선택하십시오.
    웹 프로젝트
    war
    EJB 프로젝트
    ejb
    커넥터, 유틸리티, 웹 단편, EJB 클라이언트 프로젝트
    jar
    애플리케이션 클라이언트 프로젝트
    app-client
  3. 완료를 클릭하여 대화 상자를 완료하십시오. POM 편집기가 열립니다. 유실된 다른 프로젝트에 대한 참조가 있는 경우 컴파일 오류가 발생할 수 있습니다.
  4. 컴파일 오류를 정리하십시오. 참조하려는 프로젝트를 Maven으로 변환하고 해당 프로젝트에 Maven 종속성을 추가하십시오. 다른 모듈에 종속성 추가을 참조하십시오.
  5. 프로젝트를 업데이트하십시오. 프로젝트를 변경한 후에 프로젝트를 마우스 오른쪽 단추로 클릭하고 Maven > 프로젝트 업데이트를 선택하십시오.

EAR 프로젝트 변환

이 태스크 정보

EAR 프로젝트 변환에는 다음과 같은 여러 태스크가 포함됩니다.
  1. 컨텐츠 폴더 작성.
  2. EAR 프로젝트 변환.
  3. EAR에 모듈 추가.
  4. 다른 모듈에 종속성 추가.
  5. EAR 라이브러리 디렉토리에 라이브러리 추가.
다음 단계를 수행하여 이러한 태스크를 완료하십시오.

컨텐츠 폴더 작성

이 태스크 정보

기본 작업공간 환경 설정을 사용하여 WebSphere® Application Server Developer Tools에서 EAR 프로젝트가 작성된 경우 EAR의 컨텐츠 디렉토리가 비어 있습니다. 즉, 프로젝트의 루트 폴더에 있는 모든 항목이 EAR 파일에 포함됩니다. 프로젝트에 컨텐츠 폴더가 없으면 컨텐츠 디렉토리를 작성해야 합니다.

프로시저

  1. EAR에 컨텐츠 폴더가 있는지 확인하십시오.
    1. 프로젝트를 마우스 오른쪽 단추로 클릭하고 특성 > 배치 어셈블리를 선택하십시오.
    2. 다음 이미지와 같이 /(루트)에 맵핑되는 컨텐츠 폴더가 표시되는 경우 EAR에는 프로젝트의 루트 이외의 컨텐츠 폴더가 있습니다.
      루트가 아닌 컨텐츠 폴더
    3. 다음 이미지와 같이 프로젝트의 루트가 루트에 맵핑된 경우 프로젝트에는 컨텐츠 디렉토리가 없습니다.
      루트인 컨텐츠 폴더
  2. 프로젝트에 컨텐츠 폴더가 없으면 배치 어셈블리 페이지에서 취소를 클릭하고 다음 단계를 수행하여 작성하십시오.
    1. EAR 프로젝트를 마우스 오른쪽 단추로 클릭하고 새로 작성 > 폴더를 선택하십시오. 폴더 이름에서 폴더 구조의 이름을 입력하십시오. Maven 프로젝트의 경우 권장되는 폴더 구조는 src/main/application입니다. 완료를 클릭하십시오.
      폴더 구조 작성
    2. 배치 어셈블리 페이지에 액세스하십시오. 프로젝트를 마우스 오른쪽 단추로 클릭하고 특성 > 배치 어셈블리를 선택하십시오.
    3. 프로젝트의 루트를 EAR 루트에 맵핑하는 항목을 선택하고 제거를 클릭하십시오.
    4. 추가를 클릭하고 폴더를 선택한 후 다음을 클릭하십시오.
    5. 작성한 폴더를 선택하고 완료를 클릭하십시오. 예를 들어 권장되는 폴더 구조를 작성한 경우 src/main 아래 application 폴더를 선택하십시오.
      폴더 선택
    6. 구조를 확인하십시오. 배치 어셈블리 섹션에서 이제 작성한 폴더가 프로젝트의 루트에 맵핑됩니다. 다음 이미지에서는 src/main/application 폴더를 작성한 경우 예제를 보여줍니다.
      루트에 맵핑된 폴더
    7. 확인을 클릭하여 배치 어셈블리 맵핑을 완료하십시오.
    8. 프로젝트의 루트에서 작성한 폴더로 EAR에 포함하려는 모든 자원을 이동하십시오. 예를 들어 권장되는 폴더 구조 src/main/application을 사용하며, EAR에 배치 디스크립터가 있는 경우 META-INF 폴더를 EAR 파일의 루트에서 application 폴더로 이동하십시오.

EAR 프로젝트 변환

이 태스크 정보

프로젝트를 변환할 때 다른 아티팩트에 대해 보유한 종속성과 프로젝트에서 아티팩트에 액세스하는 방법을 명심하십시오. 비Maven 프로젝트에서 이 정보는 프로젝트 메타데이터 및 MANIFEST.MF 파일에 직접 지정됩니다. 그러나 Maven 프로젝트에서 종속성은 pom.xml 파일에 지정됩니다. EAR에 속한 모듈, 라이브러리 디렉토리(EAR 버전 5 또는 최신 버전)를 사용하여 다른 모듈에 대해 공유되는 라이브러리 또는 기타 종속성을 기록하십시오.

먼저 배치 어셈블리 페이지를 사용하여 종속성 정보를 수집하십시오.
  1. 프로젝트를 마우스 오른쪽 단추로 클릭하십시오.
  2. 특성 > 배치 어셈블리를 선택하십시오.
  3. EAR에 속한 모듈을 기록하십시오.
  4. EAR 버전이 5 이상인 경우 EAR 라이브러리 디렉토리 값을 기록하십시오.
  5. 라이브러리 디렉토리에 있는 JAR 파일 및 프로젝트를 기록하십시오. 이러한 파일을 식별하려면 라이브러리 디렉토리의 값으로 시작하는 배치 경로를 포함하는 JAR 파일 및 프로젝트를 찾아보십시오.
참고: 프로젝트를 변환하기 전에 EAR의 배치 디스크립터 파일, META-INF/application.xml(있는 경우)의 사본을 저장하십시오. 변환 중에 기존 배치 디스크립터는 빈 배치 디스크립터로 대체되므로 사본을 저장해야 합니다.

프로시저

  1. 프로젝트를 마우스 오른쪽 단추로 클릭하고 구성 > Maven 프로젝트로 변환을 선택하십시오.
  2. Maven POM 대화 상자를 완료하십시오. 그룹 ID, 아티팩트 ID, 버전을 입력하거나 기본값을 승인하십시오. 선택적으로 이름설명을 입력하십시오. 패키지에서 ear을 입력하십시오.
  3. 완료를 클릭하십시오. POM 편집기가 열립니다.
    참고: EAR에 배치 디스크립터가 있으면 빈 새 배치 디스크립터가 생성됩니다. 원래 배치 디스크립터가 보안 역할과 같은 요소를 포함한 경우 pom.xml 파일에서 요소를 구성하십시오. 자세한 정보는 Maven EAR plugin을 참조하십시오.
  4. 프로젝트를 업데이트하십시오. 프로젝트를 변경한 후에 프로젝트를 마우스 오른쪽 단추로 클릭하고 Maven > 프로젝트 업데이트를 선택하십시오.
  5. EAR 변환을 완료하려면 다음 세 가지 태스크를 완료해야 합니다.
    1. EAR 프로젝트에 모듈 추가
    2. 다른 모듈에 종속성 추가
    3. EAR 라이브러리 디렉토리에 라이브러리 추가
주제 유형을 표시하는 아이콘 태스크 주제
Information Center의 이용 약관 | 피드백

시간소인 아이콘 마지막 업데이트 날짜: 2014-05-22

파일 이름: convert.html