Introduction
Dear readers,
03 01 6A 00 00 01 41 42 03 57 42 58 4D 4C 20 50 72 6F 67 72 61 6D 6D
65 72 00 01 43 03 48 65 6C 6C 6F 2C 20 57 6F 72 6C 64 21 00 01 01
Do you know what I'm talking about? The above 45 bytes string means the following 208 bytes XML:
<hello-world>
<greeter>WBXML Programmer</greeter>
<greeting>Hello, World!</greeting>
</hello-world>
Background
Basically, XML is a very easy language. It's easy to understand, parse and use. However, XML is very inefficient for transport. In order to send this small XML file, you have to transfer more than 200 bytes, when actually meaningful information is two strings. This is not critical issue when we are working in LAN environment. However it becomes very critical while working with mobile customers. That's the reason for inventing WAP Binary XML (or WBXML).
This language uses name tables (tokens) to convert nodes and attributes into one byte value and this way it saves a lot of unnecessary information being transferred. WBXML specification is very easy, however .NET (even Compact) framework's lack of XmlDocument supports this content format.
Is it common enough to lean and use? Well, this is tricky question. From one hand, all of mobile content providers (even those, who deal with mobile synchronization) widely use this format. On the other hand, if you are not really "in" mobile (or any other bandwidth efficient) programming, you do not need it.
I think that one of the most important things in programming (in general) is to be efficient, so I decided to write an XmlDocument derived class to provide WBXML support.
Using the Code
First create name tables (you do not have to if you are using only one token):
Dictionary<int, Dictionary<byte, string>> tokens =
new Dictionary<int, Dictionary<byte, string>>();
Dictionary<byte, string> token = new Dictionary<byte, string>();
token.Add(1, "hello-world");
token.Add(2, "greeter");
token.Add(3, "greeting");
tokens.Add(1, token);
Then create a new WBXmlDocument instance with those tables:
System.Xml.WBXmlDocument doc = new System.Xml.WBXmlDocument(tokens);
Now you can either use it as a normal XmlDocument...
doc.LoadXml("<hello-world><greeter>WBXML Programmer</greeter>
<greeting>Hello, World!</greeting></hello-world>");
... and then create its binary representation:
byte[] bytes = doc.GetBytes();
Or load the incoming byte array...
doc.Load(bytes);
... and get your XmlDocument:
string xml = doc.DocumentElement.OuterXml;
That's all. Pretty easy, isn't it?
Points of Interest
The other implementation of WBXML in VB.NET can be found here on The Code Project.
Notice
- This is not the final version.
- It does not test enough.
- There are known issues with attributes parsing.
- It does not implement full specification (I did it for my own needs).
- Each company might have its own protocol that can be slight different from official specification (SyncML for example).
- You can know token tables only if you get full specification of target protocol. Private tokens are not transferred according to the protocol.
More information about this code licensing and terms of use can be found in my blog.
History
