: DataImportHandler should also be considered experimental. Yonik was specificly refering to response formats/structures, many of which have had a warning in them cautioning people not to write code that depends on the exct format (ie: programmaticly parsing th response) until we decided if we were happy with it.
marking classes, plugins, and internal APIs "Experimental" can be done with javadocs. (if however, you are not certian that the response format from a DIH request handler is fully baked, that would be a good place to add a call to addExperimentalFormatWarning) : On Fri, Aug 29, 2008 at 2:53 AM, Yonik Seeley <[EMAIL PROTECTED]> wrote: : : > Here are the current handlers that add this warning: : > $ find . -name \*.java | xargs grep addExperimentalFormatWarning : > ./handler/admin/LukeRequestHandler.java: : > RequestHandlerUtils.addExperimentalFormatWarning( rsp ); : > ./handler/admin/PluginInfoHandler.java: : > RequestHandlerUtils.addExperimentalFormatWarning( rsp ); : > ./handler/admin/ShowFileRequestHandler.java: : > RequestHandlerUtils.addExperimentalFormatWarning(rsp); : > ./handler/admin/SystemInfoHandler.java: : > RequestHandlerUtils.addExperimentalFormatWarning( rsp ); : > ./handler/admin/ThreadDumpHandler.java: : > RequestHandlerUtils.addExperimentalFormatWarning( rsp ); : > ./handler/AnalysisRequestHandler.java: : > RequestHandlerUtils.addExperimentalFormatWarning(rsp); : > ./handler/MoreLikeThisHandler.java: : > RequestHandlerUtils.addExperimentalFormatWarning( rsp ); : > ./handler/RequestHandlerUtils.java: public static void : > addExperimentalFormatWarning( SolrQueryResponse rsp ) : > ./handler/XmlUpdateRequestHandler.java: : > RequestHandlerUtils.addExperimentalFormatWarning( rsp ); : > : > Which ones are actually still more in flux (or that we're not happy : > with and plan on changing in 1.4 perhaps)? : > : > -Yonik : > : : : : -- : Regards, : Shalin Shekhar Mangar. : -Hoss
