Talk:Blogs:AndreiBadea:EnumsInAPIs

From APIDesign

(Difference between revisions)
Jump to: navigation, search
(Comment provided by lighting manufacturers in the UK - via ArticleComments extension)
(Comment provided by refrigerator repair - via ArticleComments extension)
Line 87: Line 87:
--[http://lighting-wholesales.com lighting manufacturers in the UK] 22:13, 8 September 2011 (CEST)
--[http://lighting-wholesales.com lighting manufacturers in the UK] 22:13, 8 September 2011 (CEST)
 +
</div>
 +
== refrigerator repair said ... ==
 +
 +
<div class='commentBlock'>
 +
Én akartam, hogy tegye valami ilyesmi a honlapomon, és ez adott nekem egy ötletet. Egészségedre.
 +
 +
--[http://ccappliancerepair.com/map/ refrigerator repair] 08:10, 23 September 2011 (CEST)
</div>
</div>

Revision as of 06:10, 23 September 2011

Comments on Blogs:AndreiBadea:EnumsInAPIs <comments />


Contents

Alex said ...

Normally in a release version one wouldn't want any asserts enabled so maybe not a very big problem? The general principle is if you are designing a library you don't make any assumptions on how your client calls your API. Perhaps I'm wrong though...

--Alex 20:21, 16 July 2008 (CEST)

Vincent Cantin said ...

In this example, if the user wanted to ensure that he covers all the fields of the enumeration, then he wrote something wrong, he should not have the "default:" case.

If the switch covers all the fields of the enumeration, the "default:" is not needed and not warnings/errors are generated at compile time.

We can also assume that if the user use the default close here, his meaning is not to cover all the fields of the enumeration, but to only cover a subset and throw an assert exception when encounter a field of the complementary subset or null.


--Vincent Cantin 03:26, 17 July 2008 (CEST)

Andrei Badea said ...

To Alex: I have also seen IllegalStateException's thrown instead of an assert statement. Regarding the assumptions, you are right. But this case looks like one where you could want to break the rule. Not being able to add fields to the enum could be a big limitation.

To Vincent: you are right, many people have a default branch just to be sure, even when they know they have covered all fields of the enum (of the current version of the enum, that is).


--AndreiBadea 15:41, 17 July 2008 (CEST)

Alex said ...

Could want to break a rule? This rule having been expressed in various ways by hthe MONSTERS of computer science would be then too strong for me to want to break it. There must be a subtlety I'm missing when following your example. I shall work on that further. That is after I've studied the design patterns. Otherwise no chance for me to pass the exams. Thanks!!

--Alex 23:28, 17 July 2008 (CEST)

Joel Neely said ...

Doesn't this depend on how the enum is used?

If a value of the enumerated type is in the result of an API method, and the switch statement above is in the client, and the new value can be returned in a result produced by previous-version client behavior, then adding a value to the enum can cause breakage.

But if the only uses of the enumerated type are in arguments to API methods, or the new value can only appear in a result for a request that used other new–version aspects, then this specific opportunity for error doesn't arise.

It is still possible for new semantic requirements (e.g. a rule that the new enum value is required in certain cases) to break the client.

I suggest that the real issue is this: if the new API still accepts all prior-version arguments and (for those arguments) returns the same results, then there's no breakage. Breakage occurs when a new version fails to accept previously-valid arguments, or returns results that previously could not occur.

--Joel Neely 13:37, 25 August 2008 (CEST)

Burton Samograd said ...

If you compile your release with _NDEBUG the switch will fall through just fine since the assert macros are removed from the release code. This should be decent behaviour even with new binary versions of the code if the new enums are always added at the end.

Developers running debug code *might* catch the new enum value if it is set by the library, and the failed assertion will alert them to the new value that is available.

Basically it comes down to programming practices and disciplines for it to work, which are sometimes difficult to maintain in multi-user distributed development.

--Burton Samograd 07:18, 12 September 2008 (CEST)

Daniel Thoma said ...

There are cases, where enums represent a finit set of possibilities (typically abstract things, operations in some calculus, base-dimensions of an color space etc.). Extending such an enum doesn't make sense, since there is a theory that determines all possible values. More often are cases, where an enum represents a subset of a possibly infinite set of values. (error-codes, currencies, countries, ...) It would be a nice idea to distinguish these types of enums at language level or by an annotation. A compiler then could at least recognise certain scenarios of missusage and the developer would know, whether he has to care about unknown values.

--Daniel Thoma 18:09, 16 September 2008 (CEST)

lighting manufacturers in the UK said ...

Congratulations on possessing definitely one in every of one of the crucial sophisticated blogs Ive arrive throughout in some time! Its simply amazing how much you’ll be capable to take into account away from a thing mainly simply due to how visually stunning it is. Youve place collectively a fantastic weblog website area –great graphics, motion pictures, layout. This is actually a should-see website!

--lighting manufacturers in the UK 04:34, 2 September 2011 (CEST)

lighting manufacturers in the UK said ...

hey all, I was simply checkin’ out this weblog and I really admire the premise of the article, and don't have anything to do, so if anybody wish to to have an engrossing convo about it, please contact me on AIM, my name is heather smith

--lighting manufacturers in the UK 22:13, 8 September 2011 (CEST)

refrigerator repair said ...

Én akartam, hogy tegye valami ilyesmi a honlapomon, és ez adott nekem egy ötletet. Egészségedre.

--refrigerator repair 08:10, 23 September 2011 (CEST)

Personal tools
buy