: These are "read only" interfaces exposed to users as a part of the
: API.  They never implement but use them a lot so they have to be
: public

Yeah, but there's no such thing as a "read only" interface :) ... even if 
you can't think of a reason why someone would implement your interface, if 
it's public they might, and then they might complain that their app 
doesn't compile when they upgrade from Solr 1.3.0 to Solr 1.3.1 becuase 
you added a method to it.   

it's silly, i agree, but it's happened ... more then once, which is why 
the safe thing to do is add a simple javadoc comment in cases like this 
.... "Note: This interface is not intended to be implemented by third 
party code, it may change without warning."


-Hoss

Reply via email to