Why doesn't WCF/JSON return `null` for a null return value?

Question

According to the JSON spec, the correct way to represent a null value is the literal null.

If that is the case, why does WCF return an empty response instead of null? Is this a bug or is this behaviour documented somewhere?

Complete repro example:

using System;
using System.ServiceModel;
using System.ServiceModel.Web;

[ServiceContract()]
public class Service1
{
    [OperationContract(), WebGet(ResponseFormat = WebMessageFormat.Json)]
    public string GetSomeString() { return "SomeString"; }

    [OperationContract(), WebGet(ResponseFormat = WebMessageFormat.Json)]
    public string GetNull() { return null; }
}

public class Host
{
    public static void Main()
    {
        // Very simple WCF server
        var host = new WebServiceHost(typeof(Service1), new Uri("http://localhost:8000/"));
        host.AddServiceEndpoint(typeof(Service1), new WebHttpBinding() {
            HostNameComparisonMode = HostNameComparisonMode.Exact
        }, "");

        host.Open();
        Console.WriteLine("Service is running, press enter to quit...");
        Console.ReadLine();
        host.Close();
    }
}

Expected result:

$ curl http://localhost:8000/GetSomeString && echo
"SomeString"
$ curl http://localhost:8000/GetNull && echo
null
$

Actual result:

$ curl http://localhost:8000/GetSomeString && echo
"SomeString"
$ curl http://localhost:8000/GetNull && echo

$

Because a null value can be represented in many different ways. See this post for more: stackoverflow.com/questions/21120999/representing-null-in-json — tom redfern
– tom redfern, Commented Oct 3, 2016 at 14:35
@TomRedfern: The accepted answer of that post also claims that null is the way null should be represented according to the JSON spec. My question is why WCF deviates from the spec. — Heinzi
– Heinzi, Commented Oct 7, 2016 at 14:08
In the light of the recent answer, I wonder if your service actually responds with Content-Type: application/json? — GSerg
– GSerg, Commented Oct 8, 2016 at 14:04
@GSerg: Good question, I just checked: It responds with Content-Type: application/json; charset=utf-8 for GetSomeString and no Content-Type header for GetNull. As I commented below the answer, I believe that the quote from the JSON home page only summarizes the data structures which are available in addition to the primitive values rather than restricting the JSON "base element" to one of the two. — Heinzi
– Heinzi, Commented Oct 8, 2016 at 18:11
Related discussion: stackoverflow.com/q/18419428/11683. I believe it is particularly relevant, in addition to the accepted answer, that the primitives listed in the question used to fail validation and now they pass, and WCF is from the era where they failed. — GSerg
– GSerg, Commented Oct 8, 2016 at 18:57

Dijkgraaf · Accepted Answer · 2016-10-09 21:05:24Z

6

+50

Your link to json specification includes these interesting lines:

JSON is built on two structures:

A collection of name/value pairs. In various languages, this is realized as an object, record, struct, dictionary, hash table, keyed list, or associative array.

An ordered list of values. In most languages, this is realized as an array, vector, list, or sequence.

So, in my understanding, your return types aren't conforming to the specification.

Neither public string GetNull() { return null; }
nor public string GetSomeString() { return "SomeString"; }

To fullfill the specifications you would have to change them to match either #1 or #2.

A struct is used. public struct structWithNull{public object resp;} The default value is null, so public structWithNull GetNull() {return new structWithNull() ; } returns:
An array of size one is used. public object[] GetNullArray() {return new object[1] ; }. The default value is again null; it returns:

It seems to me that JSON is based of encapsulating data, like XML, where a parent node is always needed. So I guess that there is no other solution to this as to use a struct/class(#1) or an array(#2).

Update:

I found a clue here: rfc7159

Note that certain previous specifications of JSON constrained a JSON text to be an object or an array. Implementations that generate only objects or arrays where a JSON text is called for will be interoperable in the sense that all implementations will accept these as conforming JSON texts.

If I understand this correctly, your are right and null should be returned today as it is a primitive, but won't because the main focus might be on the old specified behavior of the only object and array based versions.

Finally I believe only Microsoft can answer this question completely.

edited Oct 9, 2016 at 21:05

Dijkgraaf

11.5k18 gold badges46 silver badges59 bronze badges

answered Oct 8, 2016 at 13:37

Florian p.i.

6223 silver badges7 bronze badges

Sign up to request clarification or add additional context in comments.

1 Comment

Heinzi Over a year ago

This is an interesting point, but I believe that your quote from the JSON homepage does not imply that a valid JSON text must have an object or array as the base element. If we look at the ECMA-404 PDF linked from the page, we see that any JSON value is a valid JSON text. To quote (emphasis mine): A JSON text is a sequence of tokens formed from Unicode code points that conforms to the JSON value grammar. [...] A JSON value can be an object, array, number, string, true, false, or null. Thus, null, "" and "abc" would be valid JSON texts, but `` (empty) would not.

Bucketcode · Accepted Answer · 2016-10-09 10:22:33Z

0

In my opinion WCF or other ways are data transfer contract, and all data base on string. Difference just how you contract the string form.
This method just return a string, no matter how's the format only the client can get the data, so it doesn't need to be json format.
If just return string "null" represent null what if i want to return string "null" instead of null. It'll be confused. Of course you can use ESC characters solve it. Maybe they think nothing is better.
If client use json format data, you just return a string "null", then client deserialize it get a null, everything is ok. Anyway it's doesn't matter what return, but how to contract data format.

answered Oct 9, 2016 at 10:22

Bucketcode

4812 silver badges13 bronze badges

1 Comment

Florian p.i. Over a year ago

Yes, its only important that sender and receiver know what is meant by a message.

Hamza Ahmed · Accepted Answer · 2016-10-10 10:10:45Z

-1

If you want actual null values to be returned in your wcf response in json format you should define a datacontract and return it without initializing it

[DataContract] 
public class Employee 
{ 
[DataMember]
public string id { get; set; }
}

Now in your operation contract return it like this

[OperationContract(), WebGet(ResponseFormat = WebMessageFormat.Json)]
public string GetNull() { return new Employee(); }

Then you will null values in your json response.

Hope it helps

answered Oct 10, 2016 at 10:10

Hamza Ahmed

1,8414 gold badges20 silver badges37 bronze badges

Collectives™ on Stack Overflow

Why doesn't WCF/JSON return `null` for a null return value?

3 Answers 3

1 Comment

1 Comment

Comments

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

3 Answers 3

1 Comment

1 Comment

Comments

Your Answer

Sign up or log in

Post as a guest

Linked

Related