How does java get to know which implementation object of interface to return?

Question

Please be gentle while answering, I am not a java developer (or developer in General)

While trying xml parsing with java I came across following -

NodeList nodelist = document.getElementsByTagName("item");

Herein xml dom object let me collect all objects depending on tag name I provide, but return type is an Interface called - nodelist. Since interface can not be instantiated it was a bit surprising for me.

Keeping break point and debugging the code I realized that I actually get object for class DeepNodeListImpl which implements NodeList interface.

How does this happen? How does java know to return object of "some implementation" held by my Interface "object" in the statement declared above.

One more thing - while reading the java api I found that IIOMetadataNode implements the NodeList but my previous code snippets does not get me object of type IIOMetadataNode

emory · Accepted Answer · 2011-07-28 06:51:41Z

3

Excellent Question.

Java does not know which implementation of objects to return.

In your question, you reference the Document class and its getElementsByTagName method. Document is an interface which means that by itself it has no implementation code.

Thus whoever implements the Document interface gets to choose all the details (including which NodeList implementation to return from the getElementsByTagName method).

answered Jul 28, 2011 at 6:51

emory

10.9k2 gold badges32 silver badges58 bronze badges

Sign up to request clarification or add additional context in comments.

Comments

Peter Lawrey · Accepted Answer · 2011-07-28 06:48:10Z

1

In the code for getElementByTagName there will be something like

NodeList nodeList = new DeepNodeListImpl();
// do something with nodeList
return nodeList;

Java "knows" to use this type because the code for that method will explicitly choose the implementation.

answered Jul 28, 2011 at 6:48

Peter Lawrey

535k83 gold badges770 silver badges1.2k bronze badges

1 Comment

Tarun Over a year ago

Just noticed the implementation here - google.com/codesearch#WiboLAWeTd0/image/ext/src/xerces-2_9_1/… In fact getElementsByTagName return object of type DeepNodeListImpl which implements NodeList interface, hence I am able to hold DeepNodeListImpl object as NodeList.

Mathias Schwarz · Accepted Answer · 2011-07-28 06:48:24Z

1

A method can always return a subclass of what it promises to return and in general any value can at runtime be a subtype of the type it is declared as.

The implementor of getElementsByTagName is therefore free to return something of type DeepNodeListImpl as long as it is a subtype of NodeList.

answered Jul 28, 2011 at 6:48

Mathias Schwarz

7,19725 silver badges28 bronze badges

Comments

Thorsten Dittmar · Accepted Answer · 2011-07-28 06:50:33Z

1

That's a feature of object oriented programming. A class can extend a base class (or implement an interface). The base class or the implemented interface can then be used as a "common denominator". That means: A method that returns an object of some type may actually return an object of any class derived from that type.

That's what happening in your case. You also do not really need about the actual class being used - you can use any method provided by the interface.

And you shouldn't make any assumptions about the type being returned other than the interface type. Only if you're 100% absolutely sure you may cast to the specialized type. Example: if you did a cast to DeepNodeListImpl now, but the implementation of the XML parser was changed, you might get an exception during the cast if the implementation does not return a DeepNodeListImpl or one of the derived classes anymore.

answered Jul 28, 2011 at 6:50

Thorsten Dittmar

56.9k10 gold badges95 silver badges145 bronze badges

1 Comment

Tarun Over a year ago

So is this the same thing called polymorphism?

Adriaan Koster · Accepted Answer · 2011-07-28 12:36:41Z

1

Here's a real life analogy. Suppose you contract a company to send you a gardener.

What you expect to get is a gardener who can mow your lawn and trim the hedges (the gardener interface).

What you get is a real person, who might be a man, woman, old or young and who might be able to do non-gardening related things like prepare dinner (implements the cook interface), but can at least mow your lawn and trim the hedges (implements the gardener interface).

The company is responsible for determining which implementation you get (the company plays the role of an 'abstract factory').

Normally you don't care about the non-gardening related things this implementation can do.

However, if you know your gardener can cook and you want your gardener to prepare your dinner then you need to cast the gardener to cook:

Gardener gardener = AbstractFactory.getGardener();
gardener.mowLawn();
// cast 
Cook cook = (Cook) gardener;
cook.prepareDinner();

Note that this circumvents the abstraction (and thus information-hiding) offered by the AbstractFactory: you asked for a gardener and were not supposed to care about other skills. The result of this is that if you start using a different factory in future you might get a gardener who cannot cook, and your cast will cause a ClassCastException at runtime (your dinner might taste horrible).

edited Jul 28, 2011 at 12:36

answered Jul 28, 2011 at 8:24

Adriaan Koster

16.3k5 gold badges51 silver badges64 bronze badges

1 Comment

Tarun Over a year ago

Very well explained, I know how to save my dinner now :)

Collectives™ on Stack Overflow

How does java get to know which implementation object of interface to return?

5 Answers 5

Comments

1 Comment

Comments

1 Comment

1 Comment

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

5 Answers 5

Comments

1 Comment

Comments

1 Comment

1 Comment

Your Answer

Sign up or log in

Post as a guest

Linked

Related