Oracle Database 솔루션 아티팩트용 WCF 클라이언트 또는 WCF 서비스 계약 생성
어댑터 서비스 참조 Visual Studio 플러그 인 추가를 사용하여 Oracle 데이터베이스 아티팩트에서 선택한 작업을 대상으로 하는 WCF 클라이언트 클래스 또는 WCF 서비스 계약(인터페이스)을 생성할 수 있습니다. ServiceModel 메타데이터 유틸리티 도구(svcutil.exe)를 사용하여 WCF 클라이언트 클래스 또는 WCF 서비스 계약을 생성할 수도 있습니다. 그러나 어댑터 서비스 참조 추가 플러그 인은 표준 Microsoft Windows 인터페이스를 통해 ServiceModel 메타데이터 유틸리티 도구의 기능을 노출합니다. 또한 svcutil.exe 도구에서 사용할 수 없는 찾아보기 및 검색 기능을 제공하며 Oracle 데이터베이스에 연결할 때 선택한 바인딩 속성을 기반으로 구성 파일을 생성합니다.
어댑터 서비스 참조 플러그 인 추가를 사용하여 클라이언트 클래스 생성
어댑터 서비스 참조 플러그 인 추가를 사용하여 WCF 클라이언트 클래스를 생성하려면 다음 단계를 수행합니다.
WCF 클라이언트 클래스를 생성하려면
Visual Studio 솔루션 탐색기 프로젝트를 마우스 오른쪽 단추로 클릭한 다음 어댑터 서비스 참조 추가를 클릭합니다.
어댑터 서비스 참조 추가 대화 상자가 열리면 Visual Studio에서 Oracle 작업에 대한 메타데이터 검색의 단계에 따라 Oracle 데이터베이스에 연결하고 작업을 찾아 검색합니다. 선택한 작업에 대한 WCF 클라이언트 클래스를 만들려면 계약 유형 선택 드롭다운 목록에서 클라이언트(아웃바운드 작업)가 선택되어 있는지 확인합니다(기본값).
대상으로 지정할 작업을 모두 선택한 후 확인을 클릭하여 WCF 클라이언트 클래스를 생성합니다.
어댑터 서비스 참조 플러그 인 추가는 프로젝트에 두 개의 파일을 추가합니다.
OracleDBBindingClient.cs. 이 파일에는 선택한 작업에 대해 생성된 WCF 클라이언트 클래스 및 도우미 코드가 포함되어 있습니다.
를App.config. 이 파일에는 바인딩 구성 및 클라이언트 엔드포인트 구성이 포함되어 있습니다. 이러한 구성은 어댑터 서비스 참조 추가 플러그 인에 대한 바인딩 및 연결을 구성할 때 선택한 항목을 기반으로 합니다.
중요
어댑터 서비스 참조 Visual Studio 플러그 인 추가를 사용하는 동안 문자열 형식의 바인딩 속성에 대한 값을 지정하지 않고 기본값이 null인 경우 해당 바인딩 속성을 app.config 파일에서 사용할 수 없습니다. 필요한 경우 바인딩 속성과 해당 값을 app.config 파일에 수동으로 추가해야 합니다.
어댑터 서비스 참조 플러그 인 추가를 사용하여 WCF 서비스 계약 생성
어댑터는 Oracle 데이터베이스가 어댑터 클라이언트에 메시지를 보낼 수 있도록 인바운드 작업을 노출합니다. 이러한 작업의 경우 WCF 서비스 계약을 생성해야 합니다. 예를 들어 어댑터는 Oracle 데이터베이스를 폴링하는 인바운드 POLLSTMT 작업을 노출합니다. Oracle Database 어댑터는 PollingStatement 바인딩 속성에 지정된 쿼리를 실행하고 결과 집합을 POLLINGSTMT 메시지에서 사용하는 애플리케이션으로 보냅니다. 이 시나리오에서 소비하는 애플리케이션은 서비스 역할을 하며 Oracle 데이터베이스 어댑터는 클라이언트 역할을 합니다. 따라서 어댑터에서 POLLINGSTMT 작업을 받을 수 있는 WCF 서비스를 구현해야 합니다. 이렇게 하려면 어댑터 서비스 참조 플러그 인 추가를 사용하여 POLLINGSTMT 작업에 대해 어댑터에 의해 표시되는 서비스 계약을 나타내는 .NET 인터페이스를 생성합니다. 이 .NET 인터페이스를 WCF 서비스 계약이라고도 합니다. 그런 다음 이 인터페이스를 구현하여 POLLINGSTMT 작업을 수신하는 데 사용할 수 있는 WCF 서비스를 만듭니다.
이 섹션에서는 어댑터에 의해 노출되는 인바운드 작업에 어댑터 서비스 참조 플러그 인 추가를 사용하여 WCF 서비스 계약을 생성하는 방법에 대한 정보를 제공합니다.
인바운드 작업에 대한 WCF 서비스 계약을 생성하려면
Visual Studio 솔루션 탐색기 프로젝트를 마우스 오른쪽 단추로 클릭한 다음 어댑터 서비스 참조 추가를 클릭합니다.
어댑터 서비스 참조 추가 대화 상자가 열리면 Visual Studio에서 Oracle 작업에 대한 메타데이터 검색의 단계에 따라 Oracle 데이터베이스에 연결합니다. 인바운드 작업을 위해 Oracle 데이터베이스에 연결할 때 설정할 수 있는 여러 바인딩 속성과 URI 속성이 있습니다. 예를 들어 인바운드 폴링 작업(POLLINGSTMT)의 경우 Oracle 데이터베이스에 대한 연결을 구성할 때 PollingStatement 바인딩 속성을 지정해야 합니다. Oracle Database 어댑터는 이 속성에 지정된 SQL SELECT 문을 사용하여 POLLINGSTMT 작업에서 반환된 결과 집합을 나타내는 클래스를 생성합니다.
Oracle 데이터베이스에 연결한 후 계약 유형 선택 드롭다운 목록에서 서비스(인바운드 작업)를 선택합니다.
범주 선택 상자에서 루트 노드(/)를 클릭하고 서비스 계약을 생성하려는 작업을 찾습니다. 예를 들어 폴링 작업의 경우 사용 가능한 범주 및 작업 상자에서 POLLINGSTMT를 선택하고 추가를 클릭합니다.
POLLINGSTMT 작업에 대한 WCF 서비스 계약을 생성하려면 확인을 클릭합니다.
어댑터 서비스 참조 플러그 인 추가는 프로젝트에 세 개의 파일을 추가합니다.
OracleDBBindingInterface.cs. 이 파일에는 POLLINGSTMT 작업에 대해 생성된 WCF 서비스 계약(인터페이스) 및 도우미 코드가 포함되어 있습니다.
OracleDBBindingService.cs. 이 파일에는 OracleDBBindingInterface.cs에 정의된 인터페이스를 구현하는 클래스가 포함되어 있습니다. 이 클래스의 POLLINGSTMT 메서드에서 폴링 쿼리에서 반환된 레코드를 처리하는 비즈니스 논리를 구현할 수 있습니다.
를App.config. 이 파일에는 어댑터 서비스 참조 추가 플러그 인에 대한 바인딩 및 연결을 구성할 때 선택한 항목을 기반으로 하는 바인딩 구성, 엔드포인트 동작 및 서비스 엔드포인트 구성이 포함되어 있습니다.
중요
어댑터 서비스 참조 Visual Studio 플러그 인 추가를 사용하는 동안 문자열 형식의 바인딩 속성에 대한 값을 지정하지 않고 기본값이 null인 경우 해당 바인딩 속성을 app.config 파일에서 사용할 수 없습니다. 필요한 경우 바인딩 속성과 해당 값을 app.config 파일에 수동으로 추가해야 합니다.
svcutil.exe 사용하여 WCF 클라이언트 클래스 또는 WCF 서비스 계약 생성
svcutil.exe 사용하여 애플리케이션에 대한 WCF 클라이언트 클래스 또는 WCF 서비스 인터페이스를 생성할 수 있습니다. Oracle 데이터베이스 어댑터와 함께 사용하도록 svcutil.exe 구성해야 합니다. Oracle 데이터베이스 어댑터에서 svcutil.exe 구성하고 사용하는 방법에 대한 자세한 내용은 BizTalk Adapter for Oracle Database에서 ServiceModel 메타데이터 유틸리티 도구 사용을 참조하세요.
Svcutil.exe 출력 파일에서 WCF 클라이언트 클래스 또는 WCF 서비스 계약을 생성합니다. 기본 파일 이름은 output.cs입니다. Visual Studio 프로젝트에 이 파일을 수동으로 포함해야 합니다.
참고 항목
WCF 서비스 모델을 사용하여 Oracle 데이터베이스 애플리케이션 개발
WCF 서비스 모델을 사용하여 SQL에서 기본 삽입, 업데이트, 삭제 및 작업 선택 수행