/**
 *
 * @since 6.5.0
 */
Ext.define('Ext.data.virtual.Range', {
    extend: 'Ext.data.Range',
 
    isVirtualRange: true,
 
    /**
     * @cfg {String/Function} callback
     * The callback to call when new records in this range become available.
     */
    callback: null,
 
    /**
     * @cfg {Number} leadingBufferZone
     * The number of records to fetch beyond the active range in the direction of movement.
     * If the range is advancing forward, the additional records are beyond `end`. If
     * advancing backwards, they are before `begin`.
     */
 
    /**
     * @cfg {Boolean} prefetch
     * Specify `true` to enable prefetching for this range.
     */
    prefetch: false,
 
    /**
     * @cfg {Object} scope
     * The object that implements the supplied `callback` method.
     */
    scope: null,
 
    /**
     * @cfg {Number} trailingBufferZone
     * The number of records to fetch beyond the active trailing the direction of movement.
     * If the range is advancing forward, the additional records are before `begin`. If
     * advancing backwards, they are beyond `end`.
     */
 
    /**
     * @property {Number} direction
     * This property is set to `1` if the range was last moved forward and `-1` if it
     * was last moved backwards. This value is used to determine the "leading" and
     * "trailing" buffer zones.
     * @private
     */
    direction: 1,
 
    constructor: function(config) {
        this.adjustingPages = [];
        this.callParent([config]);
    },
 
    reset: function() {
        var me = this;
 
        me.records = {};
        me.activePages = me.prefetchPages = null;
    },
 
    privates: {
        adjustPageLocks: function(kind, adjustment) {
            var me = this,
                pages = me.adjustingPages,
                n = pages.length,
                i;
 
            // Consider:
            //
            //                     -->
            //    --+----------+==========+--------------------------+----
            //  ... | trailing |  active  |          leading         |   ...
            //    --+----------+==========+--------------------------+----
            //
            //      :------:   :------:   :++++++:                   :++++++:
            //
            //    ---------+----------+==========+--------------------------+----
            //  ...        | trailing |  active  |          leading         |   ...
            //    ---------+----------+==========+--------------------------+----
            //
            // The newly released pages (esp the prefetch pages) should be released
            // such that the closest ones are MRU vs the farthest ones. Releasing
            // them in forward order will do that.
            //
            // New consider:
            //
            //                                             <--
            //    ---------+--------------------------+==========+----------+----
            //  ...        |          leading         |  active  | trailing |   ...
            //    ---------+--------------------------+==========+----------+----
            //
            //      :++++++:                   :++++++:   :------:   :------:
            //
            //    --+--------------------------+==========+----------+---------
            //  ... |          leading         |  active  | trailing |   ...
            //    --+--------------------------+==========+----------+---------
            //
            // When going backwards, we want to release the pages backwards (we'll
            // just sort them that way). That way the page with least index will be
            // released last and be MRU than the others.
 
            if (> 1) {
                // Since pages are in objects keyed by page number, there is no
                // order during our set operations... so we sort the array now by
                // page number (ordered by our current direction).
                pages.sort(me.direction < 0 ? me.pageSortBackFn : me.pageSortFwdFn);
            }
 
            for (= 0; i < n; ++i) {
                pages[i].adjustLock(kind, adjustment);
            }
 
            pages.length = 0;
        },
 
        doGoto: function() {
            var me = this,
                begin = me.begin,
                end = me.end,
                prefetch = me.prefetch,
                records = me.records,
                store = me.store,
                pageMap = store.pageMap,
                limit = store.totalCount,
                beginWas = me.lastBegin,
                endWas = me.lastEnd,
                activePagesWas = me.activePages,
                prefetchPagesWas = me.prefetchPages,
                beginBufferZone = me.trailingBufferZone,
                endBufferZone = me.leadingBufferZone,
                adjustingPages = me.adjustingPages,
                activePages, page, pg, direction,
                prefetchBegin, prefetchEnd, prefetchPages;
 
            adjustingPages.length = 0;
 
            // Forwards
            //
            // Most likely case:
            //
            //             beginWas          endWas
            //             |=================|
            //             :---:             :+++:
            //                 |=================|
            //                 begin             end
            //
            // Big step forwards:
            //
            //             beginWas          endWas
            //             |=================|
            //             :-----------------:     :+++++++++++++++++:
            //                                     |=================|
            //                                     begin             end
            //
            // Interesting case:
            //
            //             beginWas          endWas
            //             |=================|
            //             :---:         :---:
            //                 |=========|
            //                 begin     end
 
            // Backwards
            //
            // Most likely case:
            //
            //             beginWas          endWas
            //             |=================|
            //          :++:              :--:
            //          |=================|
            //          begin             end
            //
            // Big step back:
            //                                 beginWas          endWas
            //                                 |=================|
            //          :+++++++++++++++++:    :-----------------:
            //          |=================|
            //          begin             end
            //
            // Interesting case:
            //
            //             beginWas          endWas
            //             |=================|
            //          :++:                 :++:
            //          |=======================|
            //          begin                   end
 
            // Retain the direction if narrowing or widening the range
            if ((begin > beginWas && end < endWas) || (begin < beginWas && end > endWas)) {
                direction = me.direction;
            }
            else {
                direction = (begin < beginWas) ? -1 : ((begin > beginWas) ? 1 : me.direction);
            }
 
            if (direction < 0) { // if (backwards)
                pg = beginBufferZone;
                beginBufferZone = endBufferZone;
                endBufferZone = pg;
            }
 
            me.direction = direction;
            me.activePages = activePages = pageMap.getPages(begin, end);
 
            if (prefetch) {
                me.prefetchBegin = prefetchBegin = Math.max(0, begin - beginBufferZone);
 
                // If we don't know the size of the store yet, don't try and limit the pages
                if (limit === null) {
                    limit = Number.MAX_VALUE;
                }
 
                me.prefetchEnd = prefetchEnd = Math.min(limit, end + endBufferZone);
 
                me.prefetchPages = prefetchPages = pageMap.getPages(prefetchBegin, prefetchEnd);
            }
 
            // In set terms we want to do this:
            //
            //      A  = activePages
            //      Aw = activePagesWas
            //      P  = prefetchPages
            //      Pw = prefetchPagesWas
            //
            //      P -= A;    (activePages start out also in prefetchPages)
            //
            //      foreach page p in (A - Aw), p.lock('active') and p.fill(records)
            //
            //      foreach page p in (P - Pw), p.lock('prefetch')
            //
            //      foreach page p in (Aw - A), p.release('active') and p.clear(records)
            //
            //      foreach page p in (Pw - P), p.release('prefetch')
            //
 
            for (pg in activePages) {
                page = activePages[pg];
 
                // Any pages that we will be actively locking, we don't want to mark as
                // prefetch:
                if (prefetchPages) {
                    delete prefetchPages[pg];
                }
 
                if (activePagesWas && pg in activePagesWas) {
                    // We will unlock any activePages we no longer need so remove
                    // those we will be keeping:
                    delete activePagesWas[pg];
                }
                else {
                    // For pages that weren't previously active, lock them now.
                    page.adjustLock('active', 1);
                    page.fillRecords(records);
                }
            }
 
            if (prefetchPages) {
                for (pg in prefetchPages) {
                    if (prefetchPagesWas && pg in prefetchPagesWas) {
                        // If page was previously locked for prefetch, we don't want to
                        // release it...
                        delete prefetchPagesWas[pg];
                    }
                    else {
                        prefetchPages[pg].adjustLock('prefetch', 1);
                    }
                }
            }
 
            // What's left in our "was" maps are those active or prefetch pages that we
            // previously had need of but no longer need them in that same way. Release
            // our previously prefetched pages first in case this is their final lock (we
            // want them to be retained but at a lower priority then previously active
            // pages).
 
            if (prefetchPagesWas) {
                for (pg in prefetchPagesWas) {
                    adjustingPages.push(prefetchPagesWas[pg]);
                }
 
                if (adjustingPages.length) {
                    me.adjustPageLocks('prefetch', -1);
                }
            }
 
            if (activePagesWas) {
                for (pg in activePagesWas) {
                    adjustingPages.push(page = activePagesWas[pg]);
                    page.clearRecords(records);
                }
 
                if (adjustingPages.length) {
                    me.adjustPageLocks('active', -1);
                }
            }
 
            if (prefetchPages) {
                pageMap.prioritizePrefetch(direction, pageMap.getPageIndex(begin),
                                           pageMap.getPageIndex(end - 1));
            }
 
            me.lastBegin = begin;
            me.lastEnd = end;
 
            // This can occur if the store reloads empty. As such, trigger the callback
            // immediately since there won't be any loads.
            if (begin === end && begin === 0) {
                this.triggerCallback(0, 0);
            }
        },
 
        onPageDestroy: function(page) {
            var n = page.number,
                activePages = this.activePages,
                prefetchPages = this.prefetchPages;
 
            if (activePages) {
                delete activePages[n];
            }
 
            if (prefetchPages) {
                delete prefetchPages[n];
            }
        },
 
        onPageLoad: function(page) {
            var me = this,
                wait = me.activeWait,
                first, last;
 
            if (me.activePages[page.number]) {
                page.fillRecords(me.records);
 
                // Clip the range to our actually active range for the sake of
                // the user:
                first = Math.max(me.begin, page.begin);
                last = Math.min(me.end, page.end);
 
                me.triggerCallback(first, last);
 
                if (wait) {
                    wait.got++;
                    me.resolveWaitIfSatisfied();
                }
            }
        },
 
        pageSortBackFn: function(page1, page2) {
            return page2.number - page1.number;
        },
 
        pageSortFwdFn: function(page1, page2) {
            return page1.number - page2.number;
        },
 
        refresh: function() {
            // ... we don't want to reset this.records
            this.records = this.records || {};
        },
 
        reload: function() {
            var me = this,
                begin = me.begin,
                end = me.end;
 
            me.begin = me.end = 0;
            me.direction = 1;
            me.prefetchPages = me.activePages = null;
 
            me.goto(begin, end);
        },
 
        resolveWaitIfSatisfied: function() {
            var wait = this.activeWait;
 
            if (wait && wait.got === wait.needed) {
                this.resolveWait(this);
            }
        },
 
        setupWait: function(begin, end) {
            var result = this.callParent([begin, end]),
                pages = this.store.pageMap.getPages(begin, end),
                needed = 0,
                p;
 
            for (in pages) {
                needed += pages[p].isLoaded() ? 0 : 1;
            }
 
            result.got = 0;
            result.needed = needed;
 
            return result;
        },
 
        triggerCallback: function(first, last) {
            var callback = this.callback;
 
            if (callback) {
                Ext.callback(callback, this.scope, [this, first, last]);
            }
        }
    }
});