View Javadoc
1   /**
2    * This file Copyright (c) 2003-2015 Magnolia International
3    * Ltd.  (http://www.magnolia-cms.com). All rights reserved.
4    *
5    *
6    * This file is dual-licensed under both the Magnolia
7    * Network Agreement and the GNU General Public License.
8    * You may elect to use one or the other of these licenses.
9    *
10   * This file is distributed in the hope that it will be
11   * useful, but AS-IS and WITHOUT ANY WARRANTY; without even the
12   * implied warranty of MERCHANTABILITY or FITNESS FOR A
13   * PARTICULAR PURPOSE, TITLE, or NONINFRINGEMENT.
14   * Redistribution, except as permitted by whichever of the GPL
15   * or MNA you select, is prohibited.
16   *
17   * 1. For the GPL license (GPL), you can redistribute and/or
18   * modify this file under the terms of the GNU General
19   * Public License, Version 3, as published by the Free Software
20   * Foundation.  You should have received a copy of the GNU
21   * General Public License, Version 3 along with this program;
22   * if not, write to the Free Software Foundation, Inc., 51
23   * Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
24   *
25   * 2. For the Magnolia Network Agreement (MNA), this file
26   * and the accompanying materials are made available under the
27   * terms of the MNA which accompanies this distribution, and
28   * is available at http://www.magnolia-cms.com/mna.html
29   *
30   * Any modifications to this file must keep this entire header
31   * intact.
32   *
33   */
34  package info.magnolia.cms.util;
35  
36  import info.magnolia.cms.core.Content;
37  import info.magnolia.cms.core.ItemType;
38  import info.magnolia.context.MgnlContext;
39  import info.magnolia.jcr.util.NodeUtil;
40  
41  import org.apache.commons.lang.StringUtils;
42  import org.apache.commons.lang.time.DateUtils;
43  import org.slf4j.Logger;
44  import org.slf4j.LoggerFactory;
45  
46  import javax.jcr.LoginException;
47  import javax.jcr.NodeIterator;
48  import javax.jcr.RepositoryException;
49  import javax.jcr.Session;
50  import javax.jcr.query.InvalidQueryException;
51  import javax.jcr.query.Query;
52  import javax.jcr.query.QueryManager;
53  import javax.jcr.query.QueryResult;
54  import javax.jcr.query.qom.QueryObjectModel;
55  
56  import java.util.ArrayList;
57  import java.util.Arrays;
58  import java.util.Calendar;
59  import java.util.Collection;
60  import java.util.Collections;
61  import java.util.HashSet;
62  import java.util.Iterator;
63  import java.util.Set;
64  
65  /**
66   * Util to execute queries as simple as possible.
67   */
68  public class QueryUtil {
69  
70      private static Logger log = LoggerFactory.getLogger(QueryUtil.class);
71  
72      /**
73       * Executes a query.
74       * @deprecated Since 4.5.4 use search methods.
75       */
76      public static Collection<Content> query(String repository, String statement) {
77          return query(repository, statement, "sql");
78      }
79  
80      /**
81       * Executes a query.
82       * @deprecated Since 4.5.4 use search methods.
83       */
84      public static Collection<Content> query(String repository, String statement, String language) {
85          return query(repository, statement, language, ItemType.NT_BASE);
86      }
87  
88      /**
89      * @deprecated Since 4.5.4 use search methods.
90      */
91      public static Collection<Content> exceptionThrowingQuery(String repository, String statement, String language, String returnItemType) throws RepositoryException {
92          return exceptionThrowingQuery(repository, statement, language, returnItemType, Long.MAX_VALUE);
93      }
94  
95      /**
96       * Executes a query, throwing any exceptions that arise as a result.
97       * @deprecated Since 4.5.4 use search methods.
98       */
99      public static Collection<Content> exceptionThrowingQuery(String repository, String statement, String language, String returnItemType,
100         long maxResultSize) throws RepositoryException {
101         Collection<Content> results = new ArrayList<Content>();
102         if(maxResultSize <= 0){
103             maxResultSize = Long.MAX_VALUE;
104         }
105         NodeIterator iterator = search(repository, statement, language, returnItemType);
106 
107         long count = 1;
108         while(iterator.hasNext() && count <= maxResultSize){
109             results.add(ContentUtil.getContent(repository, iterator.nextNode().getPath()));
110             count++;
111         }
112         return results;
113     }
114 
115     /**
116      * @deprecated Since 4.5.4 use search methods.
117      */
118     public static Collection<Content> query(String repository, String statement, String language, String returnItemType) {
119         return query(repository, statement, language, returnItemType, Long.MAX_VALUE);
120     }
121 
122     /**
123      * Executes a query - if an exception is thrown, it is logged and an empty collection is
124      * returned.
125      * @deprecated Since 4.5.4 use search methods.
126      */
127     @SuppressWarnings("unchecked")
128     // Collections.EMPTY_LIST;
129     public static Collection<Content> query(String repository, String statement, String language, String returnItemType, long maxResultSize) {
130         try {
131             return exceptionThrowingQuery(repository, statement, language, returnItemType, maxResultSize);
132         }
133         catch (Exception e) {
134             log.error("can't execute query [" + statement + "], will return empty collection", e);
135         }
136         return Collections.EMPTY_LIST;
137     }
138 
139     /**
140      * @param month 1-12 (as opposed to java.util.Calendar 0-11 notation)
141      * @deprecated
142      */
143     public static String createDateExpression(int year, int month, int day) {
144         Calendar cal = Calendar.getInstance();
145         cal.set(year, month - 1, day);
146         return createDateExpression(cal);
147     }
148 
149     /**
150      * Expression representing a date.
151      * @deprecated since 4.5.4 use info.magnolia.cms.util.DateUtil.createDateExpression(calendar)
152      */
153     public static String createDateExpression(Calendar calendar) {
154         return DateUtil.createDateExpression(calendar);
155     }
156 
157     /**
158      * @param month 1-12 (as opposed to java.util.Calendar 0-11 notation)
159      * @deprecated
160      */
161     public static String createDateTimeExpression(int year, int month, int day, int hour, int minutes, int seconds) {
162         Calendar cal = Calendar.getInstance();
163         cal.set(year, month - 1, day, hour, minutes, seconds);
164         return createDateTimeExpression(cal);
165     }
166 
167     /**
168      * Expression representing a date and time.
169      * @deprecated since 4.5.4 use info.magnolia.cms.util.DateUtil.createDateTimeExpression(calendar)
170      */
171     public static String createDateTimeExpression(Calendar calendar) {
172         return DateUtil.createDateTimeExpression(calendar);
173     }
174 
175     /**
176      * @param month 1-12 (as opposed to java.util.Calendar 0-11 notation)
177      * @deprecated
178      */
179     public static String createDateTimeExpressionIgnoreTimeZone(int year, int month, int day, int hour, int minutes, int seconds) {
180         Calendar cal = Calendar.getInstance(DateUtils.UTC_TIME_ZONE);
181         cal.set(year, month - 1, day, hour, minutes, seconds);
182         return createDateTimeExpression(cal);
183     }
184 
185     /**
186      * Do not consider the timezone.
187      * @deprecated since 4.5.4 use info.magnolia.cms.util.DateUtil.createDateTimeExpressionIgnoreTimeZone(calendar)
188      */
189     public static String createDateTimeExpressionIgnoreTimeZone(Calendar calendar) {
190         return DateUtil.createDateTimeExpressionIgnoreTimeZone(calendar);
191     }
192     
193     /**
194      * Executes the query based on QOM and then pops-up in the node hierarchy until returnItemType is found. If the result
195      * is not returnItemType or none of its parents are then next node in result is checked.
196      * Duplicate nodes are removed from result.
197      * For date/time expressions use <code>DateUtil.create*Expression()</code> methods.
198      *
199      * @return Result as NodeIterator
200      */
201     public static NodeIterator search(QueryObjectModel model, String returnItemType) throws InvalidQueryException, RepositoryException{
202         return NodeUtil.filterDuplicates(NodeUtil.filterParentNodeType(model.execute().getNodes(), returnItemType));
203     }
204 
205     /**
206      * Executes the query with given language.Unlike in the old API item type has to be specified in query itself.
207      * <code>SELECT * FROM [mgnl:page]</code> example for selecting just pages in JCR SQL2 language.
208      * Duplicate nodes are removed from result.
209      * For date/time expressions use <code>DateUtil.create*Expression()</code> methods.
210      *
211      * @return Result as NodeIterator
212      */
213     public static NodeIterator search(String workspace, String statement, String language) throws InvalidQueryException, RepositoryException{
214         Session session = MgnlContext.getJCRSession(workspace);
215         QueryManager manager = session.getWorkspace().getQueryManager();
216         Query query = manager.createQuery(statement, language);
217 
218         return NodeUtil.filterDuplicates(query.execute().getNodes());
219     }
220 
221     /**
222      * Executes the query using JCR SQL2 language. Unlike in the old API item type has to be specified in query itself.
223      * <code>SELECT * FROM [mgnl:page]</code> example for selecting just pages.
224      * For executing old query use info.magnolia.cms.util.QueryUtil.search(String workspace, String statement, String language)
225      * where you specify <code>Query.SQL</code> as the language.
226      * For date/time expressions use <code>DateUtil.create*Expression()</code> methods.
227      *
228      * @return Result as NodeIterator
229      */
230     public static NodeIterator search(String workspace, String statement) throws InvalidQueryException, RepositoryException{
231         return search(workspace, statement, javax.jcr.query.Query.JCR_SQL2);
232     }
233 
234     /**
235      * Searches for statement and then pops-up in the node hierarchy until returnItemType is found. If the result
236      * is not returnItemType or none of its parents are then next node in result is checked. Duplicate nodes are
237      * removed from result.
238      * For date/time expressions use <code>DateUtil.create*Expression()</code> methods.
239      *
240      * @return query result as collection of nodes
241      */
242     public static NodeIterator search(String workspace, String statement, String language, String returnItemType) throws LoginException, RepositoryException{
243         return search(workspace, statement, language, returnItemType, false);
244     }
245 
246     /**
247      * Searches for statement and then pops-up in the node hierarchy until returnItemType is found. If the result
248      * is not returnItemType or none of its parents are then next node in result is checked. Duplicate nodes are
249      * removed from result.
250      * If isSelector is set to true then returnItemType will be used as the selector and result will contain only nodes
251      * that are marked by this selector.
252      * For date/time expressions use <code>DateUtil.create*Expression()</code> methods.
253      * @return iterator of nodes
254      */
255     public static NodeIterator search(String workspace, String statement, String language, String returnItemType, boolean isSelector) throws RepositoryException {
256         Session session = MgnlContext.getJCRSession(workspace);
257         QueryManager manager = session.getWorkspace().getQueryManager();
258         Query query = manager.createQuery(statement, language);
259         QueryResult result = query.execute();
260 
261         if (isSelector) {
262             return NodeUtil.filterDuplicates(NodeUtil.filterParentNodeType(result.getRows(), returnItemType));
263         }
264         return NodeUtil.filterDuplicates(NodeUtil.filterParentNodeType(result.getNodes(), returnItemType));
265     }
266     
267     /**
268      * Creates a simple SQL2 query statement.
269      */
270     public static String buildQuery (String statement, String startPath){
271         Set<String> arguments = new HashSet<String>(Arrays.asList(StringUtils.splitByWholeSeparator(statement, ",")));
272 
273         Iterator<String> argIt = arguments.iterator();
274         String queryString = "select * from [nt:base] as t where ISDESCENDANTNODE(["+startPath+"])";
275         while(argIt.hasNext()){
276             queryString = queryString + " AND contains(t.*, '"+argIt.next()+"')";
277         }
278         log.debug("query string: " + queryString);
279         return queryString;
280     }
281 }