Author: ssmiweve
Date: 2009-08-08 20:43:03 +0200 (Sat, 08 Aug 2009)
New Revision: 7263

Modified:
   trunk/
   
trunk/search-command-config-spi/src/main/java/no/sesat/search/mode/SearchModeFactory.java
Log:
svn merge http://sesat.no/svn/sesat-kernel/branches/2.18/



Property changes on: trunk
___________________________________________________________________
Modified: svn:mergeinfo
   - /branches/2.10:4629-4745
/branches/2.11:4751-4933
/branches/2.12:4943-5106
/branches/2.13:5177-5378
/branches/2.14:5379-5508
/branches/2.15:5746-5995
/branches/2.16:6024-6122,6344-6499
/branches/2.16.0:6154-6343
/branches/2.17:6340-6980
/branches/2.18:6960-7260
/branches/2.6:3862-3877
/branches/2.7:4074-4160
/branches/2.8:4295-4446
/branches/2.9:4457-4626
/branches/MAP_SEARCHv2:3935-4544
/trunk:1-6959
   + /branches/2.10:4629-4745
/branches/2.11:4751-4933
/branches/2.12:4943-5106
/branches/2.13:5177-5378
/branches/2.14:5379-5508
/branches/2.15:5746-5995
/branches/2.16:6024-6122,6344-6499
/branches/2.16.0:6154-6343
/branches/2.17:6340-6980
/branches/2.18:6960-7262
/branches/2.6:3862-3877
/branches/2.7:4074-4160
/branches/2.8:4295-4446
/branches/2.9:4457-4626
/branches/MAP_SEARCHv2:3935-4544
/trunk:1-6959

Modified: 
trunk/search-command-config-spi/src/main/java/no/sesat/search/mode/SearchModeFactory.java
===================================================================
--- 
trunk/search-command-config-spi/src/main/java/no/sesat/search/mode/SearchModeFactory.java
   2009-08-08 18:38:51 UTC (rev 7262)
+++ 
trunk/search-command-config-spi/src/main/java/no/sesat/search/mode/SearchModeFactory.java
   2009-08-08 18:43:03 UTC (rev 7263)
@@ -1,4 +1,4 @@
-/* Copyright (2006-2008) Schibsted ASA
+/* Copyright (2006-2009) Schibsted ASA
  * This file is part of SESAT.
  *
  *   SESAT is free software: you can redistribute it and/or modify
@@ -53,9 +53,32 @@
 import no.sesat.search.mode.config.querybuilder.QueryBuilderConfig;
 import no.sesat.search.run.handler.RunHandlerConfig;
 
-/** Controlling class around the deserialisation of modes.xml into all the 
SearchModes.
- *  This in turn deserialises all SearchConfigurations, QueryTransformers, 
QueryBuilders, and ResultHandlers.
+/**<p>
+ * Controlling class around the deserialisation of modes.xml into all the 
SearchModes.
+ *  This in turn deserialises all SearchConfigurations, QueryTransformers, 
QueryBuilders, and ResultHandlers.</p><p>
  *
+ * Deserialisation of xml elements to configuration classes works through each 
implementation of AbstractDocumentFactory
+ * These being: <br/>
+ *  mode --> SearchModeFactory<br/>
+ *  *-commands --> SearchModeFactory.SearchCommandFactory</br>
+ *  query-builder --> QueryBuilderFactory<br/>
+ *  query-transformers --> QueryTransformerFactory<br/>
+ *  result-handlers --> ResultHandlerFactory<br/>
+ *  run-handlers --> RunHandlerFactory<br/></p><p>
+ *
+ * The lookup of configuration classname from the xml element name generally 
follows the pattern provided by the
+ *  @see #xmlToBeanName(java.lang.String) method.
+ * But each AbstractDocumentFactory.findClass(..) provides the final 
implementations with details of which package to
+ *  look in and any static Prefix and Suffixes to the classname.</p><p>
+ * For search configuration classes the implementation is such:<br/>
+ *  1) to be found in the no.sesat.search.mode.config package<br/>
+ *  2) the first character always becomes uppercase (to suit java standards 
for naming classes)<br/>
+ *  3) the suffix "Config" is added.<br/>
+ * For example &lt;solr-command id="abc" .../&gt; becomes "SolrCommandConfig".
+ * </p><p>
+ *  The lookup from configuration class to control class happens via the value 
of the Controller annotation.
+ *  (There's discussion in moving this annotation to a normal string attribute 
in the configuration bean).
+ * </p>
  * @version <tt>$Id$</tt>
  */
 public final class SearchModeFactory extends AbstractDocumentFactory 
implements SiteKeyedFactory {

_______________________________________________
Kernel-commits mailing list
Kernel-commits@sesat.no
http://sesat.no/mailman/listinfo/kernel-commits

Reply via email to