Click here to Skip to main content
14,368,155 members

Welcome to the Lounge

   

For discussing anything related to a software developer's life but is not for programming questions. Got a programming question?

The Lounge is rated Safe For Work. If you're about to post something inappropriate for a shared office environment, then don't post it. No ads, no abuse, and no programming questions. Trolling, (political, climate, religious or whatever) will result in your account being removed.
 
GeneralRe: Naming stuff... Pin
Member 916705713-Aug-19 0:23
memberMember 916705713-Aug-19 0:23 
GeneralRe: Naming stuff... Pin
Sander Rossel13-Aug-19 1:02
professionalSander Rossel13-Aug-19 1:02 
GeneralRe: Naming stuff... Pin
Member 916705713-Aug-19 1:34
memberMember 916705713-Aug-19 1:34 
GeneralRe: Naming stuff... Pin
Sander Rossel13-Aug-19 11:26
professionalSander Rossel13-Aug-19 11:26 
GeneralRe: Naming stuff... Pin
Member 916705714-Aug-19 4:18
memberMember 916705714-Aug-19 4:18 
GeneralRe: Naming stuff... Pin
Sander Rossel14-Aug-19 4:26
professionalSander Rossel14-Aug-19 4:26 
GeneralRe: Naming stuff... Pin
Member 916705714-Aug-19 4:30
memberMember 916705714-Aug-19 4:30 
GeneralRe: Naming stuff... Pin
Sander Rossel14-Aug-19 5:23
professionalSander Rossel14-Aug-19 5:23 
Yeah, that's basically how it goes.
It's a bit difficult for SOAP, for example, because you can't just add new properties to your API (which is sometimes necessary).
You must make sure they can be omitted, for example by making them nullable.
It's easier for REST, which doesn't check the incoming message and just makes the best out of it (which also has its drawbacks).

I always say, the best versioning is no versioning at all.
Just make sure you don't break the API.

But that assumes your API is perfect from the get-go, which it rarely is.
My last big rework, for example, had an API which got a complete object from the client and then created object x and object y and added some of object z.
Then came some functionality where we just had to add object z and also object y was no longer necessary...
The best solution was really to break that complete API and rework all clients (which, luckily, was only one) Smile | :)

I think the biggest problem, in comparison with (strongly-typed) desktop development, is that your API definition can change without the client side breaking.
You just send message back and forth and try to make something of it at runtime.
That's (sometimes) better with SOAP, but also not always (and I like REST better anyway).
So even if you're very careful, but still make a mistake, you won't find out until you test that particular service call (which isn't a simple unit test) or until it breaks in production Smile | :)
I've had the same problems with some late-bound desktop development, but usually you target a specific version of a DLL, so the API is known at design time and your build simply fails.

GeneralRe: Naming stuff... Pin
stevetabler13-Aug-19 6:51
memberstevetabler13-Aug-19 6:51 
GeneralRe: Naming stuff... Pin
Abbas A. Ali15-Aug-19 21:52
professionalAbbas A. Ali15-Aug-19 21:52 
GeneralRe: Naming stuff... Pin
Sander Rossel16-Aug-19 2:41
professionalSander Rossel16-Aug-19 2:41 
GeneralRe: Naming stuff... Pin
Abbas A. Ali16-Aug-19 3:05
professionalAbbas A. Ali16-Aug-19 3:05 
GeneralRe: Naming stuff... Pin
Sander Rossel16-Aug-19 3:58
professionalSander Rossel16-Aug-19 3:58 
GeneralBlow that dust out!! PinPopular
dandy7212-Aug-19 8:56
memberdandy7212-Aug-19 8:56 
GeneralRe: Blow that dust out!! Pin
Sander Rossel12-Aug-19 9:05
professionalSander Rossel12-Aug-19 9:05 
GeneralRe: Blow that dust out!! Pin
Ravi Bhavnani12-Aug-19 13:40
professionalRavi Bhavnani12-Aug-19 13:40 
GeneralRe: Blow that dust out!! Pin
OriginalGriff12-Aug-19 9:06
protectorOriginalGriff12-Aug-19 9:06 
GeneralRe: Blow that dust out!! Pin
PIEBALDconsult12-Aug-19 9:28
protectorPIEBALDconsult12-Aug-19 9:28 
GeneralRe: Blow that dust out!! Pin
Munchies_Matt12-Aug-19 10:07
memberMunchies_Matt12-Aug-19 10:07 
GeneralRe: Blow that dust out!! Pin
BobbyStrain12-Aug-19 13:15
memberBobbyStrain12-Aug-19 13:15 
GeneralRe: Blow that dust out!! Pin
Mycroft Holmes12-Aug-19 14:41
memberMycroft Holmes12-Aug-19 14:41 
GeneralRe: Blow that dust out!! Pin
Ron Anders12-Aug-19 16:54
memberRon Anders12-Aug-19 16:54 
GeneralRe: Blow that dust out!! Pin
dandy7213-Aug-19 7:53
memberdandy7213-Aug-19 7:53 
GeneralRe: Blow that dust out!! Pin
Overtkill13-Aug-19 7:53
memberOvertkill13-Aug-19 7:53 
GeneralRe: Blow that dust out!! Pin
dandy7213-Aug-19 7:59
memberdandy7213-Aug-19 7:59 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.