1 package com.indexdata.mkjsf.pazpar2.commands;
\r
3 import java.util.Arrays;
\r
4 import java.util.List;
\r
6 import javax.enterprise.context.SessionScoped;
\r
7 import javax.inject.Named;
\r
9 import org.apache.log4j.Logger;
\r
11 import com.indexdata.mkjsf.pazpar2.Pz2Service;
\r
12 import com.indexdata.mkjsf.pazpar2.commands.sp.ServiceProxyCommand;
\r
13 import com.indexdata.mkjsf.pazpar2.data.ResponseDataObject;
\r
16 * Represents a Pazpar2 <code>search</code> command.
\r
18 * @author Niels Erik
\r
21 @SessionScoped @Named
\r
22 public class SearchCommand extends Pazpar2Command implements ServiceProxyCommand {
\r
24 private static final long serialVersionUID = -1888520867838597236L;
\r
25 private static Logger logger = Logger.getLogger(SearchCommand.class);
\r
27 public SearchCommand() {
\r
31 public ResponseDataObject run() {
\r
32 logger.info("Running " + getCommandName());
\r
33 Pz2Service.get().getStateMgr().hasPendingStateChange("search",false);
\r
34 Pz2Service.get().getPzresp().resetSearchAndBeyond();
\r
35 Pz2Service.get().getPzreq().getRecord().removeParametersInState();
\r
36 Pz2Service.get().getPzreq().getShow().setParameterInState(new CommandParameter("start","=",0));
\r
37 Pz2Service.get().getSearchClient().setSearchCommand(this);
\r
42 * Sets the <code>query</code> parameter. See Pazpar2 documentation for details.
\r
44 public void setQuery(String query) {
\r
45 setParameter(new QueryParameter("query","=",query));
\r
48 public void setBooleanOperatorForQuery(String operator) {
\r
49 Pazpar2Command copy = this.copy();
\r
50 ((QueryParameter) getParameter("query")).setBooleanOperator(operator);
\r
55 * Returns the simple part of the <code>query</code> parameter value, excluding parts that
\r
56 * were added as expressions (that is, not set with <code>setQuery()</code>).
\r
58 public String getQuery () {
\r
59 return getParameter("query") == null ? null : ((QueryParameter)getParameter("query")).getSimpleValue();
\r
63 * Returns the complete <code>query</code> parameter value, including expressions.
\r
65 public String getExtendedQuery () {
\r
66 return getParameter("query") == null ? null : ((QueryParameter)getParameter("query")).getValueWithExpressions();
\r
70 * Sets the <code>filter</code> parameter. See Pazpar2 documentation for details.
\r
72 public void setFilter(String filterExpression) {
\r
73 if (filterExpression != null && filterExpression.length()>0) {
\r
74 if (filterExpression.split("[=~]").length==1) {
\r
75 removeFilters(filterExpression.split("[=~]")[0]);
\r
76 } else if (filterExpression.split("[=~]").length==2) {
\r
77 setParameter(new FilterParameter(new Expression(filterExpression)));
\r
79 logger.error("Could not parse filter expression [" + filterExpression + "]");
\r
85 * Sets the <code>filter</code> parameter. See Pazpar2 documentation for details.
\r
87 public void setFilter(String field, String operator, String value, String label) {
\r
88 setParameter(new FilterParameter(new Expression(field,operator,value,label)));
\r
92 * Checks if there are any filter expressions matching any of the given expressionFields
\r
93 * @param expressionFields expression fields (left-of-operator entities) to look for
\r
94 * @return true if expression(s) found with any of <code>expressionFields</code>
\r
96 public boolean hasFilterExpression(String... expressionFields) {
\r
97 logger.trace("Checking for filter expression for " + Arrays.deepToString(expressionFields));
\r
98 for (String field : expressionFields) {
\r
99 if (getFilterExpressions(field) != null && getFilterExpressions(field).size()>0) {
\r
100 logger.trace("Filter expression found (" + field + ")");
\r
104 logger.trace("No filter expressions found");
\r
110 * Returns the <code>filter</code> parameter value.
\r
112 public String getFilter() {
\r
113 return getParameter("filter") == null ? null : ((FilterParameter)getParameter("filter")).getValueWithExpressions();
\r
117 * Returns the first filter expression of the given type
\r
118 * @param expressionField expression field (left-of-operator entity) to look for
\r
119 * @return the first filter expression found with the field <code>expressionField</code> or null if none found
\r
121 public Expression getOneFilterExpression(String expressionField) {
\r
122 List<Expression> exprs = getFilterExpressions(expressionField);
\r
123 if (exprs != null && exprs.size()>0) {
\r
124 if (exprs.size()>1) {
\r
125 logger.warn("More that one filter expression found for [" + expressionField + "] but only asked to return the first one");
\r
127 return exprs.get(0);
\r
135 * Returns list of all filter expressions
\r
137 public List<Expression> getFilterExpressions() {
\r
138 return getParameter("filter").getExpressions();
\r
142 public List<Expression> getFilterExpressions(String... expressionFields) {
\r
143 logger.trace("Checking for filter parameter");
\r
144 if (parameters.get("filter")!=null) {
\r
145 logger.trace("Found");
\r
146 return getParameter("filter").getExpressions(expressionFields);
\r
148 logger.trace("Not found");
\r
153 public boolean hasFilter () {
\r
154 return getFilter().length()>0;
\r
158 * Adds a filter expression with a label for display. The filter is added to the end
\r
159 * of an ordered list.
\r
166 public void addFilter(String field, String operator, String value, String label) {
\r
167 if (getParameter("filter") == null) {
\r
168 setFilter(field + operator + value);
\r
170 addExpression("filter",new Expression(field,operator,value,(label != null ? label : value)));
\r
175 * Clears the filter parameter
\r
177 public void removeFilters () {
\r
178 removeParameter("filter");
\r
182 * Removes a filter expression by exact attributes
\r
188 public void removeFilter(String field, String operator, String value) {
\r
189 removeExpression("filter",new Expression(field, operator, value, null));
\r
193 * Removes all filter expressions matching a field listed in <code>fieldsToRemove</code>
\r
194 * @param fieldsToRemove
\r
196 public void removeFilters(String... fieldsToRemove) {
\r
197 removeExpressions("filter",fieldsToRemove);
\r
201 * Removes filter expressions coming after the expression matching the provided filter expression,
\r
202 * if they have a field listed in <code>fieldsToRemove</code>. To be used for bread crumb like UI
\r
208 * @param fieldsToRemove
\r
210 public void removeFiltersAfter(String field, String operator, String value, String... fieldsToRemove) {
\r
211 removeExpressionsAfter("filter",new Expression(field,operator,value,null),fieldsToRemove);
\r
215 * Sets the <code>limit</code> parameter. See Pazpar2 documentation for details.
\r
217 public void setLimit (String limitExpression) {
\r
218 if (limitExpression != null && limitExpression.length()>0) {
\r
219 setParameter(new LimitParameter(new Expression(limitExpression)));
\r
224 * Sets the <code>limit</code> parameter including a label. See Pazpar2 documentation for details.
\r
226 public void setLimit(String field, String operator, String value, String label) {
\r
227 setParameter(new LimitParameter(new Expression(field,operator,value,label)));
\r
231 * Returns the <code>limit</code> parameter value.
\r
233 public String getLimit () {
\r
234 return getParameter("limit") == null ? null : ((FilterParameter)getParameter("limit")).getValueWithExpressions();
\r
238 * Checks if there are any limit expressions matching any of the given expressionFields
\r
239 * @param expressionFields expression fields (left-of-operator entities) to look for
\r
240 * @return true if expression(s) found with any of <code>expressionFields</code>
\r
242 public boolean hasLimitExpression(String... expressionFields) {
\r
243 logger.trace("Checking for limit expression for " + Arrays.deepToString(expressionFields));
\r
244 for (String field : expressionFields) {
\r
245 if (getLimitExpressions(field) != null && getLimitExpressions(field).size()>0) {
\r
246 logger.trace("Limit expression found (" + field + ")");
\r
250 logger.trace("No limit expressions found");
\r
255 * Returns the first limit expression of the given type
\r
256 * @param expressionField expression field (left-of-operator entity) to look for
\r
257 * @return the first limit expression found with the field <code>expressionField</code> or null if none found
\r
259 public Expression getOneLimitExpression(String expressionField) {
\r
260 List<Expression> exprs = getLimitExpressions(expressionField);
\r
261 if (exprs != null && exprs.size()>0) {
\r
262 if (exprs.size()>1) {
\r
263 logger.warn("More that one limit expression found for [" + expressionField + "] but only asked to return the first one");
\r
265 return exprs.get(0);
\r
272 * Return a list of all current limit expressions
\r
274 public List<Expression> getLimitExpressions() {
\r
275 return getParameter("limit").getExpressions();
\r
279 * Returns a list of limit expressions with fields that matches on of <code>expressionFields</code>
\r
281 * @param expressionFields limit expressions to look for
\r
283 public List<Expression> getLimitExpressions(String... expressionFields) {
\r
284 logger.trace("Checking for limit parameter");
\r
285 if (parameters.get("limit")!=null) {
\r
286 logger.trace("Found");
\r
287 return getParameter("limit").getExpressions(expressionFields);
\r
289 logger.trace("Not found");
\r
295 * Adds a limit expression with a label for display. The limit is added to the end
\r
296 * of an ordered list.
\r
303 public void addLimit(String field, String operator, String value, String label) {
\r
304 if (getParameter("limit") == null) {
\r
305 setLimit(field, operator, value, label);
\r
307 addExpression("limit",new Expression(field,operator,value,label));
\r
312 * Clears the limit parameter
\r
314 public void removeLimits() {
\r
315 removeParameter("limit");
\r
319 * Removes all limit expressions that have fields as listed in <code>fieldsToRemove</code>
\r
320 * @param fieldsToRemove
\r
322 public void removeLimits(String... fieldsToRemove) {
\r
323 removeExpressions("limit",fieldsToRemove);
\r
327 * Removes a limit expression by exact attributes
\r
333 public void removeLimit(String field, String operator, String value) {
\r
334 removeExpression("limit",new Expression(field, operator, value, null));
\r
338 * Removes limit expressions coming after the provided limit expression, if they have a field listed in
\r
339 * <code>fieldsToRemove</code>. To be used for bread crumb like UI controls.
\r
344 * @param fieldsToRemove
\r
346 public void removeLimitsAfter(String field, String operator, String value, String... fieldsToRemove) {
\r
347 removeExpressionsAfter("limit",new Expression(field,operator,value,null),fieldsToRemove);
\r
352 * Sets the <code>startrecs</code> parameter. See Pazpar2 documentation for details.
\r
354 public void setStartrecs (String startrecs) {
\r
355 setParameter(new CommandParameter("startrecs","=",startrecs));
\r
359 * Returns the <code>startrecs</code> parameter value.
\r
361 public String getStartrecs () {
\r
362 return getParameterValue("startrecs");
\r
366 * Sets the <code>maxrecs</code> parameter. See Pazpar2 documentation for details.
\r
368 public void setMaxrecs (String maxrecs) {
\r
369 setParameter(new CommandParameter("maxrecs","=",maxrecs));
\r
373 * Returns the <code>maxrecs</code> parameter value.
\r
375 public String getMaxrecs () {
\r
376 return getParameterValue("maxrecs");
\r
380 * Sets the <code>sort</code> parameter. See Pazpar2 documentation for details.
\r
382 public void setSort (String sort) {
\r
383 setParameter(new CommandParameter("sort","=",sort));
\r
387 * Returns the <code>sort</code> parameter value.
\r
389 public String getSort () {
\r
390 return getParameterValue("sort");
\r
394 * Sets the <code>rank</code> parameter. See Pazpar2 documentation for details.
\r
396 public void setRank (String rank) {
\r
397 setParameter(new CommandParameter("rank","=",rank));
\r
401 * Returns the <code>rank</code> parameter value.
\r
403 public String getRank () {
\r
404 return getParameterValue("rank");
\r
408 * Sets the <code>mergekey</code> parameter. See Pazpar2 documentation for details.
\r
410 public void setMergekey (String mergekey) {
\r
411 setParameter(new CommandParameter("mergekey","=",mergekey));
\r
415 * Returns the <code>mergekey</code> parameter value.
\r
417 public String getMergekey () {
\r
418 return getParameterValue("mergekey");
\r
423 * Adds an expression - for instance a facet criterion, with an optional label - to the query parameter
\r
427 * <li><code>{au}{=}{"Steinbeck, John"}{Steinbeck, John}</code>
\r
430 public void addQueryExpression(String field, String operator, String term, String label) {
\r
431 if (term != null && term.length()>0) {
\r
432 addExpression("query", new Expression(field,operator,term,label));
\r
437 * Removes a query expression - for instance a facet criterion - by its exact attributes
\r
443 public void removeQueryExpression(String field, String operator, String value) {
\r
444 removeExpression("query",new Expression(field, operator, value, null));
\r
449 * Sets a facet to limit the current query by. The
\r
450 * facet is appended to the query string itself (rather
\r
451 * as a separately managed entity. It will thus appear
\r
452 * in a query field as retrieved by getQuery(). It will
\r
453 * not be removed by removeFacet(...)
\r
455 * @param facetKey i.e. 'au' for author
\r
456 * @param term i.e. 'Dickens, Charles'
\r
458 public void setFacetOnQuery (String facetKey, String term) {
\r
459 String facetExpression = facetKey + "=" + term;
\r
460 if (term != null && term.length()>0) {
\r
461 String currentQuery= getQuery();
\r
462 setParameter(new QueryParameter("query","=", currentQuery + " and " + facetExpression));
\r
467 * Removes a facet set by setFacet(...)
\r
469 * Will not remove facets set by setFacetOnQuery(...)
\r
471 * @param facetKey i.e. 'au' for author
\r
472 * @param term i.e. 'Dickens, Charles'
\r
474 public void removeFacet(String facetKey, String term) {
\r
475 if (getParameter("query") != null) {
\r
476 removeExpression("query",new Expression(facetKey,"=",term,null));
\r
480 public SearchCommand copy () {
\r
481 SearchCommand newCommand = new SearchCommand();
\r
482 for (String parameterName : parameters.keySet()) {
\r
483 newCommand.setParameterInState(parameters.get(parameterName).copy());
\r
489 public ServiceProxyCommand getSp() {
\r
494 public boolean spOnly() {
\r