org.apache.poi.ss.formula.SheetRangeEvaluator Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of aem-sdk-api Show documentation
The Adobe Experience Manager SDK
The newest version!
/* ====================================================================
   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.poi.ss.formula;

import org.apache.poi.ss.formula.eval.ValueEval;

/**
 * Evaluator for returning cells or sheets for a range of sheets
 */
final class SheetRangeEvaluator implements SheetRange {
    private final int _firstSheetIndex;
    private final int _lastSheetIndex;
    private final SheetRefEvaluator[] _sheetEvaluators;

    public SheetRangeEvaluator(int firstSheetIndex, int lastSheetIndex, SheetRefEvaluator[] sheetEvaluators) {
        if (firstSheetIndex < 0) {
            throw new IllegalArgumentException("Invalid firstSheetIndex: " + firstSheetIndex + ".");
        }
        if (lastSheetIndex < firstSheetIndex) {
            throw new IllegalArgumentException("Invalid lastSheetIndex: " + lastSheetIndex + " for firstSheetIndex: " + firstSheetIndex + ".");
        }
        _firstSheetIndex = firstSheetIndex;
        _lastSheetIndex = lastSheetIndex;
        _sheetEvaluators = sheetEvaluators.clone();
    }

    public SheetRangeEvaluator(int onlySheetIndex, SheetRefEvaluator sheetEvaluator) {
        this(onlySheetIndex, onlySheetIndex, new SheetRefEvaluator[] {sheetEvaluator});
    }

    public SheetRefEvaluator getSheetEvaluator(int sheetIndex) {
        if (sheetIndex < _firstSheetIndex || sheetIndex > _lastSheetIndex) {
            throw new IllegalArgumentException("Invalid SheetIndex: " + sheetIndex +
                    " - Outside range " + _firstSheetIndex + " : " + _lastSheetIndex);
        }
        return _sheetEvaluators[sheetIndex-_firstSheetIndex];
    }

    public int getFirstSheetIndex() {
        return _firstSheetIndex;
    }

    public int getLastSheetIndex() {
        return _lastSheetIndex;
    }

    public String getSheetName(int sheetIndex) {
        return getSheetEvaluator(sheetIndex).getSheetName();
    }

    public String getSheetNameRange() {
        StringBuilder sb = new StringBuilder();
        sb.append(getSheetName(_firstSheetIndex));
        if (_firstSheetIndex != _lastSheetIndex) {
            sb.append(':');
            sb.append(getSheetName(_lastSheetIndex));
        }
        return sb.toString();
    }

    public ValueEval getEvalForCell(int sheetIndex, int rowIndex, int columnIndex) {
        return getSheetEvaluator(sheetIndex).getEvalForCell(rowIndex, columnIndex);
    }

    /**
     * This method returns a lower row-number if it would lie outside the row-boundaries of
     * any sheet.
     *
     * This is used to optimize cases where very high number of rows would be checked otherwise
     * without any benefit as no such row exists anyway.
     *
     * @param rowIndex The 0-based row-index to check
     * @return If the given index lies withing the max row number across all sheets, it is returned.
     *      Otherwise, the highest used row number across all sheets is returned.
     */
    public int adjustRowNumber(int rowIndex) {
        // some code is depending on the row-numbers higher than the "last row of the sheet"
        // so we can only apply this optimisation if the given rowIndex is at or above the maximum
        // possible number of row-indices for the current SpreadSheetVersion
        boolean found = false;
        for (int i = _firstSheetIndex; i <= _lastSheetIndex; i++) {
            if (rowIndex >= _sheetEvaluators[i - _firstSheetIndex].getMaxRowNum()) {
                found = true;
            }
        }

        // rowIndex is not large enough, so no change necessary
        if (!found) {
            return rowIndex;
        }

        // reset maxRowNum if it is at the limit, i.e. we did choose "all rows" somewhere
        // This happens e.g. for whole-column-references like "A:B"

        // find the highest row-number across all relevant sheets
        int maxRowNum = 0;
        for (int i = _firstSheetIndex; i <= _lastSheetIndex; i++) {
            maxRowNum = Math.max(maxRowNum, _sheetEvaluators[i - _firstSheetIndex].getLastRowNum());
        }

        // now use the new maxRowNum if it was actually lowered
        return Math.min(rowIndex, maxRowNum);
    }
}