런타임 시 SQL 데이터베이스 연결 사용

런타임 시에 SQL 연결을 사용하려면 프로젝트의 빌드 디스크립터가 이 연결을 가리키도록 해야 하며, EGL 웹 프로젝트의 경우에는 연결에 있는 정보를 기반으로 J2EE 배치 디스크립터의 옵션을 설정해야 합니다.

전제조건

SQL 데이터베이스에 대해 올바르게 작동하는 연결이 있어야 하며, 프로세스를 진행하는 중에 이를 작성할 수도 있습니다. 이 연결을 설정하는 데 대한 지시사항은 SQL 데이터베이스 연결 작성의 내용을 참조하십시오.

EGL 웹 프로젝트를 위한 런타임 연결 작성

EGL 웹 프로젝트의 경우에는 연결에 있는 정보를 기반으로 프로젝트에 옵션을 설정해야 합니다. EGL은 프로젝트의 EGL 런타임 데이터 소스 특성 페이지를 통해 이러한 작업의 대부분을 자동으로 수행할 수 있습니다.

  • EGL이 프로젝트의 마스터 빌드 디스크립터에 있는 다음 빌드 디스크립터 옵션을 업데이트합니다.
    • dbms
    • sqlDB
    • sqlID
    • sqlJDBCDriverClass
    • sqlJNDIName
    • sqlPassword
    • sqlValidationConnectionURL
    EGL이 이러한 빌드 디스크립터 옵션을 업데이트할지 또는 하지 않을지는 빌드 디스크립터 환경 설정 설정에 설명되어 있는 바와 같이 빌드 디스크립터 환경 설정에 따라 달라집니다. EGL이 빌드 디스크립터 옵션을 업데이트하도록 하려는 경우에는 런타임 데이터 소스가 수정되면 프로젝트의 기본 빌드 옵션을 업데이트함프롬프트 또는 항상으로 설정하십시오.
  • 웹 프로젝트가 엔터프라이즈 애플리케이션 자원(EAR) 프로젝트의 모듈 역할을 수행하고 있는 경우 EGL은 EAR 프로젝트의 배치 디스크립터에 데이터 소스를 추가합니다. 이 데이터 소스는 JNDI 이름을 데이터베이스 자체와 연관시킵니다. 그 후에는 EAR 프로젝트 내에서 모듈 역할을 수행하고 있는 다른 프로젝트가 JNDI 이름을 통해 데이터베이스에 액세스할 수 있습니다.

    웹 프로젝트가 EAR 프로젝트 내의 모듈이 아닌 경우에는 JNDI 이름을 서버에 있는 데이터베이스와 수동으로 연관시켜야 합니다. JDBC 데이터 소스를 작성하는 방법은 서버 문서를 참조하십시오.

  • EGL이 프로젝트의 웹 배치 디스크립터에 JNDI 이름에 대한 참조를 추가합니다. 그 후에는 EAR 프로젝트 또는 서버가 해당 JNDI 이름을 데이터 소스에 링크하고 있는 한 프로젝트가 이 JNDI 이름을 통해 데이터 소스에 액세스할 수 있습니다.
  1. 프로젝트를 마우스 오른쪽 단추로 클릭한 후 특성을 클릭하십시오.
  2. 특성 창에서 EGL 런타임 데이터 소스를 클릭하십시오.
  3. EGL 런타임 데이터 소스 페이지에서 데이터 도구 연결로부터 값 로드를 선택하고 연결 목록에서 데이터베이스 연결을 선택하십시오. 새로 작성을 클릭하고 새 연결을 작성할 수도 있습니다. 연결을 작성하는 데 대한 정보는 SQL 데이터베이스 연결 작성의 내용을 참조하십시오.
  4. 연결을 선택하면 EGL은 해당 연결에 있는 정보를 사용하여 페이지에 있는 필드를 채웁니다. 값을 수동으로 입력/수정을 클릭하고 필드에 있는 값을 편집함으로써 이러한 값을 편집할 수 있습니다. 개별 필드에 대한 정보는 새 연결 마법사의 필드의 내용을 참조하십시오.

    데이터베이스 연결의 정보 외에, EGL은 연결의 JNDI 이름을 작성합니다. 기본적으로 이 이름은 데이터베이스 연결의 이름에 접두부 jdbc/를 추가한 것입니다. 사용자는 기본값을 수락하거나 JNDI 이름 필드를 편집할 수 있습니다.

  5. EGL이 이 프로젝트와 연관된 EAR 배치 디스크립터에 데이터 소스를 설정하지 않도록 하려는 경우에는 값을 수동으로 입력/수정을 클릭하고 애플리케이션이 단위 테스트 서버에서 실행되면 데이터베이스 및 연결 특성 배치를 선택 취소하십시오.
  6. 확인을 클릭하여 프로젝트에 업데이트를 적용하십시오.

    런타임 데이터 소스가 수정되면 프로젝트의 기본 빌드 옵션을 업데이트함 환경 설정이 항상으로 설정된 경우 EGL은 연결 정보를 기반으로 빌드 디스크립터 옵션을 자동으로 업데이트합니다. 이 환경 설정이 프롬프트로 설정되어 있는 경우에는 EGL이 빌드 디스크립터 옵션을 업데이트하기 전에 진행 여부를 묻습니다. 이 환경 설정이 수행 안함으로 설정되어 있는 경우에는 빌드 디스크립터 옵션이 변경되지 않습니다.

EGL 프로젝트의 런타임 연결 작성

  1. 프로젝트의 빌드 디스크립터를 두 번 클릭하십시오. 일반적으로 빌드 디스크립터 파일은 프로젝트에 있는 EGLSource 디렉토리의 최상위 레벨에 있으며 project.eglbld로 이름 지정되어 있습니다. 이 빌드 디스크립터가 빌드 파트 편집기에서 열립니다.
  2. 연결을 사용하여 DB 옵션 로드 목록에서 사용할 데이터베이스 연결을 선택하십시오. 이 연결을 이미 작성하지 않은 경우에는 SQL 데이터베이스 연결 작성의 내용을 참조하십시오.
    연결을 선택하면 빌드 파트 편집기는 연결과 일치하도록 다음 빌드 디스크립터 옵션을 업데이트합니다.
    • dbms
    • sqlDB
    • sqlID
    • sqlJDBCDriverClass
    • sqlPassword
    • sqlValidationConnectionURL
  3. 빌드 디스크립터를 저장하고 창을 닫으십시오.
  4. 데이터베이스 연결을 사용하는 파트를 생성하십시오.

오류 조건

EGL이 런타임 시에 데이터베이스와 연결하는 데 디자인 시에 사용했던 프로세스와 다른 프로세스를 사용합니다. 이러한 차이는 코드를 실행하려 할 때 오류를 발생시킬 수 있습니다.
  • 새 연결 마법사에서 클래스 위치를 지정한 후에도 EGL이 데이터베이스 관리자의 드라이버를 포함하는 Java™ 클래스를 찾지 못할 수 있습니다. 이러한 오류를 정정하려면 프로젝트의 클래스 경로에 해당 드라이버가 있는지 확인하십시오.
    1. 프로젝트 이름을 프로젝트 탐색기 보기에서 마우스 오른쪽 단추로 클릭하고 팝업 메뉴에서 특성을 클릭하십시오.
    2. 특성 창의 왼쪽 분할창에서 Java 빌드 경로를 선택하십시오.
    3. Java 빌드 경로 페이지에서 라이브러리 탭을 클릭하십시오.
    4. 올바른 클래스 위치가 표시되지 않는 경우에는 외부 JAR 추가를 클릭하고 클래스 및 위치를 추가하십시오. 이 정보는 연결로부터 복사할 수 있습니다. SQL 데이터베이스 연결 편집 또는 삭제의 내용을 참조하십시오.
    .