Soapsuds 도구(Soapsuds.exe)
Soapsuds 도구를 사용하면 Remoting이라는 기법을 사용하여 XML Web services 와 통신하는 클라이언트 응용 프로그램을 컴파일 할 수 있습니다. Soapsuds.exe는 다음과 같은 기능을 수행합니다.
공용 언어 런타임 어셈블리에 노출된 서비스를 기술하는 XML 스키마를 만듭니다.
XML 스키마에서 기술한 서비스에 액세스하기 위해 런타임 어셈블리를 만듭니다. 스키마 정의는 로컬 파일이 될 수 있으며 인터넷에서 동적으로 다운로드할 수도 있습니다.
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 Service 설명을 참조하십시오. |
설명
클라이언트 응용 프로그램에서 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
참고 항목
참조
.NET Framework 도구
강력한 이름 도구(Sn.exe)
웹 서비스 설명 언어 도구(Wsdl.exe)
웹 서비스 검색 도구(Disco.exe)
SDK 명령 프롬프트