Code Smells Catalog
Code Smells Catalog

Code Smells Catalog

Code Smells Catalog
Code Smells Catalog
The items don't seem concise and always clear. But seems like a good, inspiring resource for things to consider.
If it is expected that a method might fail, then it should fail, either by throwing an Exception or, if not - it should return a special case None/Null type object of the desired class (following the Null Object Pattern), not null itself.
I've never heard of evading null with a Null object. Seems like a bad idea to me. Maybe it could work in some language, but generally I would say prefer result typing. Introducing a result type wrapping or extending the result value type is complexity I would be very evasive to introduce if the language doesn't already support result wrapper/state types.
This might be educational: https://docs.oracle.com/javase/8/docs/api/java/util/Optional.html
There are issues that the Optional
class alleviates that are common enough to be documented: https://www.jetbrains.com/help/inspectopedia/ConditionalCanBeOptional.html (more detail is available at places like https://github.com/JetBrains/intellij-community/blob/a2d32ec64ed0fb37c7cc97856aa94cce95b17ee5/java/java-impl/src/inspectionDescriptions/ConditionalCanBeOptional.html (I believe this information used to be visible with the "inspectopedia" URLs but I don't see that today))
On the other hand, it seems there are some features / situations that require null
to be present: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Optional_chaining https://www.jetbrains.com/help/inspectopedia/OptionalToIf.html
I’ve never heard of evading null with a Null object.
This is quite standard, and in fact it's even a safety feature. C++ introduced nullptr defined as an instance of std::nullptr_t explicitly with this in mind.
https://en.cppreference.com/w/cpp/language/nullptr
This approach is also quite basic in monadic types.
"Monadic type" has something like three meanings depending on context, and it's not clear which one you mean. One of them is common in math, but not so common in programming, so probably not that. But neither "parametric types with a single argument" nor "types that encode a category-theoretic monad" have the property you say, as far as I know.
I imagine you're probably referring to the latter, since the optional monad exists. That's very different from returning null. The inhabitants of Integer
in Java, for example, are the boxed machine ints and null
. The inhabitants of Optional[Integer]
(it won't let me use angle brackets here) are Optional.of(i)
for each machine int i
, Optional.empty()
, and null
.
Optional.empty()
is not null and should not be called a "Null object." It's also not of type Integer
, so you're not even allowed to return it unless the function type explicitly says so. Writing such function types is pretty uncommon to do in java programs but it's more normal in kotlin. In languages like Haskell, which don't have null
at all, this is idiomatic.
This doesn't seem overly useful.
It's a list taken out of a bunch of books with no regard for how something can be the best path in one language and a smell in another language.
Look at this page for example: https://luzkan.github.io/smells/imperative-loops
It suggests using functional loop methods (.map()
, .reduce()
, .filter()
) instead of using imperative loops (for
, for in
, for each
) but completely disregards the facts that imperative loops also have access to the break
, continue
, and return
keywords to improve performance.
For example: If I have an unsorted list of 1000 cars which includes a whole bunch of information per car (e.g. color, year manufactured, etc...), and I want to know if there were any cars were manufactured before the year 1980, I can run an imperative loop through the list and early return true if I find one, and only returning false if I haven't found one by the end of the list.
If the third car was made in 1977, then I have only iterated through 3 cars to find my answer.
But if I were to try this with only functional loops, I would have to iterate through all 1000 cars before I had my answer.
A website with blind rules like this is going to lead to worse code.
That’s a pretty bad example since most functional frameworks include an any or some function that returns early.
..what? At least with Java Streams or Kotlin Sequences, they absolutely abort early with something like .filter().first()
.
Also, Effective Java specifically says to use streams judiciously and prefer traditional for loops in general.
This is like SCPs but for devs
You're thinking of CVEs.