Class N1qlQuery

  • All Implemented Interfaces:
    Query

    public final class N1qlQuery
    extends java.lang.Object
    • Constructor Detail

      • N1qlQuery

        public N1qlQuery​(@NonNull
                         com.couchbase.lite.AbstractDatabase db,
                         @NonNull
                         java.lang.String n1ql)
    • Method Detail

      • toString

        @NonNull
        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object
      • getParameters

        @Nullable
        public Parameters getParameters()
        Returns a copies of the current parameters.
        Specified by:
        getParameters in interface Query
      • setParameters

        public void setParameters​(@Nullable
                                  Parameters parameters)
        Set parameters should copy the given parameters. Set a new parameter will also re-execute the query if there is at least one listener listening for changes.
        Specified by:
        setParameters in interface Query
      • execute

        @NonNull
        public ResultSet execute()
                          throws CouchbaseLiteException
        Executes the query. The returning a result set that enumerates result rows one at a time. You can run the query any number of times, and you can even have multiple ResultSet active at once.

        The results come from a snapshot of the database taken at the moment the run() method is called, so they will not reflect any changes made to the database afterwards.

        Specified by:
        execute in interface Query
        Returns:
        the ResultSet for the query result.
        Throws:
        CouchbaseLiteException - if there is an error when running the query.
      • explain

        @NonNull
        public java.lang.String explain()
                                 throws CouchbaseLiteException
        Returns a string describing the implementation of the compiled query. This is intended to be read by a developer for purposes of optimizing the query, especially to add database indexes. It's not machine-readable and its format may change. As currently implemented, the result is two or more lines separated by newline characters: * The first line is the SQLite SELECT statement. * The subsequent lines are the output of SQLite's "EXPLAIN QUERY PLAN" command applied to that statement; for help interpreting this, see https://www.sqlite.org/eqp.html . The most important thing to know is that if you see "SCAN TABLE", it means that SQLite is doing a slow linear scan of the documents instead of using an index.
        Specified by:
        explain in interface Query
        Returns:
        a string describing the implementation of the compiled query.
        Throws:
        CouchbaseLiteException - if an error occurs
      • addChangeListener

        @NonNull
        public ListenerToken addChangeListener​(@NonNull
                                               QueryChangeListener listener)
        Adds a query change listener. Changes will be posted on the main queue.
        Specified by:
        addChangeListener in interface Query
        Parameters:
        listener - The listener to post changes.
        Returns:
        An opaque listener token object for removing the listener.
      • addChangeListener

        @NonNull
        public ListenerToken addChangeListener​(@Nullable
                                               java.util.concurrent.Executor executor,
                                               @NonNull
                                               QueryChangeListener listener)
        Adds a query change listener with the dispatch queue on which changes will be posted. If the dispatch queue is not specified, the changes will be posted on the main queue.
        Specified by:
        addChangeListener in interface Query
        Parameters:
        executor - The executor object that calls listener. If null, use default executor.
        listener - The listener to post changes.
        Returns:
        An opaque listener token object for removing the listener.
      • removeChangeListener

        public void removeChangeListener​(@NonNull
                                         ListenerToken token)
        Removes a change listener wih the given listener token.
        Specified by:
        removeChangeListener in interface Query
        Parameters:
        token - The listener token.