view org.eclipse.jface/src/org/eclipse/jface/viewers/deferred/DeferredContentProvider.d @ 12:bc29606a740c

Added dwt-addons in original directory structure of eclipse.org
author Frank Benoit <benoit@tionex.de>
date Sat, 14 Mar 2009 18:23:29 +0100
parents
children
line wrap: on
line source

/*******************************************************************************
 * Copyright (c) 2004, 2008 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 * Port to the D programming language:
 *     Frank Benoit <benoit@tionex.de>
 *******************************************************************************/
module org.eclipse.jface.viewers.deferred.DeferredContentProvider;

import org.eclipse.jface.viewers.ILazyContentProvider;
import org.eclipse.jface.viewers.deferred.AbstractVirtualTable;
import org.eclipse.jface.viewers.deferred.BackgroundContentProvider;
import org.eclipse.jface.viewers.deferred.IConcurrentModel;

import org.eclipse.swt.graphics.Rectangle;
import org.eclipse.swt.widgets.Control;
import org.eclipse.swt.widgets.Table;
import org.eclipse.core.runtime.Assert;
import org.eclipse.jface.viewers.AcceptAllFilter;
import org.eclipse.jface.viewers.IFilter;
import org.eclipse.jface.viewers.ILazyContentProvider;
import org.eclipse.jface.viewers.TableViewer;
import org.eclipse.jface.viewers.Viewer;

import java.lang.all;
import java.util.Set;

/**
 * Content provider that performs sorting and filtering in a background thread.
 * Requires a <code>TableViewer</code> created with the <code>SWT.VIRTUAL</code>
 * flag and an <code>IConcurrentModel</code> as input.
 * <p>
 * The sorter and filter must be set directly on the content provider.
 * Any sorter or filter on the TableViewer will be ignored.
 * </p>
 *
 * <p>
 * The real implementation is in <code>BackgroundContentProvider</code>. This
 * object is a lightweight wrapper that adapts the algorithm to work with
 * <code>TableViewer</code>.
 * </p>
 *
 * @since 3.1
 */
public class DeferredContentProvider : ILazyContentProvider {

    private int limit = -1;
    private BackgroundContentProvider provider;
    private Comparator sortOrder;
    private IFilter filter;

    private AbstractVirtualTable table;

    private static final class TableViewerAdapter : AbstractVirtualTable {

        private TableViewer viewer;

        /**
         * @param viewer
         */
        public this(TableViewer viewer) {
            this.viewer = viewer;
        }

        /* (non-Javadoc)
         * @see org.eclipse.jface.viewers.deferred.AbstractVirtualTable#flushCache(java.lang.Object)
         */
        public override void clear(int index) {
            viewer.clear(index);
        }

        /* (non-Javadoc)
         * @see org.eclipse.jface.viewers.deferred.AbstractVirtualTable#replace(java.lang.Object, int)
         */
        public override void replace(Object element, int itemIndex) {
            viewer.replace(element, itemIndex);
        }

        /* (non-Javadoc)
         * @see org.eclipse.jface.viewers.deferred.AbstractVirtualTable#setItemCount(int)
         */
        public override void setItemCount(int total) {
            viewer.setItemCount(total);
        }

        /* (non-Javadoc)
         * @see org.eclipse.jface.viewers.deferred.AbstractVirtualTable#getItemCount()
         */
        public override int getItemCount() {
            return viewer.getTable().getItemCount();
        }

        /* (non-Javadoc)
         * @see org.eclipse.jface.viewers.deferred.AbstractVirtualTable#getTopIndex()
         */
        public override int getTopIndex() {
            return Math.max(viewer.getTable().getTopIndex() - 1, 0);
        }

        /* (non-Javadoc)
         * @see org.eclipse.jface.viewers.deferred.AbstractVirtualTable#getVisibleItemCount()
         */
        public override int getVisibleItemCount() {
            Table table = viewer.getTable();
            Rectangle rect = table.getClientArea ();
            int itemHeight = table.getItemHeight ();
            int headerHeight = table.getHeaderHeight ();
            return (rect.height - headerHeight + itemHeight - 1) / (itemHeight + table.getGridLineWidth());
        }

        /* (non-Javadoc)
         * @see org.eclipse.jface.viewers.deferred.AbstractVirtualTable#getControl()
         */
        public override Control getControl() {
            return viewer.getControl();
        }

    }

    /**
     * Create a DeferredContentProvider with the given sort order.
     * @param sortOrder a comparator that sorts the content.
     */
    public this(Comparator sortOrder) {
        this.filter = AcceptAllFilter.getInstance();
        this.sortOrder = sortOrder;
    }

    /* (non-Javadoc)
     * @see org.eclipse.jface.viewers.IContentProvider#dispose()
     */
    public void dispose() {
        setProvider(null);
    }

    /* (non-Javadoc)
     * @see org.eclipse.jface.viewers.IContentProvider#inputChanged(org.eclipse.jface.viewers.Viewer, java.lang.Object, java.lang.Object)
     */
    public void inputChanged(Viewer viewer, Object oldInput, Object newInput) {
        if (newInput is null) {
            setProvider(null);
            return;
        }

        Assert.isTrue(null !is cast(IConcurrentModel)newInput );
        Assert.isTrue(null !is cast(TableViewer)viewer );
        IConcurrentModel model = cast(IConcurrentModel)newInput;

        this.table = new TableViewerAdapter(cast(TableViewer)viewer);

        BackgroundContentProvider newProvider = new BackgroundContentProvider(
                table,
                model, sortOrder);

        setProvider(newProvider);

        newProvider.setLimit(limit);
        newProvider.setFilter(filter);
    }

    /**
     * Sets the sort order for this content provider. This sort order takes priority
     * over anything that was supplied to the <code>TableViewer</code>.
     *
     * @param sortOrder new sort order. The comparator must be able to support being
     * used in a background thread.
     */
    public void setSortOrder(Comparator sortOrder) {
        Assert.isNotNull(cast(Object)sortOrder);
        this.sortOrder = sortOrder;
        if (provider !is null) {
            provider.setSortOrder(sortOrder);
        }
    }

    /**
     * Sets the filter for this content provider. This filter takes priority over
     * anything that was supplied to the <code>TableViewer</code>. The filter
     * must be capable of being used in a background thread.
     *
     * @param toSet filter to set
     */
    public void setFilter(IFilter toSet) {
        this.filter = toSet;
        if (provider !is null) {
            provider.setFilter(toSet);
        }
    }

    /**
     * Sets the maximum number of rows in the table. If the model contains more
     * than this number of elements, only the top elements will be shown based on
     * the current sort order.
     *
     * @param limit maximum number of rows to show or -1 if unbounded
     */
    public void setLimit(int limit) {
        this.limit = limit;
        if (provider !is null) {
            provider.setLimit(limit);
        }
    }

    /**
     * Returns the current maximum number of rows or -1 if unbounded
     *
     * @return the current maximum number of rows or -1 if unbounded
     */
    public int getLimit() {
        return limit;
    }

    /* (non-Javadoc)
     * @see org.eclipse.jface.viewers.ILazyContentProvider#updateElement(int)
     */
    public void updateElement(int element) {
        if (provider !is null) {
            provider.checkVisibleRange(element);
        }
    }

    private void setProvider(BackgroundContentProvider newProvider) {
        if (provider !is null) {
            provider.dispose();
        }

        provider = newProvider;
    }

}