방법: ASP.NET AJAX 끝점에 대해 HTTP POST 및 HTTP GET 요청 중에서 선택
WCF(Windows Communication Foundation)를 통해 클라이언트 웹 사이트의 JavaScript에서 호출할 수 있는 ASP.NET AJAX 사용 끝점을 노출하는 서비스를 만들 수 있습니다. 이러한 서비스 빌드에 대한 기본 절차에 대해서는 방법: 구성을 사용하여 ASP.NET AJAX 끝점 추가 및 방법: 구성을 사용하지 않고 ASP.NET AJAX 끝점 추가에서 설명합니다.
ASP.NET AJAX는 HTTP POST 및 HTTP GET 동사를 사용하며 기본값이 HTTP POST인 작업을 지원합니다. 파생 작업이 없으며 거의 또는 절대 변경되지 않는 데이터를 반환하는 작업을 만드는 경우 대신 HTTP GET을 사용합니다. GET 작업 결과를 캐시할 수 있습니다. 즉, 동일한 작업에 대해 여러 번 호출하더라도 서비스에 대해 하나의 요청만 수행될 수 있습니다. 캐싱은 WCF에서 수행되지 않지만 모든 수준(사용자 브라우저, 프록시 서버 및 기타 수준)에서 수행될 수 있습니다. 캐싱은 서비스 성능을 향상시키려는 경우 유용하지만 데이터를 자주 변경하거나 작업에서 동작을 수행하는 경우 허용되지 않습니다.
예를 들어, 사용자의 음악 라이브러리를 관리하기 위해 서비스를 디자인하는 경우 앨범 제목에 기초하여 아티스트를 조회하는 작업에서는 GET을 사용함으로써 이점을 얻을 수 있지만, 앨범을 사용자의 개인 컬렉션에 추가하는 작업에서는 POST를 사용해야 합니다.
캐시 수명을 제어하려면 OutgoingWebResponseContext 형식을 사용합니다. 예를 들어, 시간별로 업데이트되는 일기 예보를 반환하는 서비스를 디자인하는 경우 GET을 사용할 수 있지만 캐시 기간을 1시간 이하로 제한하여 서비스 사용자가 오래된 데이터에 액세스하지 않도록 합니다.
Script Manager 컨트롤이 사용하는 ASP.NET AJAX 페이지에서 서비스를 사용하는 경우 작업에서 GET을 사용하든지 POST를 사용하든지 차이가 없습니다. 스크립트 관리자 메커니즘은 올바른 요청 형식이 발급되었는지 확인합니다.
HTTP GET 작업은 복합 데이터 계약 형식을 비롯한 POST 작업에서 지원하는 입력 매개 변수를 사용합니다. 그러나 대부분의 경우 캐싱 효율성이 떨어지기 때문에 너무 많은 매개 변수 또는 GET 작업에 있어서 너무 복잡한 매개 변수는 사용하지 않는 것이 좋습니다.
이 항목에서는 WebGetAttribute 또는 WebInvokeAttribute 특성을 서비스 계약의 관련 작업에 추가하여 GET과 POST 중에 하나를 선택하는 방법을 보여 줍니다. 서비스를 실행하는 데 필요한 기타 단계(서비스 구현, 구성 및 호스팅)는 WCF의 ASP.NET AJAX 서비스에서 사용하는 단계와 비슷합니다.
WebGetAttribute로 표시된 작업은 항상 GET 요청을 사용합니다. WebInvokeAttribute로 표시된 작업 또는 두 개의 특성으로 표시되지 않은 작업은 POST 요청을 사용합니다. WebInvokeAttribute를 사용하면 Method 속성을 통해 GET과 POST 이외의 다른 HTTP 동사(예: PUT, DELETE 등)를 사용할 수 있습니다. 그러나 이러한 동사는 ASP.NET AJAX에서 지원되지 않습니다. Script Manager 컨트롤을 사용하여 ASP.NET 페이지에서 서비스를 사용하려면 Method 속성을 사용하지 마십시오.
GET으로 전환에 대한 작업 예제는 Basic AJAX Service 샘플을 참조하십시오.
POST를 사용하는 샘플에 대해서는 AJAX Service Using HTTP POST 샘플을 참조하십시오.
HTTP GET 또는 HTTP POST 요청에 대해 응답하는 WCF 서비스를 만들려면
ServiceContractAttribute 특성으로 표시된 인터페이스를 사용하여 기본 WCF 서비스 계약을 정의합니다. 각 작업을 OperationContractAttribute로 표시합니다. WebGetAttribute 특성을 추가하여 작업이 HTTP GET 요청에 응답하도록 규정합니다. 또한 WebInvokeAttribute 특성을 추가하여 명시적으로 HTTP POST를 지정할 수 있습니다. 특성을 지정하지 않으면 기본적으로 HTTP POST로 설정됩니다.
[ServiceContract] public interface IMusicService { //This operation uses a GET method. [OperationContract] [WebGet] string LookUpArtist(string album); //This operation will use a POST method. [OperationContract] [WebInvoke] void AddAlbum(string user, string album); //This operation will use POST method by default //since nothing else is explicitly specified. [OperationContract] string[] GetAlbums(string user); //Other operations omitted… }
MusicService
를 사용하여IMusicService
서비스 계약을 구현합니다.public class MusicService : IMusicService { public void AddAlbum(string user, string album) { //Add implementation here. } //Other operations omitted… }
응용 프로그램에서 .svc 확장명이 있는 service라는 새 파일을 만듭니다. 해당 서비스에 적절한 @ServiceHost 지시문 정보를 추가하여 이 파일을 편집합니다. @ServiceHost 지시문에서 WebScriptServiceHostFactory를 사용하여 ASP.NET AJAX 끝점을 자동으로 구성하도록 지정합니다.
<%@ServiceHost language=c# Debug="true" Service="Microsoft.Ajax.Samples.MusicService" Factory=System.ServiceModel.Activation.WebScriptServiceHostFactory %>
서비스를 호출하려면
브라우저를 사용하여 클라이언트 코드 없이 서비스의 GET 작업을 테스트할 수 있습니다. 예를 들어, 서비스가 "http://example.com/service.svc" 주소에 구성된 경우 브라우저 주소 표시줄에 "http://example.com/service.svc/LookUpArtist?album=SomeAlbum"을 입력하면 서비스가 호출되고 응답이 다운로드되거나 표시됩니다.
ASP.NET AJAX Script Manager 컨트롤의 스크립트 컬렉션에 서비스 URL을 입력하여 다른 ASP.NET AJAX 서비스와 동일한 방법으로 GET 작업을 통해 서비스를 사용할 수 있습니다. 예제를 보려면 Basic AJAX Service sample을 참조하십시오.
참고 항목
작업
방법: AJAX 사용 ASP.NET 웹 서비스를 WCF로 마이그레이션