ProviderAPI

From APIDesign

Revision as of 20:36, 7 March 2011 by JaroslavTulach (Talk | contribs)
Jump to: navigation, search

Rules for extending API designed for implementors are very different to those for API that can only be called. In case you have a provider implementing your interface, the obvious expectation of that person seems to be that the once the implementation is written, (potentially) compiled once, it will continue to work forever.

The easiest way to break this promise is to add new non-implemented methods into the type. As such do not add new methods to interfaces or abstract classes implemented by some providers. This immediately breaks the promise of source BackwardCompatibility.

TBD: Fragile methods additions

TBD: Interfaces and clear definition of a version

Personal tools
buy