123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260 |
- /* ====================================================================
- 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.hssf.record;
-
- import java.util.ArrayList;
- import java.util.List;
-
- import org.apache.poi.util.LittleEndianOutput;
-
- /**
- * EXTERNSHEET (0x0017)<br/>
- * A List of Indexes to EXTERNALBOOK (supplemental book) Records <p/>
- *
- * @author Libin Roman (Vista Portal LDT. Developer)
- */
- public class ExternSheetRecord extends StandardRecord {
-
- public final static short sid = 0x0017;
- private List<RefSubRecord> _list;
-
- private static final class RefSubRecord {
- public static final int ENCODED_SIZE = 6;
-
- /** index to External Book Block (which starts with a EXTERNALBOOK record) */
- private int _extBookIndex;
- private int _firstSheetIndex; // may be -1 (0xFFFF)
- private int _lastSheetIndex; // may be -1 (0xFFFF)
-
- public void adjustIndex(int offset) {
- _firstSheetIndex += offset;
- _lastSheetIndex += offset;
- }
-
- /** a Constructor for making new sub record
- */
- public RefSubRecord(int extBookIndex, int firstSheetIndex, int lastSheetIndex) {
- _extBookIndex = extBookIndex;
- _firstSheetIndex = firstSheetIndex;
- _lastSheetIndex = lastSheetIndex;
- }
-
- /**
- * @param in the RecordInputstream to read the record from
- */
- public RefSubRecord(RecordInputStream in) {
- this(in.readShort(), in.readShort(), in.readShort());
- }
- public int getExtBookIndex(){
- return _extBookIndex;
- }
- public int getFirstSheetIndex(){
- return _firstSheetIndex;
- }
- public int getLastSheetIndex(){
- return _lastSheetIndex;
- }
-
- @Override
- public String toString() {
- StringBuffer buffer = new StringBuffer();
- buffer.append("extBook=").append(_extBookIndex);
- buffer.append(" firstSheet=").append(_firstSheetIndex);
- buffer.append(" lastSheet=").append(_lastSheetIndex);
- return buffer.toString();
- }
-
- public void serialize(LittleEndianOutput out) {
- out.writeShort(_extBookIndex);
- out.writeShort(_firstSheetIndex);
- out.writeShort(_lastSheetIndex);
- }
- }
-
-
-
- public ExternSheetRecord() {
- _list = new ArrayList<RefSubRecord>();
- }
-
- public ExternSheetRecord(RecordInputStream in) {
- _list = new ArrayList<RefSubRecord>();
-
- int nItems = in.readShort();
-
- for (int i = 0 ; i < nItems ; ++i) {
- RefSubRecord rec = new RefSubRecord(in);
- _list.add(rec);
- }
- }
-
-
- /**
- * @return number of REF structures
- */
- public int getNumOfRefs() {
- return _list.size();
- }
-
- /**
- * adds REF struct (ExternSheetSubRecord)
- * @param rec REF struct
- */
- public void addREFRecord(RefSubRecord rec) {
- _list.add(rec);
- }
-
- /** returns the number of REF Records, which is in model
- * @return number of REF records
- */
- public int getNumOfREFRecords() {
- return _list.size();
- }
-
-
- @Override
- public String toString() {
- StringBuffer sb = new StringBuffer();
- int nItems = _list.size();
- sb.append("[EXTERNSHEET]\n");
- sb.append(" numOfRefs = ").append(nItems).append("\n");
- for (int i=0; i < nItems; i++) {
- sb.append("refrec #").append(i).append(": ");
- sb.append(getRef(i).toString());
- sb.append('\n');
- }
- sb.append("[/EXTERNSHEET]\n");
-
-
- return sb.toString();
- }
-
- @Override
- protected int getDataSize() {
- return 2 + _list.size() * RefSubRecord.ENCODED_SIZE;
- }
-
- @Override
- public void serialize(LittleEndianOutput out) {
- int nItems = _list.size();
-
- out.writeShort(nItems);
-
- for (int i = 0; i < nItems; i++) {
- getRef(i).serialize(out);
- }
- }
-
- private RefSubRecord getRef(int i) {
- return _list.get(i);
- }
-
- public void adjustIndex(int extRefIndex, int offset) {
- getRef(extRefIndex).adjustIndex(offset);
- }
-
- /**
- * return the non static version of the id for this record.
- */
- @Override
- public short getSid() {
- return sid;
- }
-
- public int getExtbookIndexFromRefIndex(int refIndex) {
- return getRef(refIndex).getExtBookIndex();
- }
-
- /**
- * @return -1 if not found
- */
- public int findRefIndexFromExtBookIndex(int extBookIndex) {
- int nItems = _list.size();
- for (int i = 0; i < nItems; i++) {
- if (getRef(i).getExtBookIndex() == extBookIndex) {
- return i;
- }
- }
- return -1;
- }
-
- public int getFirstSheetIndexFromRefIndex(int extRefIndex) {
- return getRef(extRefIndex).getFirstSheetIndex();
- }
-
- /**
- * Add a zero-based reference to a {@link org.apache.poi.hssf.record.SupBookRecord}.
- * <p>
- * If the type of the SupBook record is same-sheet referencing, Add-In referencing,
- * DDE data source referencing, or OLE data source referencing,
- * then no scope is specified and this value <em>MUST</em> be -2. Otherwise,
- * the scope must be set as follows:
- * <ol>
- * <li><code>-2</code> Workbook-level reference that applies to the entire workbook.</li>
- * <li><code>-1</code> Sheet-level reference. </li>
- * <li><code>>=0</code> Sheet-level reference. This specifies the first sheet in the reference.
- * <p>
- * If the SupBook type is unused or external workbook referencing,
- * then this value specifies the zero-based index of an external sheet name,
- * see {@link org.apache.poi.hssf.record.SupBookRecord#getSheetNames()}.
- * This referenced string specifies the name of the first sheet within the external workbook that is in scope.
- * This sheet MUST be a worksheet or macro sheet.
- * <p>
- * <p>
- * If the supporting link type is self-referencing, then this value specifies the zero-based index of a
- * {@link org.apache.poi.hssf.record.BoundSheetRecord} record in the workbook stream that specifies
- * the first sheet within the scope of this reference. This sheet MUST be a worksheet or a macro sheet.
- * </p>
- * </li>
- * </ol>
- *
- * @param firstSheetIndex the scope, must be -2 for add-in references
- * @param lastSheetIndex the scope, must be -2 for add-in references
- * @return index of newly added ref
- */
- public int addRef(int extBookIndex, int firstSheetIndex, int lastSheetIndex) {
- _list.add(new RefSubRecord(extBookIndex, firstSheetIndex, lastSheetIndex));
- return _list.size() - 1;
- }
-
- public int getRefIxForSheet(int externalBookIndex, int sheetIndex) {
- int nItems = _list.size();
- for (int i = 0; i < nItems; i++) {
- RefSubRecord ref = getRef(i);
- if (ref.getExtBookIndex() != externalBookIndex) {
- continue;
- }
- if (ref.getFirstSheetIndex() == sheetIndex && ref.getLastSheetIndex() == sheetIndex) {
- return i;
- }
- }
- return -1;
- }
-
- public static ExternSheetRecord combine(ExternSheetRecord[] esrs) {
- ExternSheetRecord result = new ExternSheetRecord();
- for (int i = 0; i < esrs.length; i++) {
- ExternSheetRecord esr = esrs[i];
- int nRefs = esr.getNumOfREFRecords();
- for (int j=0; j<nRefs; j++) {
- result.addREFRecord(esr.getRef(j));
- }
- }
- return result;
- }
- }
|