+ * It will, when parse(String query) is called, construct a query like this
+ * (assuming the query consists of two terms and you specify the two fields
+ * title and body):
+ *
+ * (title:term1 body:term1) (title:term2 body:term2)
+ *
+ *
+ * + * When setDefaultOperator(AND_OPERATOR) is set, the result will be: + *
+ * + *
+ * +(title:term1 body:term1) +(title:term2 body:term2)
+ *
+ *
+ * + * When you pass a boost (title=>5 body=>10) you can get + *
+ * + *
+ * +(title:term1^5.0 body:term1^10.0) +(title:term2^5.0 body:term2^10.0)
+ *
+ *
+ * + * In other words, all the query's terms must appear, but it doesn't matter in + * what fields they appear. + *
+ */ +public MultiFieldQueryParserWrapper(String[] fields, Analyzer analyzer, Map
+ * It will, when parse(String query) is called, construct a query like this
+ * (assuming the query consists of two terms and you specify the two fields
+ * title and body):
+ *
+ * (title:term1 body:term1) (title:term2 body:term2)
+ *
+ *
+ * + * When setDefaultOperator(AND_OPERATOR) is set, the result will be: + *
+ * + *
+ * +(title:term1 body:term1) +(title:term2 body:term2)
+ *
+ *
+ * + * In other words, all the query's terms must appear, but it doesn't matter in + * what fields they appear. + *
+ */ + public MultiFieldQueryParserWrapper(String[] fields, Analyzer analyzer) { + super(null, analyzer); + + StandardQueryParser qpHelper = getQueryParserHelper(); + qpHelper.setAnalyzer(analyzer); + + qpHelper.setMultiFields(fields); + } + + /** + * Parses a query which searches on the fields specified. + *+ * If x fields are specified, this effectively constructs: + * + *
+ * <code> + * (field1:query1) (field2:query2) (field3:query3)...(fieldx:queryx) + * </code> + *+ * + * @param queries + * Queries strings to parse + * @param fields + * Fields to search on + * @param analyzer + * Analyzer to use + * @throws ParseException + * if query parsing fails + * @throws IllegalArgumentException + * if the length of the queries array differs from the length of the + * fields array + */ + public static Query parse(String[] queries, String[] fields, Analyzer analyzer) + throws ParseException { + if (queries.length != fields.length) + throw new IllegalArgumentException("queries.length != fields.length"); + BooleanQuery bQuery = new BooleanQuery(); + for (int i = 0; i < fields.length; i++) { + QueryParserWrapper qp = new QueryParserWrapper(fields[i], analyzer); + Query q = qp.parse(queries[i]); + if (q != null && // q never null, just being defensive + (!(q instanceof BooleanQuery) || ((BooleanQuery) q).getClauses().length > 0)) { + bQuery.add(q, BooleanClause.Occur.SHOULD); + } + } + return bQuery; + } + + /** + * Parses a query, searching on the fields specified. Use this if you need to + * specify certain fields as required, and others as prohibited. + *
+ * + *
+ * Usage:
+ * <code>
+ * String[] fields = {"filename", "contents", "description"};
+ * BooleanClause.Occur[] flags = {BooleanClause.Occur.SHOULD,
+ * BooleanClause.Occur.MUST,
+ * BooleanClause.Occur.MUST_NOT};
+ * MultiFieldQueryParser.parse("query", fields, flags, analyzer);
+ * </code>
+ *
+ *+ * The code above would construct a query: + * + *
+ * <code> + * (filename:query) +(contents:query) -(description:query) + * </code> + *+ * + * @param query + * Query string to parse + * @param fields + * Fields to search on + * @param flags + * Flags describing the fields + * @param analyzer + * Analyzer to use + * @throws ParseException + * if query parsing fails + * @throws IllegalArgumentException + * if the length of the fields array differs from the length of the + * flags array + */ + public static Query parse(String query, String[] fields, + BooleanClause.Occur[] flags, Analyzer analyzer) throws ParseException { + if (fields.length != flags.length) + throw new IllegalArgumentException("fields.length != flags.length"); + BooleanQuery bQuery = new BooleanQuery(); + for (int i = 0; i < fields.length; i++) { + QueryParserWrapper qp = new QueryParserWrapper(fields[i], analyzer); + Query q = qp.parse(query); + if (q != null && // q never null, just being defensive + (!(q instanceof BooleanQuery) || ((BooleanQuery) q).getClauses().length > 0)) { + bQuery.add(q, flags[i]); + } + } + return bQuery; + } + + /** + * Parses a query, searching on the fields specified. Use this if you need to + * specify certain fields as required, and others as prohibited. + *
+ * + *
+ * Usage:
+ * <code>
+ * String[] query = {"query1", "query2", "query3"};
+ * String[] fields = {"filename", "contents", "description"};
+ * BooleanClause.Occur[] flags = {BooleanClause.Occur.SHOULD,
+ * BooleanClause.Occur.MUST,
+ * BooleanClause.Occur.MUST_NOT};
+ * MultiFieldQueryParser.parse(query, fields, flags, analyzer);
+ * </code>
+ *
+ *+ * The code above would construct a query: + * + *
+ * <code> + * (filename:query1) +(contents:query2) -(description:query3) + * </code> + *+ * + * @param queries + * Queries string to parse + * @param fields + * Fields to search on + * @param flags + * Flags describing the fields + * @param analyzer + * Analyzer to use + * @throws ParseException + * if query parsing fails + * @throws IllegalArgumentException + * if the length of the queries, fields, and flags array differ + */ + public static Query parse(String[] queries, String[] fields, + BooleanClause.Occur[] flags, Analyzer analyzer) throws ParseException { + if (!(queries.length == fields.length && queries.length == flags.length)) + throw new IllegalArgumentException( + "queries, fields, and flags array have have different length"); + BooleanQuery bQuery = new BooleanQuery(); + for (int i = 0; i < fields.length; i++) { + QueryParserWrapper qp = new QueryParserWrapper(fields[i], analyzer); + Query q = qp.parse(queries[i]); + if (q != null && // q never null, just being defensive + (!(q instanceof BooleanQuery) || ((BooleanQuery) q).getClauses().length > 0)) { + bQuery.add(q, flags[i]); + } + } + return bQuery; + } + +}