Package org.hippoecm.hst.content.beans.query

Interface HstQuery

  • public interface HstQuery

    • Field Detail

      • DEFAULT_LIMIT

        static final int DEFAULT_LIMIT
        The default limit that is used for a HstQuery. Use setLimit(int) if you need to override this value.
        See Also:
        Constant Field Values

    • Method Detail

      • setFilter

        void setFilter​(BaseFilter filter)

      • createFilter

        Filter createFilter()
        Returns:
        a new empty Filter

      • setLimit

        void setLimit​(int limit)
        Sets the limit of search results. Note that setting this value very high might influence performance negatively
        Parameters:
        limit -

      • getQueryAsString

        String getQueryAsString​(boolean skipDefaultOrderBy)
                 throws QueryException
        Returns the query as string. When skipDefaultOrder is TRUE, the string representation will only include an 'order by' clause when there is set one explicitly.
        Parameters:
        skipDefaultOrderBy -
        Returns:
        the query as string
        Throws:
        QueryException - if we cannot build the query string

      • getLimit

        int getLimit()
        Returns the limit of the HstQuery. If no limit is set, it returns the default HstQuery limit DEFAULT_LIMIT
        Returns:
        the limit

      • setOffset

        void setOffset​(int offset)
        Sets the offset to start searching from. Default offset is -1 which means it is ignored. A negative offset will be ignored
        Parameters:
        offset -

      • getOffset

        int getOffset()
        Returns the offset of the HstQuery. If no offset is set through setOffset(int), the offset will be -1 and will be ignored
        Returns:
        the offset

      • addOrderByAscending

        void addOrderByAscending​(String fieldNameAttribute)
        Order the object found case sensitive ascending
        Parameters:
        fieldNameAttribute - the name of the field used to sort the search result

      • addOrderByAscendingCaseInsensitive

        void addOrderByAscendingCaseInsensitive​(String fieldNameAttribute)
        Order the object found case insensitive ascending
        Parameters:
        fieldNameAttribute - the name of the field used to sort the search result

      • addOrderByDescending

        void addOrderByDescending​(String fieldNameAttribute)
        Order the object found case sensitive descending
        Parameters:
        fieldNameAttribute - the name of the field used to sort the search result

      • addOrderByDescendingCaseInsensitive

        void addOrderByDescendingCaseInsensitive​(String fieldNameAttribute)
        Order the object found case insensitive descending
        Parameters:
        fieldNameAttribute - the name of the field used to sort the search result

      • addScopes

        void addScopes​(List<HippoBean> scopes)
        add scopes to search in. If the exact scope is already added to exclude from the search, it is removed from the excluded list.
        Parameters:
        scopes -

      • addScopes

        void addScopes​(javax.jcr.Node[] scopes)
        add scopes to search in. If the exact scope is already added to exclude from the search, it is removed from the excluded list.
        Parameters:
        scopes -

      • excludeScopes

        void excludeScopes​(List<HippoBean> scopes)
        add scopes to exclude from search. If the exact scope is already added as a scope to search in, it is removed from there
        Parameters:
        scopes -

      • excludeScopes

        void excludeScopes​(javax.jcr.Node[] scopes)
        add scopes to exclude from search. If the exact scope is already added as a scope to search in, it is removed from there
        Parameters:
        scopes -

      • execute

        HstQueryResult execute()
                throws QueryException
        The actual execution of the HstQuery. The HstQueryResult will never contain one and the same result twice. So, if a result matches the search criteria twice, it is still returned as one hit.
        Returns:
        HstQueryResult
        Throws:
        QueryException