SQL문의 시간종료 값을 설정하고
쿼리 결과로 리턴할 pureQuery의 행 수를
설정할 수 있습니다.
이 태스크 정보
pureQuery 응용프로그램이 실행하는 모든
SQL DML(Data Manipulation Language) 명령문에 대해 전역으로,
또는 응용프로그램이 Data 인터페이스의 구현 인스턴스에서 사용하는
모든 SQL DML문에 대해 로컬로 다음 등록 정보의 값을 설정할 수 있습니다.
개별 명령문에 대해서는 로컬로 이 등록 정보를 설정할 수 없습니다.
pureQuery는
이 등록 정보의 값을 해당되는 JDBC 명령문 메소드로
전달합니다.
- queryTimeoutInSeconds
- 실행할 SQL DML문이 실행될 때까지 대기하는 시간(초).
명령문이 지정된 시간 내에 완료되지 않으면 pureQuery는 SQLException으로 야기된
런타임 예외를 발생합니다. 0 값은 명령문이 무한 실행되도록 합니다.
- maxResultsRow
- 명령문이 쿼리 결과에서 리턴하는 최대 행 수.
행 수가 이 한계에 도달하면 행을 버립니다.
0 값을 사용하면 쿼리 결과에 무한 개수의 행을 포함할 수 있습니다.
조회 결과를 리턴하는 응용프로그램의 모든 명령문이 아니라
개별 명령문에 대해서만 이 최대 행 수를 구성하려면
다음 두 가지의 선택사항 중 하나를 사용하면 됩니다.
- 명령문에서 FETCH
FIRST n ROWS절을 사용하거나 목표 데이터베이스에서 지원하는
이와 동등한 구문을 사용합니다.
- 제한된 행 수를 처리하는 ResultHandler를
사용합니다. 예를 들어, IteratorPagingResultHandler를 사용할 수
있습니다.
프로시저
이 등록 정보의 값을 설정하려면
다음 두 단계 중 하나를 수행하십시오. pureQuery는 두 메소드가
표시되는 순서대로 값을 검색합니다.
- Properties 오브젝트에서 로컬로 값을 설정하십시오.
그런 다음 Properties 오브젝트를 승인하는
DataFactory.getData() 메소드로 Properties 오브젝트를 전달하십시오.
로컬 설정이 전역 설정보다 우선합니다.
예를 들어, 다음과 같이 새 Properties 오브젝트를 작성하고,
값을 설정한 후 오브젝트를 getData() 메소드에 전달할 수 있습니다.
java.util.Properties myPdqProperties = new java.util.Properties();
myPdqProperties.setProperty("pdq.queryTimeoutInSeconds", "5");
myPdqProperties.setProperty(“pdq.maxResultRows”, "100");
Connection connection = ...
Data data = DataFactory.getData (com.MyInterface.class, connection, myPdqProperties);
- pdq.properties 파일에 전역으로 등록 정보를 설정하십시오. 이
파일을 파일 시스템 또는 응용프로그램의 클래스 경로에 배치할 수 있습니다.
로컬 설정이 전역 설정보다 우선합니다.
예를 들어, 다음 항목을 pdq.properties 파일에 추가할 수 있습니다.
pdq.queryTimeoutInSeconds = 5
pdq.maxResultRows = 100
디폴트로 pureQuery는 파일 이름은 pdq.properties이고
파일의 위치는 응용프로그램의 클래스 경로에 있을 것으로
예상합니다.
다른 파일 이름을 사용하거나 파일을 다른 위치에
놓거나 두 경우 모두에 해당되는 경우, 응용프로그램을 실행할 때
다음과 같이
configFile JVM 시스템 등록 정보를 사용하여
파일을 지시하십시오.
-Dpdq.configFile=path-and-file-name or resource-name Java-package.application
웹
응용프로그램을 개발 중인 경우, pdq.properties 파일을 응용프로그램의 WEB-INF/classes 폴더에
두거나 JAR 파일을 WEB-INF/lib 폴더에 두십시오.
독립형 응용프로그램을 개발 중인 경우,
pdq.properties 파일을 임의의 폴더에 두거나 해당 응용프로그램의 클래스 경로에 있는
JAR 파일을 두십시오.