Are You Really Using Xml Web Services?

I recently realized that it's a stretch to call the web services my company publishes as xml web services. We've always documented them as xml based, but that's a stretch. We use .Net which makes creating a web service almost brainless. We have implemented our web service as such:

[WebMethod]
public string Echo(string message) {
return "<EchoResult>" + message + "</EchoResult>";
}

This is a really simple example, but the web service accepts a string and returns a string. The string in our web services is an xml message which gets dispatched to the appropriate handler later on. So we're handling a variety of different messages and responses through a single interface using an xml string as the parameter.

What you don't realize is that this is so far from what you really want to be doing is isn't even funny. Sending a request to this method must be sent as (simply, using SOAP there would also be a SOAP wrapper):

<?xml version="1.0" encoding="utf-8"?>
<string xmlns="http://foobar">string</string>

The string parameter in this case is wrapped in the string xml element. Because of this requirement the string being passed to the web service must be xml encoded to ensure the entire request is valid xml. So in our case where the string is potentially a very large xml document, the entire message must be xml encoded. The response from the web service is similar:

<?xml version="1.0" encoding="utf-8"?>
<string xmlns="http://foobar">&lt;EchoResult&gt;test&lt;/EchoResult&gt;</string>

In this case the string "test" was passed to the web service. As you can see, the response is xml encoded. This again is to ensure that the xml is valid.

Because .Net makes creating these web services brainless the xml encoding is handled by .Net auto-magically. So if you are taking to the web service with a .Net client and created a web reference, the xml encoding and decoding happens behind the scenes and you won't even know it and it looks like you're passing xml messages back and forth. Now technically you are passing xml messages back and forth, but it's not pretty (IMHO). If you try to use a Java client(pick your language) the request won't work till you xml encode the xml message and you won't get your xml response unless you xml decode the response ... doesn't seem like a friendly xml interface.

A way to get around this implementation is to use XmlNode:

[WebMethod]
public XmlNode Echo(XmlNode message) {
XmlDocument dom = new XmlDocument();
dom.LoadXml("<EchoResult>" + message.InnerXml + "</EchoResult>");

return dom;
}

By specifying the parameter and return type as XmlNode, the web service accepts and returns xml. If you peak at the WSDL you'll see. So with this implementation the request does not need to be xml encoded since the web service accepts xml. The response is also not xml encoded since it returns xml. Although .Net clients will see that the parameter and return types are XmlNode, to other clients it will just look like a string. The response using the XmlNode implementation looks like:

<?xml version="1.0" encoding="utf-8"?>
<EchoResult>test</EchoResult>

This is what you'd(I'd) expect to see when calling a web service that you expect to pass and receive xml messages.

I guess one lesson to learn from this story is that if it looks too good to be true -- it probably is.

Another lesson to learn is to understand the technology you're using. I stumbled across this when I was running WireShark troubleshooting something else.

Hope this proves useful for someone else.

Expect More

I think I'm in the majority when I say that I'm sick and tired of the federal government wasting our (the people) time and money. On Friday I was listening to Michael Medved talk about the House taking up baseball and steroids ... again -- man, what a waste of our time and money! I don't even understand what they must be thinking to think that it's a good idea to bring the case of baseball and steroids before the House. How is that an issue the federal government needs to get involved in? There are so many federal programs and other things like this that are such a huge waste of time.

On Michael's show he had a government employee on the who was talking about working on identifying and getting rid of or cutting back the worthless programs the federal government is involved in. He directed people to ExpectMore.gov to see the programs they have identified. I think I heard him say that they have identified over 1100 programs totaling 2.3 TRILLION dollars that should be reduced or done away with. It's so hard to ever come to grips with that large of a number. I hope this organization is successful in getting rid of some of these worthless programs and wasteful spending.

Did you know Amtrak is a government subsidized program? On ExpectMore.gov it says,

Amtrak was formed in 1970 to be the Nation's sole provider of intercity passenger rail service. It operates in 46 states and owns and manages the Northeast Corridor rail infrastructure. Though it requires Federal subsidies, Amtrak is a for-profit corporation and makes management decisions independently of the government.

Does that sound like a government monopoly to anyone else? Why did the government need to get involved in that anyway? Why can't we just let the free market/capitalism take care of "intercity passenger rail service"?

Anyway, we need to expect more from the government. Not only expect more, but demand more. We need to make our voices heard.