Soapsuds 도구(Soapsuds.exe)

아티클
03/02/2011

이 항목은 레거시 기술과 관련된 것입니다. 이제 XML Web services와 XML Web services 클라이언트는 다음을 사용하여 만들어야 합니다. Windows Communication Foundation.

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

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

참고:
.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:namespace	생성된 프록시에 코드의 네임스페이스를 지정합니다. 이 옵션은 상호 운용성 네임스페이스에만 사용할 수 있습니다.
-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 스키마를 생성합니다. 기본값입니다. 자세한 내용은 다음 항목을 참조하십시오. 웹 서비스 설명을 참조하십시오.

설명

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

XML Web services의 XML 스키마를 다운로드합니다. 도구의 -urltoschema 옵션을 사용하면 해당 URL을 사용하여 스키마를 직접 참조할 수 있습니다. XML Web services는 XML Web services를 게시할 때 자동으로 이 스키마 파일을 생성합니다.
Soapsuds.exe를 사용하여 XML 스키마를 런타임 어셈블리로 변환합니다. 이 도구는 어셈블리를 생성할 때 항상 소스 코드를 생성합니다.
응용 프로그램을 컴파일할 때 클라이언트 응용 프로그램에서 이 어셈블리를 참조합니다. 또한 응용 프로그램에서 이 어셈블리의 형식을 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

참고 항목

Soapsuds 도구(Soapsuds.exe)

옵션

설명

예제

참고 항목

참조

개념

기타 리소스

추가 리소스