Java interface and implementation naming (or “I” or “Impl”)

Posted on by

How do I name my interfaces and the classes that implement my interfaces? Through much research on the internet and my own gut feelings, this is what I reckon:

I never prefix my interfaces with “I”. The value of coding to interfaces is that you can swap out the implementation with minimal hassle. It means that instead of using implementation specific class names in your code, you use interface names instead – right? So, if I’m going to be using interface names everywhere, I don’t want to have to prefix everything with “I”. Coding to interfaces is a best practice, so I don’t need to explicitly state that I am doing it…It should just happen – which makes the “I” prefix redundant.

Furthermore, the “Impl” suffix is also redundant. Yes, indeed, your dilemma isn’t as simple as picking between the two. Firstly, “Impl” doesn’t translate. “Impl” in other languages has no meaning, and yes I’m talking about Polish and Scala. In Polish (according to Google translate), “implementation” is “realizacja” and in Scala, there are no interfaces. The closest thing Scala has to interfaces is traits, which can contain implementation specific code. So really, everything is Scala is an implementation, so why you use “Impl” suffix?

Secondly “Impl” is restrictive. What happens when you want to add another implementation of Foo? You gonna call it “FooImplImpl”? “AnotherFooImpl”? “FooImpl2″? I didn’t think so. Perhaps you were going to just call it “FooImpl” and put it in a different package…

Thirdly “Impl” doesn’t convey any meaning about what the implementation is. You wouldn’t create an “AnimalImpl” would you? You’d create a “Lion” or an “Elephant”. There is almost always something that distinguishes your implementation that you can use in the class name. Even if it is a long name, it doesn’t matter – you’re coding to interfaces (remember?), so you’re rarely going to see that class name.

Lastly, and probably most importantly – you still can’t think of a name? You don’t need an interface. If you really can’t think of a name, your class must be generic enough to not need an interface and you’re probably not going to have any other implementations. Your class methods become the interface contract, and that is that.

1,903 thoughts on “Java interface and implementation naming (or “I” or “Impl”)”

  1. Not sure how to open an unfamiliar file? https://filetypedb.com offers technical documentation for over 1500 file formats: structure history specifications and a list of programs that can open each extension. A handy catalog with 32 categories — from audio and video to CAD and game formats.

  13. total casino wypЕ‚ata na skrill п»їKasyno Online Polska bitstarz bonus code

  16. gry online lotto Najlepsze kasyna internetowe legalne kasyno online

  26. 20 zl za rejestracje Najlepsze kasyna internetowe automaty lotto wygrane

  29. goldbet kasyno bonus bez depozytu п»їKasyno Online Polska online casino australia

  33. total casino com п»їKasyno Online Polska casino bez depozytu

  36. dreams casino no deposit bonus codes п»їKasyno Online Polska ukЕ‚ad w pokerze

  40. alko ruletka online Najlepsze kasyna internetowe najlepsze gry kasyno

  43. darmowe spiny bez depozytu za rejestracje Najszybciej wypЕ‚acajД…ce kasyna w Polsce kasyna internetowe legalne w polsce

  46. kasyna z darmowym bonusem bez depozytu Najlepsze kasyna internetowe salon gier pЕ‚ock

  50. blackjack online game no money Kasyno Bonus bez Depozytu za RejestracjД™ total casino aplikacja free spins

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>