다음을 통해 공유


Soapsuds 도구(Soapsuds.exe)

Soapsuds 도구를 사용하면 Remoting이라는 기법을 사용하여 XML Web services 와 통신하는 클라이언트 응용 프로그램을 컴파일 할 수 있습니다. Soapsuds.exe는 다음과 같은 기능을 수행합니다.

  • 공용 언어 런타임 어셈블리에 노출된 서비스를 기술하는 XML 스키마를 만듭니다.

  • XML 스키마에서 기술한 서비스에 액세스하기 위해 런타임 어셈블리를 만듭니다. 스키마 정의는 로컬 파일을 사용하거나 인터넷에서 동적으로 다운로드할 수 있습니다.

Note참고:

.NET Framework 버전 3.5부터는 이 도구가 사용되지 않습니다. 대신 클라이언트 프로젝트에서 원격 개체의 DLL에 대한 참조를 설정합니다. 그러면 컴파일러에서 메타데이터를 추출할 수 있습니다.

soapsuds {-url:schemaUrl | -types:type1,assemblyname[,serviceEndpoint]
[;type2,assemblyname][...]] | -is:schemafile | -ia:assemblyfile} [options]
옵션 설명

-domain:domain

또는

-d:domain

인증을 위해 도메인 이름을 필요로 하는 서버에 연결할 때 사용할 도메인 이름을 지정합니다.

-generatecode

또는

-gc

코드를 생성합니다. 이 옵션은 -od:.를 사용하는 것과 같습니다. 마침표는 코드를 현재 디렉터리에 두어야 한다는 것을 나타냅니다.

-httpproxyname:name

또는

-hpn:name

HTTP 프록시 서버를 통해 서버에 연결할 때 사용할 HTTP 프록시 이름을 지정합니다.

-httpproxyport:number

또는

-hpp:number

HTTP 프록시 서버를 통해 서버에 연결할 때 사용할 HTTP 프록시 포트 번호를 지정합니다.

-inputassemblyfile: assemblyfile

또는

-ia:assemblyfile

입력 어셈블리 파일을 지정합니다. 이 도구는 어셈블리에서 모든 형식을 가져옵니다. 입력 어셈블리를 지정하는 경우 확장명이 .exe 또는 .dll인 파일은 포함하지 마십시오.

-inputdirectory:directory

또는

-id:directory

입력 동적 연결 라이브러리 파일(DLL)의 디렉터리 위치를 지정합니다.

-inputschemafile:schemafile

또는

-is:schemafile

입력 XML 스키마 파일을 지정합니다.

-nowrappedproxy

또는

-nowp

래핑된 프록시를 만들지 않습니다. 이 옵션을 지정하지 않으면 기본적으로 래핑된 프록시가 만들어집니다.

-outputassemblyfile:assemblyfile

또는

-oa:assemblyfile

지정된 어셈블리 파일에 출력을 저장합니다. Soapsuds.exe는 어셈블리를 생성할 때 항상 소스 코드를 생성합니다.

-outputdirectory:outputdirectory

또는

-od:outputdirectory

지정된 출력 디렉터리에 출력을 저장합니다.

-outputschemafile:schemafile

또는

-os:schemafile

지정된 XML 스키마 파일에 출력을 저장합니다.

-password:password

또는

-p:password

인증이 필요한 서버에 연결할 때 사용할 암호를 지정합니다.

-proxynamespace:namespace

또는

-pn

생성된 프록시에 코드의 네임스페이스를 지정합니다. 이 옵션은 interop 네임스페이스에만 사용할 수 있습니다.

-sdl

SDL(Service Description Language) 스키마를 생성합니다. 이 옵션을 지정하지 않으면 WSDL(Web Services Description Language) 스키마가 생성됩니다. SDL에 대한 자세한 내용은 XML Web services 설명을 참조하십시오.

-serviceendpoint:URL

또는

-se:URL

WSDL 파일에 포함할 서비스 끝점의 URL 또는 URL 경로를 지정합니다.

-strongnamefile:filename

또는

-sn:filename

filename에 있는 키 쌍으로 생성되는 어셈블리에 서명합니다. 강력한 이름 도구(Sn.exe)를 사용하여 이 파일을 생성할 수 있습니다.

-types:type1,assemblyname[,serviceEndpoint] [;type2,assemblyname[,serviceEndpoint]] [...]

입력 형식 목록을 지정합니다.

-urltoschema:schemaURL

또는

-url:schemaURL          

XML 스키마를 검색할 URL을 지정합니다.

-username:username

또는

-u:username

인증이 필요한 서버에 연결할 때 사용할 사용자 이름을 지정합니다.

-wrappedproxy

또는

-wp

래핑된 프록시를 만듭니다. 기본값입니다.

-wsdl

WSDL 스키마를 생성합니다. 기본값입니다. 자세한 내용은 Web Services 설명을 참조하십시오.

'

설명

클라이언트 응용 프로그램에서 XML Web services에 액세스하려면 다음 단계를 수행하십시오.

  1. XML Web services의 XML 스키마를 다운로드합니다. 도구의 -urltoschema 옵션을 사용하면 해당 URL을 사용하여 스키마를 직접 참조할 수 있습니다. XML Web services는 XML Web services를 게시할 때 자동으로 이 스키마 파일을 생성합니다.

  2. Soapsuds.exe를 사용하여 XML 스키마를 런타임 어셈블리로 변환합니다. 이 도구는 어셈블리를 생성할 때 항상 소스 코드를 생성합니다.

  3. 응용 프로그램을 컴파일할 때 클라이언트 응용 프로그램에서 이 어셈블리를 참조합니다. 또한 응용 프로그램에서 이 어셈블리의 형식을 XML Web services에 대한 프록시로 인식할 수 있도록 원격을 설정해야 합니다. 자세한 내용은 .NET Remoting 개요를 참조하십시오.

예제

다음 명령은 URL에서 스키마를 다운로드하여 XML 파일에 저장합니다.

soapsuds -url:https://localhost/Service/MyService.soap?wsdl 
-os:MyService.xml

다음 명령은 URL에서 스키마를 다운로드하여 코드를 생성합니다.

soapsuds -url:https://localhost/Service/MyService.soap?wsdl -gc

다음 명령은 URL에서 스키마를 다운로드하여 파일에 저장한 다음 코드를 생성합니다.

soapsuds -url:https://localhost/Service/MyService.soap?wsdl 
-os:StockQuote.xml -gc

다음 명령은 URL에서 스키마를 다운로드하여 코드를 생성하고 컴파일한 다음 어셈블리를 생성합니다.

soapsuds -url:https://localhost/Service/MyService.soap?wsdl 
-oa:StockQuote.dll

다음 명령은 형식을 스키마로 변환한 다음 파일에 저장합니다.

soapsuds -types:MyClass.MyMethod,Service -os:StockQuote.xml

다음 명령은 형식을 스키마로 변환한 다음 코드를 생성합니다.

soapsuds -types:MyClass.MyMethod,Service -gc

다음 명령은 형식을 스키마로 변환하여 파일에 저장한 다음 코드를 생성합니다.

soapsuds -types:MyClass.MyMethod,Service -os:MyService.xml -gc 

참고 항목

참조

웹 서비스 기술 언어 도구(Wsdl.exe)
웹 서비스 검색 도구(Disco.exe)

개념

XML Web services 개요

기타 리소스

.NET Framework Tools
.NET Remoting Overview
Strong Name Tool (Sn.exe)
SDK Command Prompt

Footer image

Copyright © 2007 by Microsoft Corporation. All rights reserved.