What is the purpose of a marker interface?

by

This is a bit of a tangent based on the response by “Mitch Wheat”.

Generally, anytime I see people cite the framework design guidelines, I always like to mention that:

You should generally ignore the framework design guidelines most of the time.

This isn’t because of any issue with the framework design guidelines. I think the .NET framework is a fantastic class library. A lot of that fantasticness flows from the framework design guidelines.

However, the design guidelines do not apply to most code written by most programmers. Their purpose is to enable the creation of a large framework that is used by millions of developers, not to make library writing more efficient.

A lot of the suggestions in it can guide you to do things that:

  1. May not be the most straightforward way of implementing something
  2. May result in extra code duplication
  3. May have extra runtime overhead

The .net framework is big, really big. It’s so big that it would be absolutely unreasonable to assume that anyone has detailed knowledge about every aspect of it. In fact, it’s much safer to assume that most programmers frequently encounter portions of the framework they have never used before.

In that case, the primary goals of an API designer are to:

  1. Keep things consistent with the rest of the framework
  2. Eliminate unneeded complexity in the API surface area

The framework design guidelines push developers to create code that accomplishes those goals.

That means doing things like avoiding layers of inheritance, even if it means duplicating code, or pushing all exception throwing code out to “entry points” rather than using shared helpers (so that stack traces make more sense in the debugger), and a lot of other similar things.

The primary reason that those guidelines suggest using attributes instead of marker interfaces is because removing the marker interfaces makes the inheritance structure of the class library much more approachable. A class diagram with 30 types and 6 layers of inheritance hierarchy is very daunting compared to one with 15 types and 2 layers of hierarchy.

If there really are millions of developers using your APIs, or your code base is really big (say over 100K LOC) then following those guidelines can help a lot.

If 5 million developers spend 15 mins learning an API rather than spending 60 mins learning it, the result is a net savings of 428 man years. That’s a lot of time.

Most projects, however, don’t involve millions of developers, or 100K+ LOC. In a typical project, with say 4 developers and around 50K loc, the set of assumptions are a lot different. The developers on the team will have a much better understanding of how the code works. That means that it makes a lot more sense to optimize for producing high quality code quickly, and for reducing the amount of bugs and the effort needed to make changes.

Spending 1 week developing code that is consistent with the .net framework, vs 8 hours writing code that is easy to change and has fewer bugs can result in:

  1. Late projects
  2. Lower bonuses
  3. Increased bug counts
  4. More time spent at the office, and less time on the beach drinking margaritas.

Without 4,999,999 other developers to absorb the costs it usually isn’t worth it.

For example, testing for marker interfaces comes down to a single “is” expression, and results in less code that looking for attributes.

So my advice is:

  1. Follow the framework guidelines religiously if you are developing class libraries (or UI widgets) meant for wide spread consumption.
  2. Consider adopting some of them if you have over 100K LOC in your project
  3. Otherwise ignore them completely.

More Related Contents:

  1. C# parameters in interface [closed]
  2. C# Interfaces. Implicit implementation versus Explicit implementation
  3. Multiple Inheritance in C#
  4. Cast List to List
  5. What is the difference between an interface and a class, and why I should use an interface when I can implement the methods directly in the class?
  6. Interfaces — What’s the point?
  7. Interface defining a constructor signature?
  8. How would you code an efficient Circular Buffer in Java or C#?
  9. How to Implement IComparable interface?
  10. How do I alias a class name in C#, without having to add a line of code to every file that uses the class?
  11. implicit vs explicit interface implementation [duplicate]
  12. How to determine if a type implements an interface with C# reflection
  13. Interface or abstract class?
  14. Why can’t C# interfaces contain fields?
  15. Structs, Interfaces and Boxing [duplicate]
  16. Why Explicit Implementation of a Interface can not be public?
  17. Interfaces vs. abstract classes [duplicate]
  18. Why can’t I have protected interface members?
  19. Test if object implements interface
  20. When should I choose inheritance over an interface when designing C# class libraries? [closed]
  21. Why is 16 byte the recommended size for struct in C#?
  22. Is it safe for structs to implement interfaces?
  23. Creating a Math library using Generics in C#
  24. Is there a way to force a C# class to implement certain static functions?
  25. Non Public Members for C# Interfaces [closed]
  26. C#: Abstract classes need to implement interfaces?
  27. Why must an C# interface method implemented in a class be public?
  28. How can I write a generic container class that implements a given interface in C#?
  29. How to call an explicitly implemented interface-method on the base class
  30. What exactly is “interface based programming”?

Leave a Comment