import java.io.Serializable;\r
import java.util.HashMap;\r
import java.util.Map;\r
+import java.util.StringTokenizer;\r
\r
import org.apache.log4j.Logger;\r
\r
+import com.indexdata.mkjsf.pazpar2.ClientCommandResponse;\r
+import com.indexdata.mkjsf.pazpar2.HttpResponseWrapper;\r
+import com.indexdata.mkjsf.pazpar2.Pz2Service;\r
+import com.indexdata.mkjsf.pazpar2.SearchClient;\r
import com.indexdata.mkjsf.pazpar2.commands.sp.ServiceProxyCommand;\r
-import com.indexdata.mkjsf.pazpar2.state.StateManager;\r
+import com.indexdata.mkjsf.pazpar2.data.ResponseDataObject;\r
+import com.indexdata.mkjsf.pazpar2.data.ResponseParser;\r
+import com.indexdata.mkjsf.pazpar2.data.Responses;\r
\r
+/**\r
+ * Represents a generic Pazpar2 or Service Proxy command with all its current parameters, and has\r
+ * methods for executing the command against the currently selected Pazpar2 service</p>\r
+ * <p>Being an abstract class it only has generic methods for getting and setting parameters. \r
+ * Implementing classes are supposed to create named getters and setters for convenient access\r
+ * to parameters from the UI.</p> \r
+ * <p>Parameters can be set with or without notifying the state manager.<p>\r
+ * \r
+ * <p><i>Note: Internally the application has to be able to set parameters without state changes \r
+ * - for instance to avoid eternal feedback when copying parameter from one state to the next. A \r
+ * setting from the UI should spawn a new search state however.</i></p> \r
+ * \r
+ * @author Niels Erik\r
+ *\r
+ */\r
public abstract class Pazpar2Command implements Serializable {\r
\r
private static Logger logger = Logger.getLogger(Pazpar2Command.class);\r
private static final long serialVersionUID = -6825491856480675917L; \r
protected String name = "";\r
- protected Map<String,CommandParameter> parameters = new HashMap<String,CommandParameter>();\r
+ protected Map<String,CommandParameter> parameters = new HashMap<String,CommandParameter>(); \r
\r
- protected StateManager stateMgr;\r
- \r
- public Pazpar2Command (String name, StateManager stateMgr) {\r
+ public Pazpar2Command () { \r
+ }\r
+ \r
+ public void setCommandName(String name) {\r
this.name = name;\r
- this.stateMgr = stateMgr;\r
+ }\r
+ \r
+ public Pazpar2Command (String name) {\r
+ this.name = name; \r
}\r
\r
+ /**\r
+ * Commands must implement this method to provide a completely detached, deep clone of \r
+ * themselves.\r
+ * \r
+ * The clone is needed by the state manager to transfer commands with current setting \r
+ * from one state to the next.\r
+ * \r
+ * Whenever a non-standard attribute is added to a command class, the copy method must \r
+ * be updated to ensure that the new attribute is brought over as well. \r
+ * \r
+ * @return a Pazpar2 command of the given type\r
+ */\r
public abstract Pazpar2Command copy ();\r
- \r
- public String getName() {\r
+ \r
+ public String getCommandName() {\r
return name;\r
}\r
+ \r
+ /**\r
+ * Executes the command with the currently selected parameters against \r
+ * the currently selected Pazpar2 service\r
+ * \r
+ * @return Response data object based on the Pazpar2 service response. \r
+ */\r
+ public ResponseDataObject run() { \r
+ return run(Pz2Service.get().getSearchClient(),\r
+ Pz2Service.get().getPzresp());\r
+ }\r
+ \r
+ /**\r
+ * Executes the commands with the currently selected parameters, while adding\r
+ * the parameters provided in the vararg\r
+ * @param parameters A list of parameters on the form [key=value]\r
+ * \r
+ * @return Response data object based on the Pazpar2 service response\r
+ */\r
+ public ResponseDataObject runWith(String... parameters) {\r
+ for (String parameter : parameters) {\r
+ StringTokenizer tokenizer = new StringTokenizer(parameter,"=");\r
+ String name = (String) tokenizer.nextElement();\r
+ String value = (String) tokenizer.nextElement();\r
+ CommandParameter commandParameter = new CommandParameter(name,"=",value);\r
+ setParameterInState(commandParameter);\r
+ }\r
+ return run();\r
+ }\r
+\r
+ /**\r
+ * Executes the commands with the currently selected parameters, while adding\r
+ * the parameters provided in the 'delimiter'-separated String.\r
+ * \r
+ * Note: This is for Glassfish/JBoss support. With Tomcat7 the method \r
+ * runWith(String... parameters) can be used directly from EL \r
+ * with a vararg \r
+ * \r
+ * @param parameters A list of parameters separated by 'delimiter'\r
+ * @param delimiter The separator character of the String 'parameters' \r
+ * \r
+ * @return Response data object based on the Pazpar2 service response\r
+ */\r
+ public ResponseDataObject runWith2(String parameters, String delimiter) { \r
+ StringTokenizer params = new StringTokenizer(parameters,delimiter);\r
+ String[] vararg = new String[params.countTokens()];\r
+ int i=0;\r
+ while (params.hasMoreTokens()) {\r
+ vararg[i++] = params.nextToken();\r
+ }\r
+ return runWith(vararg);\r
+ }\r
\r
+ /**\r
+ * Executes the command in a thread. \r
+ * \r
+ * Note: Client and Responses must be provided because at this point \r
+ * CDI beans cannot be retrieved from within a thread.\r
+ * \r
+ * @param client\r
+ * @param pzresp\r
+ * @return\r
+ */\r
+ public ResponseDataObject run(SearchClient client,Responses pzresp) {\r
+ logger.debug("Running " + getCommandName() + " using " + client); \r
+ HttpResponseWrapper httpResponse = client.executeCommand(this);\r
+ logger.debug("Parsing response for " + getCommandName());\r
+ ResponseDataObject responseObject = ResponseParser.getParser().getDataObject((ClientCommandResponse) httpResponse);\r
+ logger.trace("Storing response for " + getCommandName());\r
+ pzresp.put(getCommandName(), responseObject);\r
+ return responseObject; \r
+ }\r
+ \r
+ \r
+ /**\r
+ * Sets a parameter on this command and notifies the state manager\r
+ * about the change\r
+ * \r
+ * @param parameter \r
+ */\r
public void setParameter (CommandParameter parameter) {\r
Pazpar2Command copy = this.copy();\r
- logger.debug(name + " command: setting parameter [" + parameter.getName() + "=" + parameter.getValueWithExpressions() + "]");\r
+ logger.trace(name + " command: setting parameter [" + parameter.getName() + "=" + parameter.getValueWithExpressions() + "]");\r
copy.parameters.put(parameter.getName(),parameter);\r
checkInState(copy);\r
}\r
\r
+ /**\r
+ * Sets multiple parameters on the command and notifies the state\r
+ * manager -- once -- about the change\r
+ * \r
+ * @param params \r
+ */\r
public void setParameters (CommandParameter... params) {\r
Pazpar2Command copy = this.copy();\r
for (CommandParameter param : params) {\r
- logger.debug(name + " command: setting parameter [" + param.getName() + "=" + param.getValueWithExpressions() + "]");\r
+ logger.trace(name + " command: setting parameter [" + param.getName() + "=" + param.getValueWithExpressions() + "]");\r
copy.parameters.put(param.getName(),param);\r
}\r
checkInState(copy);\r
}\r
\r
+ /**\r
+ * Sets multiple parameters on this command without notifying the state manager. \r
+ * Typically used when one parameter setting should automatically trigger\r
+ * other parameters to be reset to defaults etc. Intended to avoid \r
+ * useless proliferation of states \r
+ * \r
+ * @param params\r
+ */\r
public void setParametersInState (CommandParameter... params) { \r
for (CommandParameter param : params) {\r
- logger.debug(name + " command: setting parameter [" + param.getName() + "=" + param.getValueWithExpressions() + "] silently");\r
+ logger.trace(name + " command: setting parameter [" + param.getName() + "=" + param.getValueWithExpressions() + "] silently");\r
parameters.put(param.getName(),param);\r
} \r
}\r
- \r
+ \r
+ /**\r
+ * Sets a parameter on this command without notifying the state manager. \r
+ * Typically used when one parameter setting should automatically trigger\r
+ * other parameters to be reset to defaults etc. Intended to avoid \r
+ * useless proliferation of states \r
+ * \r
+ * @param parameter\r
+ */ \r
public void setParameterInState (CommandParameter parameter) {\r
- logger.debug(name + " command: setting parameter [" + parameter.getName() + "=" + parameter.getValueWithExpressions() + "] silently");\r
+ logger.trace(name + " command: setting parameter [" + parameter.getName() + "=" + parameter.getValueWithExpressions() + "] silently");\r
parameters.put(parameter.getName(),parameter); \r
}\r
\r
\r
+ /**\r
+ * Retrieves a command parameter by parameter name\r
+ * \r
+ * @param name of the parameter\r
+ * @return CommandParameter\r
+ */\r
public CommandParameter getParameter (String name) {\r
return parameters.get(name);\r
}\r
\r
+ /**\r
+ * Removes a parameter completely and notifies the state manager\r
+ * about the change\r
+ * \r
+ * @param name of the parameter to remove\r
+ */\r
public void removeParameter (String name) {\r
Pazpar2Command copy = this.copy();\r
copy.parameters.remove(name);\r
checkInState(copy);\r
}\r
\r
+ public void removeParameterInState (String name) {\r
+ parameters.remove(name);\r
+ }\r
+ \r
+ /**\r
+ * Removes multiple parameters completely and notifies the state manager\r
+ * -- once -- about the change\r
+ * \r
+ * @param name of the parameter to remove\r
+ */ \r
public void removeParameters() {\r
Pazpar2Command copy = this.copy();\r
copy.parameters = new HashMap<String,CommandParameter>();\r
checkInState(copy);\r
}\r
\r
+ \r
+ /**\r
+ * Removes all parameters without notifying the state manager. For instance\r
+ * used in case of change of Pazpar2 service or renewed login to a service.\r
+ * \r
+ */\r
public void removeParametersInState() {\r
parameters = new HashMap<String,CommandParameter>(); \r
}\r
-\r
+ \r
+ /**\r
+ * Adds an expression to an ordered list of expressions on a given parameter\r
+ * and notifies the state manager of the change\r
+ * \r
+ * @param parameterName name of the parameter to add the expression to\r
+ * @param expression\r
+ */\r
+ public void addExpression(String parameterName, Expression expression) {\r
+ Pazpar2Command copy = this.copy();\r
+ copy.getParameter(parameterName).addExpression(expression);\r
+ checkInState(copy);\r
+ }\r
+ \r
+ public void addExpressionInState (String parameterName, Expression expression) {\r
+ getParameter(parameterName).addExpression(expression);\r
+ }\r
+ \r
+ public void removeExpression(String parameterName, Expression expression) {\r
+ Pazpar2Command copy = this.copy();\r
+ copy.getParameter(parameterName).removeExpression(expression);\r
+ checkInState(copy); \r
+ }\r
+ \r
+ public void removeExpressionsAfter(String parameterName, Expression expression,String... expressionFields) {\r
+ Pazpar2Command copy = this.copy();\r
+ copy.getParameter(parameterName).removeExpressionsAfter(expression,expressionFields);\r
+ checkInState(copy); \r
+ }\r
+ \r
+ public void removeExpressions(String parameterName, String... expressionFields) {\r
+ if (this.getParameter(parameterName) != null) {\r
+ Pazpar2Command copy = this.copy(); \r
+ copy.getParameter(parameterName).removeExpressions(expressionFields); \r
+ if (!getParameter(parameterName).hasValue() && !getParameter(parameterName).hasExpressions()) {\r
+ copy.parameters.remove(parameterName);\r
+ }\r
+ checkInState(copy); \r
+ }\r
+ }\r
\r
public boolean hasParameters () {\r
return (parameters.keySet().size()>0);\r
}\r
\r
public boolean hasParameterValue(String parameterName) {\r
- return (parameters.get(parameterName) != null && parameters.get(parameterName).hasValue());\r
+ return (parameters.get(parameterName) != null && (parameters.get(parameterName).hasValue()));\r
}\r
- \r
+ \r
public String getEncodedQueryString () {\r
StringBuilder queryString = new StringBuilder("command="+name);\r
for (CommandParameter parameter : parameters.values()) {\r
- if (parameter.hasValue()) {\r
+ if (parameter.hasValue() || parameter.hasExpressions()) {\r
queryString.append("&"+parameter.getEncodedQueryString());\r
}\r
}\r
public String getValueWithExpressions() { \r
StringBuilder value = new StringBuilder("");\r
for (CommandParameter parameter : parameters.values()) {\r
- if (parameter.hasValue()) {\r
+ if (parameter.hasValue() || parameter.hasExpressions()) {\r
value.append("&" + parameter.getName() + parameter.operator + parameter.getValueWithExpressions());\r
}\r
}\r
\r
@Override\r
public boolean equals (Object otherCommand) {\r
+ logger.trace("Comparing commands ["+this.toString()+"] and ["+otherCommand.toString() +"]");\r
return\r
((otherCommand instanceof Pazpar2Command)\r
&& this.getValueWithExpressions().equals(((Pazpar2Command) otherCommand).getValueWithExpressions()));\r
}\r
\r
public String getParameterValue(String parameterName) {\r
- return getParameter(parameterName)==null ? "" : getParameter(parameterName).getValueWithExpressions();\r
- \r
+ return getParameter(parameterName)==null ? "" : getParameter(parameterName).getValueWithExpressions(); \r
}\r
\r
+ /*\r
public String getUrlEncodedParameterValue(String parameterName) {\r
return getParameter(parameterName).getEncodedQueryString();\r
}\r
+ */\r
\r
public void setSession (String sessionId) {\r
setParameter(new CommandParameter("session","=",sessionId));\r
return getParameterValue("session");\r
} \r
\r
- private void checkInState(Pazpar2Command command) {\r
- if (stateMgr != null) {\r
- stateMgr.checkIn(command);\r
- } else {\r
- logger.info("Command '" + command.getName() + "' not affecting state (history) as no state manager was defined for this command.");\r
- }\r
+ /**\r
+ * Notifies the state manager that this command changed a parameter\r
+ * \r
+ * @param command\r
+ */\r
+ protected void checkInState(Pazpar2Command command) {\r
+ Pz2Service.get().getStateMgr().checkIn(command);\r
}\r
- \r
+ \r
+ /**\r
+ * Implementing classes must provide their Service Proxy \r
+ * extension command if any extension parameters exists, \r
+ * or -- just to be polite -- 'this' if there is no\r
+ * Service Proxy extension to the given command.\r
+ * @return\r
+ */\r
public abstract ServiceProxyCommand getSp();\r
- \r
+ \r
+ /**\r
+ * Here implementing commands publish whether they only \r
+ * apply to the Service Proxy or can be executed \r
+ * against straight Pazpar2 as well. This is convenient for a \r
+ * UI that switches between service types either \r
+ * deployment time or run time.\r
+ * \r
+ * @return false if the command applies to straight Pazpar2\r
+ */\r
+ public abstract boolean spOnly(); \r
}\r