웹 서비스 프록시 만들기

클라이언트와 웹 서비스는 입력 및 출력 매개 변수를 XML로 캡슐화하는 SOAP 메시지를 사용하여 통신할 수 있습니다. 프록시 클래스는 매개 변수를 XML 요소에 매핑한 다음 네트워크를 통해 SOAP 메시지를 보냅니다. 이러한 방식으로 프록시 클래스를 사용하면 SOAP 수준에서 웹 서비스와 통신할 필요가 없으며 SOAP 및 웹 서비스 프록시를 지원하는 모든 개발 환경에서 웹 서비스 메서드를 호출할 수 있습니다.

Microsoft .NET Framework를 사용하여 개발 프로젝트에 프록시 클래스를 추가하는 방법에는 .NET Framework의 WSDL 도구와 Microsoft Visual Studio에서 웹 참조를 추가하는 두 가지 방법이 있습니다. 다음 섹션에서는 이 주제에 대해 자세히 설명합니다.

WSDL 도구를 사용하여 프록시 추가

.NET Framework SDK에는 .NET Framework 개발 환경에서 사용할 웹 서비스 프록시를 생성할 수 있는 웹 서비스 설명 언어 도구(Wsdl.exe)가 포함되어 있습니다. 웹 서비스(현재 C# 및 Microsoft Visual Basic)를 지원하는 언어로 클라이언트 프록시를 만드는 가장 일반적인 방법은 WSDL 도구를 사용하는 것입니다.

Wsdl.exe를 사용하여 프록시 클래스를 프로젝트에 추가하려면

1. 명령 프롬프트에서 Wsdl.exe 사용하여 보고서 서버 웹 서비스에 대한 URL을 최소한으로 지정하여 프록시 클래스를 만듭니다.

   예를 들어 다음 명령 프롬프트 문은 보고서 서버 웹 서비스의 관리 엔드포인트에 대한 URL을 지정합니다.

   wsdl /language:CS /n:"Microsoft.SqlServer.ReportingServices2010" https://<Server Name>/reportserver/reportservice2010.asmx?wsdl  
   

   WSDL 도구는 프록시를 생성하기 위한 여러 명령 프롬프트 인수를 허용합니다. 위의 예에서는 C# 언어 및 웹 서비스 엔드포인트를 두 개 이상 사용하는 경우 이름 충돌 방지를 위해 프록시에 사용하도록 제안된 네임스페이스를 지정하고 ReportingService2010.cs라는 C# 파일을 생성합니다. 예제에서 Visual Basic을 지정한 경우 이 예제에서는 이름이 ReportingService2010.vb 프록시 파일을 생성했을 것입니다. 이 파일은 명령을 실행하는 디렉터리에 만들어집니다.

2. 프록시 클래스를 어셈블리 파일(확장명 .dll 포함)으로 컴파일하고 프로젝트에서 참조하거나 클래스를 프로젝트 항목으로 추가합니다.

   참고 항목

   프로젝트에 프록시 클래스를 수동으로 추가하는 경우 System.Web.Services.dll 대한 참조를 추가해야 합니다. Visual Studio .NET에서 웹 참조를 사용하여 프록시를 추가하는 경우 참조가 자동으로 만들어집니다. 자세한 내용은 이 항목의 후반에 나오는 "Visual Studio에서 웹 참조를 사용하여 프록시 추가"를 참조하십시오.

   프록시 클래스를 프로젝트에 항목으로 추가하면 연결된 파일이 솔루션 탐색기 나타납니다.

3. 서비스를 프로그래밍 방식으로 호출하려면 프록시 클래스의 인스턴스를 만듭니다.

   다음 코드 예제에서는 프로젝트에서 프록시 클래스의 인스턴스를 ReportingService2010 만들기 위한 구문을 보여 줍니다.

Dim service As New ReportingService2010()  

ReportingService2010 service = new ReportingService2010();  
  

전체 구문을 포함하여 Wsdl.exe 도구에 대한 자세한 내용은 .NET Framework SDK 설명서의 "웹 서비스 설명 언어 도구"를 참조하세요. 웹 서비스 프록시에 대한 전체 설명은 .NET Framework SDK 설명서의 "XML 웹 서비스 프록시 만들기"를 참조하세요.

Visual Studio에서 웹 참조를 사용하여 프록시 추가

웹 참조를 사용하면 프로젝트에서 하나 이상의 웹 서비스를 사용할 수 있습니다. Visual Studio를 사용하면 몇 가지 간단한 단계를 수행하여 프로젝트에 웹 서비스 참조를 추가할 수 있습니다.

프로젝트에 웹 참조를 추가하려면

1. 솔루션 탐색기 웹 서비스를 사용할 프로젝트를 선택합니다.

2. 프로젝트 메뉴에서 웹 참조 추가를 클릭합니다.

   웹 참조 추가 대화 상자가 열립니다.

3. URL 필드에 보고서 서버 웹 서비스에 대한 전체 경로를 입력합니다.

   보고서 서버 웹 서비스의 보고서 실행 엔드포인트에 대한 간소화된 URL은 다음과 같습니다.

   https://<Server Name>/reportserver/reportexecution2005.asmx  
   

   URL에는 보고서 서버 웹 서비스가 배포되는 도메인, 서비스를 포함하는 폴더의 이름 및 서비스에 대한 검색 파일의 이름이 포함됩니다. 다른 URL 요소에 대한 전체 설명은 SOAP API 액세스를 참조하세요.

   웹 서비스에서 제공하는 메서드 및 속성에 대한 설명은 왼쪽의 브라우저 창에 나타납니다.

   참고 항목

   보고서 서버 웹 서비스와 연관된 항목에 대한 자세한 내용은 보고서 서버 웹 서비스 메서드를 참조하세요.

4. 프로젝트에서 보고서 서버 웹 서비스를 사용할 수 있고 보고서 서버에 액세스할 수 있는 적절한 권한이 있는지 확인합니다.

5. 보고서 서버 웹 서비스에 프로그래밍 방식으로 액세스하기 위해 코드에 사용할 이름을 웹 참조 이름 필드에 입력합니다.

6. 참조 추가 단추를 선택하여 웹 서비스에 대한 애플리케이션의 참조를 만듭니다.

   새 참조가 솔루션 탐색기에서 활성 프로젝트에 대한 Web References 노드 아래에 웹 참조 이름 필드에 지정한 이름으로 나타납니다.

7. 솔루션 탐색기 웹 참조 폴더를 확장하여 프로젝트의 항목에 사용할 수 있는 웹 참조 클래스의 네임스페이스를 확인합니다.

   프로젝트에 웹 참조를 추가하면 연결된 파일이 솔루션 탐색기 Web References 폴더 내의 폴더에 표시됩니다.

웹 참조를 추가한 후 다음 구문을 사용하여 프록시 클래스의 인스턴스를 만듭니다.

Dim rs As New myNamespace.myReferenceName.ReportExecutionService()  
rs.Url = "https://<Server Name>/reportserver/reportexecution2005.asmx?wsdl"  
rs.Credentials = System.Net.CredentialCache.DefaultCredentials  

myNamespace.myReferenceName.ReportExecutionService rs = new myNamespace.myReferenceName.ReportExecutionService();  
rs.Url = "https://<Server Name>/reportserver/reportexecution2005.asmx?wsdl";  
rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  
  

Using(Visual Basic에서 가져오기) 지시문을 보고서 서버 웹 서비스 참조에 추가할 수도 있습니다. 이 지시문을 사용할 경우에는 네임스페이스에서 형식을 정규화하지 않아도 됩니다. 이렇게 하려면 파일에 다음 코드를 추가합니다.

Import myNamespace.myReferenceName  

using myNamespace.myReferenceName;  

관련 콘텐츠

• 보고서 서버 웹 서비스
• 웹 서비스와 .NET Framework를 사용하여 애플리케이션 빌드
• 기술 참조(SSRS)