should I ever put a major version number into a C#/Java namespace?
Posted
by Andrew Patterson
on Stack Overflow
See other posts from Stack Overflow
or by Andrew Patterson
Published on 2010-05-10T04:17:44Z
Indexed on
2010/05/10
4:28 UTC
Read the original article
Hit count: 309
I am designing a set of 'service' layer objects (data objects and interface definitions) for a WCF web service (that will be consumed by third party clients i.e. not in-house, so outside my direct control).
I know that I am not going to get the interface definition exactly right - and am wanting to prepare for the time when I know that I will have to introduce a breaking set of new data objects. However, the reality of the world I am in is that I will also need to run my first version simultaneously for quite a while.
The first version of my service will have URL of http://host/app/v1service.svc
and when the times comes by new version will live at http://host/app/v2service.svc
However, when it comes to the data objects and interfaces, I am toying with putting the 'major' version of the interface number into the actual namespace of the classes.
namespace Company.Product.V1
{
[DataContract(Namespace = "company-product-v1")]
public class Widget
{
[DataMember]
string widgetName;
}
public interface IFunction
{
Widget GetWidgetData(int code);
}
}
When the time comes for a fundamental change to the service, I will introduce some classes like
namespace Company.Product.V2
{
[DataContract(Namespace = "company-product-v2")]
public class Widget
{
[DataMember]
int widgetCode;
[DataMember]
int widgetExpiry;
}
public interface IFunction
{
Widget GetWidgetData(int code);
}
}
The advantages as I see it are that I will be able to have a single set of code serving both interface versions, sharing functionality where possible. This is because I will be able to reference both interface versions as a distinct set of C# objects. Similarly, clients may use both interface versions simultaneously, perhaps using V1.Widget in some legacy code whilst new bits move on to V2.Widget.
Can anyone tell why this is a stupid idea? I have a nagging feeling that this is a bit smelly..
notes: I am obviously not proposing every single new version of the service would be in a new namespace. Presumably I will do as many non-breaking interface changes as possible, but I know that I will hit a point where all the data modelling will probably need a significant rewrite.
I understand assembly versioning etc but I think this question is tangential to that type of versioning. But I could be wrong.
© Stack Overflow or respective owner