Consume Json REST service with WCF and dynamic object response

Thu, 23 Mar 2023 15:08:09 Z

This post was imported from FARMCode.org which has been discontinued. These posts now exist here as an archive. They may contain broken links and images.

This was my first shot at WCF and though I saw how nice it could be, i failed miserably… well, I’m actually not too sure. I tried all sorts of things but no matter what couldn’t get WCF to behave and return the actual response you would get if you just consumed the service with the WebClient object. Here’s what I tried and assumed that this ‘should’ work but the result was always an empty dictionary:

Note: this demo is based off of the @Task project management tool’s REST API.

Define the contract:

[ServiceContract]
public interface IAtTaskService
{        
    [OperationContract]
    [WebGet(
        UriTemplate = "/api/login?username={username}&password={password}", 
        RequestFormat = WebMessageFormat.Json)]
    IDictionary<string, object> Login(string username, string password);
}

Run the code:

public IDictionary<string, object> DoThis(string username, string pword)
{
    using (var cf = new WebChannelFactory<IAtTaskService>(
        new Uri("https://mycompaniesurl.attask-ondemand.com/attask/")))
    {
        var s = cf.CreateChannel();
        var token = s.Login(username, pword);
        return token;
    } 
}

The above seemed really nice to be able to consume services but the result was always empty. I tried using strongly typed objects in the result, made sure it wasn’t an HTTPS issue, used the normal WCF configuration approach, etc… but couldn’t get it to work.

The ‘Fix’

I quite like the way that WCF has UriTemplates and you can just attribute up an interface and then make strongly typed calls to access your services so i decided I’d just make that work with my own implementation. Again, perhaps I was ‘doing it wrong’ or whatever, but the below implementation is pretty cool and also lets you get JSON results as a dynamic object :)

Define the contract:

This is pretty much the same as above, but we have a dynamic response

[ServiceContract]
public interface IAtTaskService
{        
    [OperationContract]
    [WebGet(
        UriTemplate = "/api/login?username={username}&password={password}", 
        RequestFormat = WebMessageFormat.Json)]
    dynamic Login(string username, string password);
}

The JsonRestService base class

I created a class that lets you specify you contract service as a generic argument and then provides you with a method called “Send” which is defined a:

protected dynamic Send(Func<T, dynamic> func)

This class will manage all of the http requests and use the WCF attributes applied to your contract to generate the correct URLs and parameters (source code at the bottom of this article)

Define a standard service

So to consume the REST services, we just create a ‘real’ service class such as:

public class AtTaskService : JsonRestService<IAtTaskService>, IAtTaskService
{
    public AtTaskService(string serviceUrl)
        : base(serviceUrl)
    {
    }

    public dynamic Login(string username, string password)
    {
        return Send(x => x.Login(username, password));
    }
}

As you can see, the “Login” method just calls the underlying “Send” method which uses a strongly typed delegate. The Send method then inspects the delegate and generates the correct URL with parameters based on the WCF attributes.

Using the service

So now, to use the new service we can do something like:

[TestMethod]
public void AtAtask_Login()
{

    //Arrange
    var svc = new AtTaskService("https://mycompanyname.attask-ondemand.com/attask/");
            
    //Act
    var token = svc.Login("MyUserName", "mypassword");
            
    //Assert
    Assert.IsTrue(token != null);
    Assert.IsTrue(token.data != null);
    Assert.IsTrue(token.data.userID != null);        
}

Too easy!

As I mentioned earlier, I would have assumed that WCF should handle this out of the box, but for the life of my I couldn’t get it to return any results. Whether it was a request issue or a parsing issue, or whatever i have no idea. In the meantime, here’s the source code for the JsonRestService class which will allow you to do the above. The source requires references to Json.Net and Aaron-powell.dynamics

JsonRestService source

Disclaimer: I made this today in a couple of hours, I’m sure there’s some code in here that could be refactored to be nicer