Automatic Format Selection

이 샘플에서는 WCF(Windows Communication Foundation) REST 프로그래밍 모델을 사용하여 선택 영역 자동 서식 지정(XML 또는 JSON)을 사용하도록 설정하는 방법과 작업 코드에서 형식을 명시적으로 설정하는 방법을 보여 줍니다.

샘플 세부 정보

이 샘플은 서비스와 서비스로 요청을 보내는 클라이언트 코드로 구성되어 있습니다. 서비스에서는 단일 HTTP GET 작업(EchoWithGet) 및 단일 HTTP POST 작업(EchoWithPost)을 지원합니다. 두 작업은 모두 문자열을 필요로 하며 응답에서도 문자열을 반환합니다. GET 작업을 사용할 경우 문자열은 URI 쿼리 문자열 매개 변수에서 제공됩니다. POST 작업을 사용할 경우 문자열은 요청의 본문에서 XML로 serialize되어 제공됩니다. 서비스에서는 .NET Framework 버전 4의 새로운 기능인 선택 영역 자동 서식 지정 및 선택 영역 명령적 서식 지정 기능을 사용하여 응답을 XML이나 JSON으로 반환할 수 있습니다.

이 샘플에서는 App.config 파일을 사용하여 선택 영역 자동 서식 지정 기능을 사용하도록 설정합니다. 기본 웹 HTTP 끝점에서 automaticFormatSelectionEnabled 특성에는 true 값이 지정됩니다. 선택 영역 자동 서식 지정 기능을 사용할 수 있는 경우 WCF 인프라에서는 요청의 HTTP Accept 또는 Content-Type 헤더를 확인하여 가장 적절한 응답 형식(XML 또는 JSON)을 선택합니다. 개발자는 automaticFormatSelectionEnabled 특성을 true로 설정하여 이 새 기능을 사용할 수 있으며 그 외에는 추가 코드나 구성을 제공할 필요가 없습니다. Program.cs의 클라이언트 코드에서 요청은 HTTP Accept 헤더가 “application/xml” 또는 “application/json”으로 지정된 서비스의 GET 및 POST 작업 모두로 보내지며, 서비스에서는 해당하는 각 형식으로 응답을 반환합니다.

또한 GET 작업에서는 선택 영역 명령적 서식 지정 기능이 사용됩니다. GET 작업에서는 선택적 format 쿼리 문자열 매개 변수를 검사하고, 이 매개 변수가 있으면 OutgoingResponse 속성에서 응답 형식을 설정합니다. 이와 같이 응답 형식을 명령적으로 설정하면 WCF 인프라에서 수행한 선택 영역 자동 서식 지정이 재정의됩니다.

이 샘플은 자체 호스팅 서비스와 콘솔 응용 프로그램 내에서 실행되는 클라이언트로 구성되어 있습니다. 콘솔 응용 프로그램이 실행되면 클라이언트에서는 서비스로 요청을 보내고 응답의 관련 정보를 콘솔 창에 씁니다.

이 샘플을 사용하려면

1. Automatic Format Selection 샘플의 솔루션을 엽니다. 관리자 권한으로 Visual Studio 2010을 시작해야 샘플이 제대로 실행됩니다. 이렇게 하려면 Visual Studio 2010 아이콘을 마우스 오른쪽 단추로 클릭하고 상황에 맞는 메뉴에서 관리자 권한으로 실행을 선택합니다.

2. F6 키를 눌러 솔루션을 빌드한 다음 Ctrl+F5를 눌러 콘솔 응용 프로그램 AutomaticFormatSelection 프로젝트를 실행합니다. 콘솔 창이 나타나고 실행 중인 서비스의 URI와 실행 중인 서비스에 대한 HTML 도움말 페이지의 URI가 제공됩니다.

3. 샘플이 실행되면 클라이언트에서는 서비스로 요청을 보내고 콘솔 창에 응답을 씁니다. 응답 형식은 XML과 JSON의 두 가지로 나타납니다.

4. 아무 키나 눌러 샘플을 종료합니다.

참고:
컴퓨터에 이 샘플이 이미 설치되어 있을 수도 있습니다. 계속하기 전에 다음(기본) 디렉터리를 확인하십시오. <InstallDrive>:\WF_WCF_Samples 이 디렉터리가 없으면 Windows Communication Foundation (WCF) and Windows Workflow Foundation (WF) Samples for .NET Framework 4로 이동하여 WCF(Windows Communication Foundation) 및 WF 샘플을 모두 다운로드하십시오. 이 샘플은 다음 디렉터리에 있습니다. <InstallDrive>:\WF_WCF_Samples\WCF\Basic\Web\AutomaticFormatSelection