[asp.net-web-api] FromBody와 FromUri를 지정해야하는 이유는 무엇입니까?

기본 동작은 다음과 같습니다.

1. 매개 변수가있는 경우 기본 유형 ( int, bool, double, …), 웹 API의 시도는의 값 얻을 URI 는 HTTP 요청을.

2. 들어 복잡한 유형 (예를 들어 자신의 개체, : Person), 웹 API의 시도는의 값 읽어 몸 HTTP 요청의를.

따라서 다음이있는 경우 :

• URI의 기본 유형 또는
• 신체의 복잡한 유형

… 당신은 어떤 속성 (도 추가 할 필요가 없습니다 [FromBody]아니다 [FromUri]).

당신이있는 경우에, 원시 형 의 몸을 , 당신은 추가 할 필요가 [FromBody]당신의 WebAPI 컨트롤러 방법에 원시 형식 매개 변수 앞에. (기본적으로 WebAPI는 HTTP 요청의 URI에서 기본 유형을 찾고 있기 때문입니다.)

또는 URI에 복잡한 유형 이 있으면을 추가해야합니다 . (기본적으로 WebAPI는 기본적으로 HTTP 요청 본문에서 복잡한 유형을 찾습니다.)[FromUri]

기본 유형 :

public class UsersController : ApiController
{
    // api/users
    public HttpResponseMessage Post([FromBody]int id)
    {

    }
    // api/users/id
    public HttpResponseMessage Post(int id)
    {

    }
}

복잡한 유형 :

public class UsersController : ApiController
{
    // api/users
    public HttpResponseMessage Post(User user)
    {

    }

    // api/users/user
    public HttpResponseMessage Post([FromUri]User user)
    {

    }
}

HTTP 요청에 하나의 매개 변수 만 보내면 작동합니다 . 여러 개를 보낼 때 다음과 같은 모든 매개 변수가있는 사용자 지정 모델 을 만들어야합니다.

public class MyModel
{
    public string MyProperty { get; set; }
    public string MyProperty2 { get; set; }
}

[Route("search")]
[HttpPost]
public async Task<dynamic> Search([FromBody] MyModel model)
{
    // model.MyProperty;
    // model.MyProperty2;
}

ASP.NET 웹 API의 매개 변수 바인딩에 대한 Microsoft 문서 에서 :

매개 변수에 [FromBody]가 있으면 Web API는 Content-Type 헤더를 사용하여 포맷터를 선택합니다. 이 예제에서 컨텐츠 유형은 “application / json”이고 요청 본문은 원시 JSON 문자열 (JSON 오브젝트가 아님)입니다. 메시지 본문에서 최대 하나의 매개 변수를 읽을 수 있습니다.

이것은 작동해야합니다 :

public HttpResponseMessage Post([FromBody] string name) { ... }

작동하지 않습니다.

// Caution: This won't work!    
public HttpResponseMessage Post([FromBody] int id, [FromBody] string name) { ... }

이 규칙의 이유는 요청 본문이 한 번만 읽을 수있는 버퍼되지 않은 스트림에 저장 될 수 있기 때문입니다.

답변

public class GeoPoint
{
    public double Latitude { get; set; }
    public double Longitude { get; set; }
}

[RoutePrefix("api/Values")]
public ValuesController : ApiController
{
    [Route("{Latitude}/{Longitude}")]
    public HttpResponseMessage Get([FromUri] GeoPoint location) { ... }
}

http://localhost/api/values/47.678558/-122.130989

 // Caution: Will not work!
public HttpResponseMessage Post([FromBody] int id, [FromBody] string name) { ... }