Search code examples
c#xmlserializationcoding-style.net-attributes

Enforce Attribute Decoration of Classes/Methods


Following on from my recent question on Large, Complex Objects as a Web Service Result. I have been thinking about how I can ensure all future child classes are serializable to XML.

Now, obviously I could implement the IXmlSerializable interface and then chuck a reader/writer to it but I would like to avoid that since it then means I need to instantiate a reader/writer whenever I want to do it, and 99.99% of the time I am going to be working with a string so I may just write my own.

However, to serialize to XML, I am simply decorating the class and its members with the Xml??? attributes ( XmlRoot , XmlElement etc.) and then passing it to the XmlSerializer and a StringWriter to get the string. Which is all good. I intend to put the method to return the string into a generic utility method so I don't need to worry about type etc.

The this that concerns me is this: If I do not decorate the class(es) with the required attributes an error is not thrown until run time.

Is there any way to enforce attribute decoration? Can this be done with FxCop? (I have not used FxCop yet)

UPDATE:

Sorry for the delay in getting this close off guys, lots to do!

Definitely like the idea of using reflection to do it in a test case rather than resorting to FxCop (like to keep everything together).. Fredrik Kalseth's answer was fantastic, thanks for including the code as it probably would have taken me a bit of digging to figure out how to do it myself!

+1 to the other guys for similar suggestions :)


Solution

  • I'd write a unit/integration test that verifies that any class matching some given criteria (ie subclassing X) is decorated appropriately. If you set up your build to run with tests, you can have the build fail when this test fails.

    UPDATE: You said, "Looks like I will just have to roll my sleeves up and make sure that the unit tests are collectively maintained" - you don't have to. Just write a general test class that uses reflection to find all classes that needs to be asserted. Something like this:

    [TestClass]
    public class When_type_inherits_MyObject
    {
        private readonly List<Type> _types = new List<Type>();
    
        public When_type_inherits_MyObject()
        {
            // lets find all types that inherit from MyObject, directly or indirectly
            foreach(Type type in typeof(MyObject).Assembly.GetTypes())
            {
                if(type.IsClass && typeof(MyObject).IsAssignableFrom(type))
                {
                    _types.Add(type);
                }
            }
        }
    
        [TestMethod]
        public void Properties_have_XmlElement_attribute
        {
            foreach(Type type in _types)
            {
                foreach(PropertyInfo property in type.GetProperties())
                {
                    object[] attribs = property.GetCustomAttributes(typeof(XmlElementAttribute), false);
                    Assert.IsTrue(attribs.Count > 0, "Missing XmlElementAttribute on property " + property.Name + " in type " + type.FullName);
                }
            }
        }
    }