Types Of Web API Action Results

public class UserProfileController : ApiController  
{  
    [HttpGet]  
    [Route("UserProfile/GetUserProfile/{UserId}")]  
    public UserProfile GetUserProfile(int UserId)  
    {  
        return new UserProfileDB().GetUserProfile(UserId);  
    }  
}  

public class UserProfile  
{  
    public int UserId { get; set; }  
    public string UserName { get; set; }  
    public string Location { get; set; }  
    public int PIN { get; set; }  
    public int Age { get; set; }  
    public string Sex { get; set; }  
    public string Occupation { get; set; }  
    public float AnnualIncome { get; set; }  
    public string MaritalStatus { get; set; }  
    public string Nationality { get; set; }  
}  
public class UserProfileDB  
{  
    public UserProfile GetUserProfile(int UserId)  
    {  
 //write the code logic to retrieve user data from database  
        return new UserProfile();  
    }  
} 

[HttpGet]  
public void LogMessageinDB(string Message)  
{  
    new UserProfileDB().LogMessageinDB(Message);  
}

Web API action method can contain any entity type as return type. As mentioned in the first example of What is Web API Action Results, we can use any entity type as the return type. But the problem here is that we get 200 (OK) status code every time on a successful response.

[HttpGet]  
[Route("UserProfile/GetUserProfile/{UserId}")]  
public UserProfile GetUserProfile(int UserId)  
{  
    return new UserProfileDB().GetUserProfile(UserId);  
} 

Following is the result of the above service call in Fiddler.

Result in the Fiddler

When you observe the above picture, the status code is 200 and the result is in JSON format at the bottom.

When we have to use this kind of action result

It is not recommended to use because of two reasons -

1. We cannot explain/convey the client with the various status codes as we get 200 (OK) status code every time.
2. There is no guarantee that the above service will return the required result at every time. There could be an issue with the data or the DB Server or anything can happen. In these situations, the consumer won’t get the data and will get an error in response, i.e., the status code 500 always. Moreover, the client receives complete stack trace error message.
   
   

To overcome these problems, Web API provided Action results, like HttpResponseMessage and IHttpActionResult.

HttpResponseMessage

To customize the action result, we can use HttpResponseMessage as return type (action result) of an action method.

We can customize the response by providing status code, content type, and data to be returned to HttpResponseMessage.

Go through the following example.

[HttpGet]  
[Route("UserProfile/GetUserLoginID/{UserId}")]  
public HttpResponseMessage GetUserLoginId(int UserId)  
{  
    HttpResponseMessage response = Request.CreateResponse(HttpStatusCode.Accepted,"Ravikiran");  
    response.Content.Headers.ContentType = new System.Net.Http.Headers.MediaTypeHeaderValue("text/plain");  
    return response;  
}

When we call the above action method, we get the result as following (shown in the Fiddler).

Result of the above call will be as follows -

We can observe that the default return type is modified to text/plain and the status code is 202 (Accepted).

We can return the complex type data using HttpResponseMessage.

IHttpActionResult

IHttpActionResult has been introduced in Web API 2. This is a little-advanced concept of HttpResponseMessage. IHttpActionResult ultimately returns HttpResponseMessage by providing the customization and reusability features to the developer.

IHttpActionResult contains ExecuteAsync method to create an instance of HttpResponseMessage asynchronously. We have to add some code logic in the implemented class as per our requirement. When user/client calls the action method of IHttpActionResult type, Web API automatically hits the ExecuteAsync method.

Steps to implement IHttpActionResult

Initially, we have to create the return type by inheriting IHttpActionResult. Please see the following code snippet.

public class UserProfileReturnType : IHttpActionResult  
{  
    UserProfile userProfile;  
    HttpRequestMessage httpRequestMessage;  

    HttpResponseMessage httpResponseMessage;  
    public UserProfileReturnType(UserProfile data, HttpRequestMessage request)  
    {  
        userProfile = data;  
        httpRequestMessage = request;  
    }  

    public System.Threading.Tasks.Task<HttpResponseMessage> ExecuteAsync(System.Threading.CancellationToken cancellationToken)  
    {  
        httpResponseMessage =httpRequestMessage.CreateResponse(HttpStatusCode.Found, userProfile);  
        return System.Threading.Tasks.Task.FromResult(httpResponseMessage);  
    }  
} 

In the above code, we have created UserProfileReturnType and given the definition for ExecuteAsync Method by adding some custom logic.

Now, we can use UserProfileReturnType as return type whenever we want to return the UserProfile.

[HttpGet]  
[Route("UserProfile/GetUserProfileIHAR/{UserId}")]  
public IHttpActionResult GetUserProfileIHAR(int UserId)  
{  
    //get the user profileof UserID   
    UserProfile userProfile = new UserProfileDB().GetUserProfile(UserId);  

    //return UserProfileReturnType HttpResponseMessage  
    return new UserProfileReturnType(userProfile, Request);  
} 

I am going to call GetUserProfileIHAR service method by passing UserId using Fiddler.

The result will be as follows.