src/main/java/com/indexdata/mkjsf/pazpar2/commands/Pazpar2Command.java

   1 package com.indexdata.mkjsf.pazpar2.commands;\r
   2 \r
   3 import java.io.Serializable;\r
   4 import java.util.HashMap;\r
   5 import java.util.Map;\r
   6 import java.util.StringTokenizer;\r
   7 \r
   8 import org.apache.log4j.Logger;\r
   9 \r
  10 import com.indexdata.mkjsf.pazpar2.ClientCommandResponse;\r
  11 import com.indexdata.mkjsf.pazpar2.HttpResponseWrapper;\r
  12 import com.indexdata.mkjsf.pazpar2.Pz2Service;\r
  13 import com.indexdata.mkjsf.pazpar2.SearchClient;\r
  14 import com.indexdata.mkjsf.pazpar2.commands.sp.ServiceProxyCommand;\r
  15 import com.indexdata.mkjsf.pazpar2.data.ResponseDataObject;\r
  16 import com.indexdata.mkjsf.pazpar2.data.ResponseParser;\r
  17 import com.indexdata.mkjsf.pazpar2.data.Responses;\r
  18 \r
  19 /**\r
  20  * Represents a generic Pazpar2 or Service Proxy command with all its current parameters, and has\r
  21  * methods for executing the command against the currently selected Pazpar2 service</p>\r
  22  * <p>Being an abstract class it only has generic methods for getting and setting parameters. \r
  23  * Implementing classes are supposed to create named getters and setters for convenient access\r
  24  * to parameters from the UI.</p> \r
  25  * <p>Parameters can be set with or without notifying the state manager.<p>\r
  26  * \r
  27  * <p><i>Note: Internally the application has to be able to set parameters without state changes \r
  28  * - for instance to avoid eternal feedback when copying parameter from one state to the next. A \r
  29  * setting from the UI should spawn a new search state however.</i></p>   \r
  30  * \r
  31  * @author Niels Erik\r
  32  *\r
  33  */\r
  34 public abstract class Pazpar2Command implements Serializable  {\r
  35   \r
  36   private static Logger logger = Logger.getLogger(Pazpar2Command.class);\r
  37   private static final long serialVersionUID = -6825491856480675917L;   \r
  38   protected String name = "";\r
  39   protected Map<String,CommandParameter> parameters = new HashMap<String,CommandParameter>();  \r
  40   \r
  41   public Pazpar2Command () {    \r
  42   }\r
  43   \r
  44   public void setCommandName(String name) {\r
  45     this.name = name;\r
  46   }\r
  47           \r
  48   public Pazpar2Command (String name) {\r
  49     this.name = name;    \r
  50   }\r
  51       \r
  52   /**\r
  53    * Commands must implement this method to provide an completely detached, deep clone of \r
  54    * themselves.\r
  55    * \r
  56    * The clone is needed by the state manager to transfer commands with current setting \r
  57    * from one state to the next.\r
  58    * \r
  59    * Whenever a non-standard attribute is added to a command class, the copy method must \r
  60    * be updated to ensure that the new attribute is brought over as well. \r
  61    *   \r
  62    * @return a Pazpar2 command of the given type\r
  63    */\r
  64   public abstract Pazpar2Command copy ();\r
  65           \r
  66   public String getCommandName() {\r
  67     return name;\r
  68   }\r
  69   \r
  70   /**\r
  71    * Executes the command with the currently selected parameters against \r
  72    * the currently selected Pazpar2 service\r
  73    * \r
  74    * @return Response data object based on the Pazpar2 service response. \r
  75    */\r
  76   public ResponseDataObject run() {    \r
  77     return run(Pz2Service.get().getSearchClient(),\r
  78                Pz2Service.get().getPzresp());\r
  79   }\r
  80   \r
  81   /**\r
  82    * Executes the commands with the currently selected parameters, while adding\r
  83    * the parameters provided\r
  84    * @param parameters A list of parameters on the form [key=value]\r
  85    * \r
  86    * @return Response data object based on the Pazpar2 service response\r
  87    */\r
  88   public ResponseDataObject runWith(String parameters) {\r
  89     StringTokenizer expressions = new StringTokenizer(parameters,";");\r
  90     while (expressions.hasMoreTokens()) {\r
  91       String expression = expressions.nextToken();\r
  92       StringTokenizer tokenizer = new StringTokenizer(expression,"=");\r
  93       String name = (String) tokenizer.nextElement();\r
  94       String value = (String) tokenizer.nextElement();\r
  95       CommandParameter commandParameter = new CommandParameter(name,"=",value);\r
  96       setParameterInState(commandParameter);\r
  97     }\r
  98     return run();\r
  99   }\r
 100     \r
 101   /**\r
 102    * Executes the command in a thread.  \r
 103    * \r
 104    * Note: Client and Responses must be provided because at this point \r
 105    * CDI beans cannot be retrieved from within a thread.\r
 106    * \r
 107    * @param client\r
 108    * @param pzresp\r
 109    * @return\r
 110    */\r
 111   public ResponseDataObject run(SearchClient client,Responses pzresp) {\r
 112     logger.debug("Running " + getCommandName() + " using " + client);    \r
 113     HttpResponseWrapper httpResponse = client.executeCommand(this);\r
 114     logger.debug("Parsing response for " + getCommandName());\r
 115     ResponseDataObject responseObject = ResponseParser.getParser().getDataObject((ClientCommandResponse) httpResponse);\r
 116     logger.trace("Storing response for " + getCommandName());\r
 117     pzresp.put(getCommandName(), responseObject);\r
 118     return responseObject;    \r
 119   }\r
 120   \r
 121    \r
 122   /**\r
 123    * Sets a parameter on this command and notifies the state manager\r
 124    * about the change\r
 125    * \r
 126    * @param parameter \r
 127    */\r
 128   public void setParameter (CommandParameter parameter) {\r
 129     Pazpar2Command copy = this.copy();\r
 130     logger.trace(name + " command: setting parameter [" + parameter.getName() + "=" + parameter.getValueWithExpressions() + "]");\r
 131     copy.parameters.put(parameter.getName(),parameter);\r
 132     checkInState(copy);\r
 133   }\r
 134   \r
 135   /**\r
 136    * Sets multiple parameters on the command and notifies the state\r
 137    * manager -- once -- about the change\r
 138    * \r
 139    * @param params \r
 140    */\r
 141   public void setParameters (CommandParameter... params) {\r
 142     Pazpar2Command copy = this.copy();\r
 143     for (CommandParameter param : params) {\r
 144       logger.trace(name + " command: setting parameter [" + param.getName() + "=" + param.getValueWithExpressions() + "]");\r
 145       copy.parameters.put(param.getName(),param);\r
 146     }\r
 147     checkInState(copy);\r
 148   }\r
 149   \r
 150   /**\r
 151    * Sets multiple parameters on this command without notifying the state manager. \r
 152    * Typically used when one parameter setting should automatically trigger\r
 153    * other parameters to be reset to defaults etc. Intended to avoid \r
 154    * useless proliferation of states  \r
 155    * \r
 156    * @param params\r
 157    */\r
 158   public void setParametersInState (CommandParameter... params) {    \r
 159     for (CommandParameter param : params) {\r
 160       logger.trace(name + " command: setting parameter [" + param.getName() + "=" + param.getValueWithExpressions() + "] silently");\r
 161       parameters.put(param.getName(),param);\r
 162     }    \r
 163   }\r
 164   \r
 165   /**\r
 166    * Sets a parameter on this command without notifying the state manager. \r
 167    * Typically used when one parameter setting should automatically trigger\r
 168    * other parameters to be reset to defaults etc. Intended to avoid \r
 169    * useless proliferation of states  \r
 170    * \r
 171    * @param parameter\r
 172    */    \r
 173   public void setParameterInState (CommandParameter parameter) {\r
 174     logger.trace(name + " command: setting parameter [" + parameter.getName() + "=" + parameter.getValueWithExpressions() + "] silently");\r
 175     parameters.put(parameter.getName(),parameter);    \r
 176   }\r
 177   \r
 178   \r
 179   /**\r
 180    * Retrieves a command parameter by parameter name\r
 181    * \r
 182    * @param name of the parameter\r
 183    * @return CommandParameter\r
 184    */\r
 185   public CommandParameter getParameter (String name) {\r
 186     return parameters.get(name);\r
 187   }\r
 188   \r
 189   /**\r
 190    * Removes a parameter completely and notifies the state manager\r
 191    * about the change\r
 192    * \r
 193    * @param name of the parameter to remove\r
 194    */\r
 195   public void removeParameter (String name) {\r
 196     Pazpar2Command copy = this.copy();\r
 197     copy.parameters.remove(name);\r
 198     checkInState(copy);\r
 199   }\r
 200   \r
 201   /**\r
 202    * Removes multiple parameters completely and notifies the state manager\r
 203    * -- once -- about the change\r
 204    * \r
 205    * @param name of the parameter to remove\r
 206    */  \r
 207   public void removeParameters() {\r
 208     Pazpar2Command copy = this.copy();\r
 209     copy.parameters = new HashMap<String,CommandParameter>();\r
 210     checkInState(copy);\r
 211   }\r
 212   \r
 213   \r
 214   /**\r
 215    * Removes all parameters without notifying the state manager. For instance\r
 216    * used in case of change of Pazpar2 service or renewed login to a service.\r
 217    *  \r
 218    */\r
 219   public void removeParametersInState() {\r
 220     parameters = new HashMap<String,CommandParameter>();    \r
 221   }\r
 222   \r
 223   /**\r
 224    * Adds an expression to an ordered list of expressions on a given parameter\r
 225    * and notifies the state manager of the change\r
 226    * \r
 227    * @param parameterName name of the parameter to add the expression to\r
 228    * @param expression\r
 229    */\r
 230   public void addExpression(String parameterName, Expression expression) {\r
 231     Pazpar2Command copy = this.copy();\r
 232     copy.getParameter(parameterName).addExpression(expression);\r
 233     checkInState(copy);\r
 234   }\r
 235   \r
 236   public void removeExpression(String parameterName, Expression expression) {\r
 237     Pazpar2Command copy = this.copy();\r
 238     copy.getParameter(parameterName).removeExpression(expression);\r
 239     checkInState(copy);    \r
 240   }\r
 241   \r
 242   public void removeExpressionsAfter(String parameterName, Expression expression,String... expressionFields) {\r
 243     Pazpar2Command copy = this.copy();\r
 244     copy.getParameter(parameterName).removeExpressionsAfter(expression,expressionFields);\r
 245     checkInState(copy);    \r
 246   }\r
 247   \r
 248   public void removeExpressions(String parameterName, String... expressionFields) {\r
 249     Pazpar2Command copy = this.copy();    \r
 250     copy.getParameter(parameterName).removeExpressions(expressionFields);    \r
 251     if (!getParameter(parameterName).hasValue() && !getParameter(parameterName).hasExpressions()) {\r
 252       copy.parameters.remove(parameterName);\r
 253     }\r
 254     checkInState(copy);    \r
 255   }\r
 256   \r
 257   public boolean hasParameters () {\r
 258     return (parameters.keySet().size()>0);\r
 259   }\r
 260   \r
 261   public boolean hasParameterValue(String parameterName) {\r
 262     return (parameters.get(parameterName) != null && (parameters.get(parameterName).hasValue()));\r
 263   }\r
 264     \r
 265   public String getEncodedQueryString () {\r
 266     StringBuilder queryString = new StringBuilder("command="+name);\r
 267     for (CommandParameter parameter : parameters.values()) {\r
 268       if (parameter.hasValue() || parameter.hasExpressions()) {\r
 269         queryString.append("&"+parameter.getEncodedQueryString());\r
 270       }\r
 271     }\r
 272     return queryString.toString();\r
 273   } \r
 274     \r
 275   public String getValueWithExpressions() {    \r
 276     StringBuilder value = new StringBuilder("");\r
 277     for (CommandParameter parameter : parameters.values()) {\r
 278       if (parameter.hasValue() || parameter.hasExpressions()) {\r
 279         value.append("&" + parameter.getName() + parameter.operator + parameter.getValueWithExpressions());\r
 280       }\r
 281    }\r
 282     return value.toString();\r
 283   }\r
 284   \r
 285   @Override\r
 286   public boolean equals (Object otherCommand) {\r
 287     logger.trace("Comparing commands ["+this.toString()+"] and ["+otherCommand.toString() +"]");\r
 288     return\r
 289         ((otherCommand instanceof Pazpar2Command)\r
 290          && this.getValueWithExpressions().equals(((Pazpar2Command) otherCommand).getValueWithExpressions()));\r
 291   }\r
 292   \r
 293   @Override\r
 294   public int hashCode () {\r
 295     return getValueWithExpressions().hashCode();\r
 296   }\r
 297   \r
 298   public String toString () {\r
 299     return parameters.toString();\r
 300   }\r
 301 \r
 302   public String getParameterValue(String parameterName) {\r
 303     return getParameter(parameterName)==null ? "" : getParameter(parameterName).getValueWithExpressions();    \r
 304   }\r
 305 \r
 306   /*\r
 307   public String getUrlEncodedParameterValue(String parameterName) {\r
 308     return getParameter(parameterName).getEncodedQueryString();\r
 309   }\r
 310   */\r
 311   \r
 312   public void setSession (String sessionId) {\r
 313     setParameter(new CommandParameter("session","=",sessionId));\r
 314   }\r
 315   \r
 316   public String getSession() {\r
 317     return getParameterValue("session");\r
 318   } \r
 319   \r
 320   /**\r
 321    * Notifies the state manager that this command changed a parameter\r
 322    * \r
 323    * @param command\r
 324    */\r
 325   protected void checkInState(Pazpar2Command command) {\r
 326     Pz2Service.get().getStateMgr().checkIn(command);\r
 327   }\r
 328     \r
 329   /**\r
 330    * Implementing classes must provide their Service Proxy \r
 331    * extension command if any extension parameters exists, \r
 332    * or -- just to be polite -- 'this' if there is no\r
 333    * Service Proxy extension to the given command.\r
 334    * @return\r
 335    */\r
 336   public abstract ServiceProxyCommand getSp();\r
 337      \r
 338   /**\r
 339    * Here implementing commands publish whether they only \r
 340    * apply to the Service Proxy or can be executed \r
 341    * against straight Pazpar2 as well. This is convenient for a \r
 342    * UI that switches between service types either \r
 343    * deployment time or run time.\r
 344    *   \r
 345    * @return false if the command applies to straight Pazpar2\r
 346    */\r
 347   public abstract boolean spOnly();  \r
 348 }\r