org.apache.jackrabbit.core.query.lucene.CommittableIndexReader.java Source code

Introduction

Here is the source code for org.apache.jackrabbit.core.query.lucene.CommittableIndexReader.java

Source

/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.apache.jackrabbit.core.query.lucene;

import java.io.IOException;
import java.util.ArrayList;
import java.util.BitSet;
import java.util.Collection;
import java.util.Collections;
import java.util.LinkedList;
import java.util.List;

import org.apache.lucene.index.CorruptIndexException;
import org.apache.lucene.index.FilterIndexReader;
import org.apache.lucene.index.IndexReader;

/**
 * Wraps an <code>IndexReader</code> and allows to commit changes without
 * closing the reader.
 */
class CommittableIndexReader extends FilterIndexReader {

    /**
     * The maximum size of the delete history.
     */
    private static final int DELETE_HISTORY_SIZE = 1000;

    /**
     * A modification count on this index reader. Initialized with
     * {@link IndexReader#getVersion()} and incremented with every call to
     * {@link #doDelete(int)}.
     */
    private volatile long modCount;

    /**
     * The history of the most recent deletes.
     */
    private final List<Integer> deleteHistory = new LinkedList<Integer>();

    /**
    * The deleted docs for this index reader.
    */
    private final BitSet deletedDocs = new BitSet();

    /**
     * Creates a new <code>CommittableIndexReader</code> based on <code>in</code>.
     *
     * @param in the <code>IndexReader</code> to wrap.
     */
    CommittableIndexReader(IndexReader in) {
        super(in);
        modCount = in.getVersion();
        int maxDocs = in.maxDoc();
        for (int i = 0; i < maxDocs; i++) {
            if (in.isDeleted(i)) {
                deletedDocs.set(i);
            }
        }
    }

    //------------------------< FilterIndexReader >-----------------------------

    /**
     * {@inheritDoc}
     * <p/>
     * Increments the modification count.
     */
    protected void doDelete(int n) throws CorruptIndexException, IOException {
        super.doDelete(n);
        modCount++;
        if (deleteHistory.size() >= DELETE_HISTORY_SIZE) {
            deleteHistory.remove(0);
        }
        deleteHistory.add(n);
        deletedDocs.set(n);
    }

    //------------------------< additional methods >----------------------------

    /**
     * @return the modification count of this index reader.
     */
    long getModificationCount() {
        return modCount;
    }

    /**
     * Returns the document numbers of deleted nodes since the given
     * <code>modCount</code>.
     *
     * @param modCount a modification count.
     * @return document numbers of deleted nodes or <code>null</code> if this
     *         index reader cannot provide those document number. e.g. modCount
     *         is too far back in the past.
     * @throws IllegalArgumentException if <code>modCount</code> is larger than
     *                                  {@link #getModificationCount()}.
     */
    Collection<Integer> getDeletedSince(long modCount) throws IllegalArgumentException {
        if (modCount > this.modCount) {
            throw new IllegalArgumentException("modCount: " + modCount + " > " + this.modCount);
        }
        if (modCount == this.modCount) {
            return Collections.emptyList();
        }
        long num = this.modCount - modCount;
        if (num > deleteHistory.size()) {
            return null;
        }
        List<Integer> deletes = new ArrayList<Integer>((int) num);
        for (Integer d : deleteHistory.subList((int) (deleteHistory.size() - num), deleteHistory.size())) {
            deletes.add(d);
        }
        return deletes;
    }

    /**
     * Returns a copy of the deleted documents BitSet.
     * @return the deleted documents of this index reader.
     */
    BitSet getDeletedDocs() {
        return (BitSet) deletedDocs.clone();
    }

    @Override
    public String toString() {
        final StringBuilder buffer = new StringBuilder("CommittableIndexReader(");
        buffer.append(in);
        buffer.append(',');
        buffer.append(modCount);
        buffer.append(')');
        return buffer.toString();
    }
}