I have been perusing the open source code of JMapViewer. If anyone else wishes to look at it, check the SVN.
In a nutshell, the main class is JMapViewer
, which is an extension of a JPanel
. There is another very important class called DefaultMapController
which acts as a MouseListener
for the main class.
The first weird thing I noticed is that the viewer has no references to the controller. The JMapViewer
constructor instantiates an anonymous instance of the DefaultMapController
, like this:
public JMapViewer() {
// other stuff
new DefaultMapController(this);
}
This seems to me to be a poor design choice, since the controller has tons of methods (options, toggles, etc - example shown below), which now can not be accessed at all, so what good are they?
public void setMovementMouseButton(int movementMouseButton) {
// changes which mouse button is used to move the map
}
The controller does have a reference to the viewer as shown in the first snippet above, which is how it is able to exercise control.
However, then I thought of something even weirder! If this anonymous instance of the listener has no references, why is it allowed to even survive? Shouldn't the GC destroy it quickly? Or is GC smart enough to know that a listener class which references a live JComponent
must also stay alive to work properly, even if it has no name for some strange reason?
So, two real questions:
- why does GC not destroy object?
- is this indeed a poor design choice, or is there some way I'm unaware of to access the controller from the class which instantiates the viewer?
I want to contribute to this open source library, and my first idea for a change is to change the JMapViewer
class to have a field referencing its controller, and to change the constructor to assign the currently anonymous controller to this new field. But, I want to make sure I'm not ignorantly missing something. I have searched the entire codebase for the text DefaultMapController
, and it only occurs in its own class definitions, and in the anonymous instantiations in the JMapViewer
constructors.
EDIT:
It does indeed appear that there is a way to access the anonymous listeners, by using the java.awt.Component
method getMouseListeners()
. So technically in my application I could search this collection for instances of DefaultMapController
, and use that to access the methods I need to use to change the controller options.
To play devil's advocate though, if I go with original idea and give the map a reference of its controller, now I have a sort of circular reference (map knows of controller and controller knows of map). Is this a bad idea?