런타임 시 SQL 데이터베이스 연결 사용
런타임 시에 SQL 연결을 사용하려면 프로젝트의 빌드 디스크립터가 이 연결을 가리키도록 해야 하며, EGL 웹 프로젝트의 경우에는 연결에 있는 정보를 기반으로 J2EE 배치 디스크립터의 옵션을 설정해야 합니다.
전제조건
SQL 데이터베이스에 대해 올바르게 작동하는 연결이 있어야 하며, 프로세스를 진행하는 중에 이를 작성할 수도 있습니다. 이 연결을 설정하는 데 대한 지시사항은 SQL 데이터베이스 연결 작성의 내용을 참조하십시오.
EGL 웹 프로젝트를 위한 런타임 연결 작성
EGL 웹 프로젝트의 경우에는 연결에 있는 정보를 기반으로 프로젝트에 옵션을 설정해야 합니다. EGL은 프로젝트의 EGL 런타임 데이터 소스 특성 페이지를 통해 이러한 작업의 대부분을 자동으로 수행할 수 있습니다.
- EGL이 프로젝트의 마스터 빌드 디스크립터에 있는 다음 빌드 디스크립터 옵션을 업데이트합니다.
- dbms
- sqlDB
- sqlID
- sqlJDBCDriverClass
- sqlJNDIName
- sqlPassword
- sqlValidationConnectionURL
- 웹 프로젝트가 엔터프라이즈 애플리케이션 자원(EAR) 프로젝트의 모듈 역할을 수행하고 있는 경우 EGL은 EAR 프로젝트의 배치 디스크립터에 데이터 소스를 추가합니다.
이 데이터 소스는 JNDI 이름을 데이터베이스 자체와 연관시킵니다. 그 후에는 EAR 프로젝트 내에서 모듈 역할을 수행하고 있는 다른 프로젝트가 JNDI 이름을 통해 데이터베이스에 액세스할 수 있습니다.
웹 프로젝트가 EAR 프로젝트 내의 모듈이 아닌 경우에는 JNDI 이름을 서버에 있는 데이터베이스와 수동으로 연관시켜야 합니다. JDBC 데이터 소스를 작성하는 방법은 서버 문서를 참조하십시오.
- EGL이 프로젝트의 웹 배치 디스크립터에 JNDI 이름에 대한 참조를 추가합니다. 그 후에는 EAR 프로젝트 또는 서버가 해당 JNDI 이름을 데이터 소스에 링크하고 있는 한 프로젝트가 이 JNDI 이름을 통해 데이터 소스에 액세스할 수 있습니다.
- 프로젝트를 마우스 오른쪽 단추로 클릭한 후 특성을 클릭하십시오.
- 특성 창에서 EGL 런타임 데이터 소스를 클릭하십시오.
- EGL 런타임 데이터 소스 페이지에서 데이터 도구 연결로부터 값 로드를 선택하고 연결 목록에서 데이터베이스 연결을 선택하십시오. 새로 작성을 클릭하고 새 연결을 작성할 수도 있습니다. 연결을 작성하는 데 대한 정보는 SQL 데이터베이스 연결 작성의 내용을 참조하십시오.
- 연결을 선택하면 EGL은 해당 연결에 있는 정보를 사용하여 페이지에 있는 필드를 채웁니다. 값을 수동으로 입력/수정을 클릭하고 필드에 있는 값을 편집함으로써
이러한 값을 편집할 수 있습니다. 개별 필드에 대한 정보는 새 연결 마법사의 필드의 내용을 참조하십시오.
데이터베이스 연결의 정보 외에, EGL은 연결의 JNDI 이름을 작성합니다. 기본적으로 이 이름은 데이터베이스 연결의 이름에 접두부 jdbc/를 추가한 것입니다. 사용자는 기본값을 수락하거나 JNDI 이름 필드를 편집할 수 있습니다.
- EGL이 이 프로젝트와 연관된 EAR 배치 디스크립터에 데이터 소스를 설정하지 않도록 하려는 경우에는 값을 수동으로 입력/수정을 클릭하고 애플리케이션이 단위 테스트 서버에서 실행되면 데이터베이스 및 연결 특성 배치를 선택 취소하십시오.
- 확인을 클릭하여 프로젝트에 업데이트를 적용하십시오.
런타임 데이터 소스가 수정되면 프로젝트의 기본 빌드 옵션을 업데이트함 환경 설정이 항상으로 설정된 경우 EGL은 연결 정보를 기반으로 빌드 디스크립터 옵션을 자동으로 업데이트합니다. 이 환경 설정이 프롬프트로 설정되어 있는 경우에는 EGL이 빌드 디스크립터 옵션을 업데이트하기 전에 진행 여부를 묻습니다. 이 환경 설정이 수행 안함으로 설정되어 있는 경우에는 빌드 디스크립터 옵션이 변경되지 않습니다.
EGL 프로젝트의 런타임 연결 작성
- 프로젝트의 빌드 디스크립터를 두 번 클릭하십시오. 일반적으로 빌드 디스크립터 파일은 프로젝트에 있는 EGLSource 디렉토리의 최상위 레벨에 있으며 project.eglbld로 이름 지정되어 있습니다. 이 빌드 디스크립터가 빌드 파트 편집기에서 열립니다.
- 연결을 사용하여 DB 옵션 로드 목록에서 사용할 데이터베이스 연결을 선택하십시오.
이 연결을 이미 작성하지 않은 경우에는 SQL 데이터베이스 연결 작성의 내용을 참조하십시오.
연결을 선택하면 빌드 파트 편집기는 연결과 일치하도록 다음 빌드 디스크립터 옵션을 업데이트합니다.
- dbms
- sqlDB
- sqlID
- sqlJDBCDriverClass
- sqlPassword
- sqlValidationConnectionURL
- 빌드 디스크립터를 저장하고 창을 닫으십시오.
- 데이터베이스 연결을 사용하는 파트를 생성하십시오.
오류 조건
- 새 연결 마법사에서 클래스 위치를 지정한 후에도 EGL이 데이터베이스 관리자의 드라이버를 포함하는 Java™ 클래스를 찾지 못할 수 있습니다.
이러한 오류를 정정하려면 프로젝트의 클래스 경로에 해당 드라이버가 있는지 확인하십시오.
- 프로젝트 이름을 프로젝트 탐색기 보기에서 마우스 오른쪽 단추로 클릭하고 팝업 메뉴에서 특성을 클릭하십시오.
- 특성 창의 왼쪽 분할창에서 Java 빌드 경로를 선택하십시오.
- Java 빌드 경로 페이지에서 라이브러리 탭을 클릭하십시오.
- 올바른 클래스 위치가 표시되지 않는 경우에는 외부 JAR 추가를 클릭하고 클래스 및 위치를 추가하십시오. 이 정보는 연결로부터 복사할 수 있습니다. SQL 데이터베이스 연결 편집 또는 삭제의 내용을 참조하십시오.