HTTP 어댑터(BizTalk Server 샘플)
HTTP 어댑터 샘플은 BizTalk Server 사용되는 요청/응답 및 요청/응답 통신 패러다임을 구현하는 방법을 보여 줍니다.
이 샘플이 있는 위치
<샘플 경로>\AdaptersDevelopment\HttpAdapter\
다음 표는 이 샘플의 파일을 보여 주고 각각의 용도에 대해 설명합니다.
| 파일 | Description |
|---|---|
| \Design-Time\Adapter Management | 이 어댑터의 디자인 타임 부분을 구현하는 프로젝트를 포함합니다. |
| \Run-Time\HttpReceive | 요청/응답 어댑터 통신 패턴을 구현하는 프로젝트를 포함합니다. 격리된 수신기입니다. |
| \Run-Time\HttpSend | 간청/응답 어댑터 통신 패턴을 구현하는 프로젝트를 포함합니다. |
이 샘플의 사용 방법
이 샘플은 사용자 지정 어댑터를 개발하는 데 사용할 프레임워크를 의미합니다. 경우에 따라 BizTalk Server가 메시지를 특정 사용자 지정 응용 프로그램으로 전송하거나 네이티브 어댑터가 없는 프로토콜을 사용해야 할 수 있습니다. 타사에서도 추가 프로토콜을 지원하는 어댑터를 작성하고 있으므로 사용자 지정 어댑터를 작성하기 전에 해당 프로토콜용 어댑터가 있는지 확인할 수 있습니다. 해당 통신 요구 사항을 지원하는 어댑터를 찾을 수 없는 경우 사용자 지정 어댑터를 개발할 수 있습니다.
사용자 지정 어댑터를 작성하는 것은 어려운 작업일 수 있습니다. 이 프로세스를 단순화하기 위해 Microsoft는 어댑터 프레임워크라는 기반을 개발했습니다. BizTalk Server SDK의 샘플 어댑터 소스 코드와 함께 개발의 기반으로 이 프레임워크를 사용할 수 있습니다. 사용자 지정 어댑터 및 어댑터 프레임워크에 대한 자세한 내용은 이 문서의 끝에 있는 참고 항목 섹션을 참조하세요.
샘플 어댑터 빌드 및 초기화
중요
설치된 BizTalk이 64비트 버전이거나 설치 위치를 수정한 경우 그에 따라 OutboundAssemblyPath, InboundAssemblyPath 및 AdapterMgmtAssemblyPath를 변경해야 합니다.
HTTP Adapter 샘플을 빌드 및 초기화하려면
명령 창에서 다음 폴더로 이동합니다.
<샘플 경로>\AdaptersDevelopment\HttpAdapter
다음 작업을 수행하는 Setup.bat 파일을 실행합니다.
HTTPAdapter와 모든 해당 종속성을 컴파일합니다.
어댑터의 수신기 측에서 사용하는 IIS(인터넷 정보 서비스) 응용 프로그램을 만듭니다.
IIS 7.0에서는 이 IIS 응용 프로그램을 실행하는 응용 프로그램 풀의 ID가 다음 그룹의 구성원인지 확인해야 합니다.
BizTalk Isolated 호스트 사용자 그룹
IIS_WPG 그룹
IIS 7.0에서는 통합 .NET 모드에서 작업할 수 있도록 응용 프로그램을 마이그레이션해야 합니다. 명령줄 창에서 다음을 사용하여 httpHandlers> 구성 섹션의 <내용을 포함하여 애플리케이션 구성을 마이그레이션할 수 있습니다(창은 관리자 권한으로 실행되어야 합니다).
%systemroot%\system32\inetsrv\APPCMD.EXE migrate config "Default Web Site/HttpReceive"마이그레이션한 응용 프로그램은 클래식 모드와 통합 .NET 모드에서 모두 실행되며 하위 플랫폼에서도 실행됩니다.
참고
이 샘플을 실행하기 전에 빌드 및 초기화 프로세스 동안 보고된 오류가 없는지 확인해야 합니다.
참고
Setup.bat 파일을 실행하지 않은 채 이 샘플에서 프로젝트를 열고 빌드하려는 경우 먼저 .NET Framework Strong Name 유틸리티(sn.exe)를 사용하여 강력한 이름 키 쌍을 만들어야 합니다. 이 키 쌍을 사용하여 결과 어셈블리를 등록합니다.
참고
Setup.bat가 변경한 내용을 실행 취소하려면 Cleanup.bat를 실행합니다. Setup.bat를 두 번째로 실행하기 전에 Cleanup.bat를 실행해야 합니다.
샘플 어댑터 등록
HTTP Adapter 샘플을 등록하려면
Windows Explorer BizTalk Server 설치 드라이브로 이동한 다음 샘플 경로>\어댑터개발\HTTPAdapter로 이동합니다<.
샘플 어댑터를 레지스트리에 추가하려면 HTTP를 두 번 클릭합니다 . NET.reg.
참고
HTTP. NET.reg에는 BizTalk Server 설치 디렉터리에 대한 하드 코딩된 경로가 포함되어 있습니다. 기본 위치에 BizTalk Server 설치하지 않았거나 이전 버전의 BizTalk Server BizTalk Server 설치를 업그레이드한 경우 HTTP 파일을 수정해야 합니다. 적절한 경로가 있는 NET.reg입니다. "OutboundAssemblyPath" 및 "AdapterMgmtAssemblyPath" 값과 연결된 경로를 업데이트하여 지정된 파일의 올바른 위치를 가리킵니다.
중요
64비트 컴퓨터에 BizTalk를 설치하는 경우 HKEY_CLASSES_ROOT\CLSID\ 레지스트리 항목의 모든 인스턴스를 HTTP의 HKEY_CLASSES_ROOT\Wow6432Node\CLSID\ 변경합니다 . NET.reg 레지스트리 파일.
레지스트리 편집기 대화 상자에서 예를 클릭하여 샘플 어댑터를 레지스트리에 추가한 다음 확인을 클릭합니다.
Windows Explorer 닫려면 파일 메뉴에서 닫기를 클릭합니다.
샘플 어댑터 설치
HTTP Adapter 샘플을 설치하려면
시작 메뉴를 클릭하고 모든 프로그램을 선택하고 Microsoft BizTalk Server 20xx를 선택한 다음 BizTalk Server 관리를 선택합니다.
BizTalk Server 관리 콘솔에서 BizTalk Server 관리 트리를 확장한 다음 BizTalk 그룹 트리를 확장한 다음 플랫폼 설정 트리를 확장합니다.
어댑터를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 클릭한 다음 어댑터를 클릭합니다.
어댑터 속성 대화 상자에서 다음을 수행합니다.
사용 항목 원하는 작업 Name HTTP.NET 입력합니다. 어댑터 드롭다운 목록에서 HTTP.NET 선택합니다. Description 샘플 HTTP.NET 어댑터를 입력합니다. 확인을 클릭합니다.
이제 BizTalk 관리 콘솔의 오른쪽 창에 있는 어댑터 목록에 해당 어댑터가 표시됩니다.
호스트 인스턴스 중지 및 다시 시작
HTTP Adapter 샘플의 호스트 인스턴스를 중지하고 다시 시작하려면
시작 메뉴를 클릭하고 모든 프로그램을 선택하고 Microsoft BizTalk Server 20xx를 선택한 다음 BizTalk Server 관리를 선택합니다.
BizTalk Server 관리 콘솔에서 BizTalk Server 관리 트리를 확장한 다음 플랫폼 설정을 확장하고 호스트 인스턴스를 클릭합니다.
결과 창에서 호스트 instance(일반적으로 컴퓨터 이름)를 마우스 오른쪽 단추로 클릭한 다음 중지를 클릭합니다.
호스트 instance 상태 중지됨으로 변경됩니다.
결과 창에서 호스트 instance 마우스 오른쪽 단추로 클릭한 다음 시작을 클릭합니다.
이제 HTTP.NET 어댑터를 응용 프로그램에서 사용할 준비가 되었습니다. 어댑터를 구성할 때 Virtual Directory 전송 속성의 형식은 /httpreceive/httpreceive.aspx?optionalQueryString 형식입니다.
의견
HTTP.NET 어댑터는 Samples Path>\AdaptersDevelopment\BaseAdapter\v1.0에 제공된< BaseAdapter 클래스를 사용합니다. 2\. BaseAdapter 프로젝트에서 제공되는 클래스는 어댑터를 신속하게 개발하기 위한 것입니다. 제공되는 클래스에 대한 자세한 내용은 BaseAdapter 코드 설명을 참조하십시오.
참고 항목
어댑터 등록
어댑터 샘플 - 사용
사용자 지정 어댑터 개발
어댑터 프레임워크란?
어댑터 프레임워크 도구 사용
수신 어댑터 개발
송신 어댑터 개발
사용자 지정 어댑터를 배포하는 방법
어댑터 디자인 팁
어댑터 디자인 타임 구성