123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687 |
- /* ====================================================================
- 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.util;
-
- import java.util.ArrayList;
- import java.util.List;
-
- /**
- * Utility for delaying the concatenation of multiple byte arrays. Doing this up-front
- * causes significantly more copying, which for a large number of byte arrays can cost
- * a large amount of time.
- */
- public class LazilyConcatenatedByteArray {
- private final List<byte[]> arrays = new ArrayList<>(1);
-
- /**
- * Clears the array (sets the concatenated length back to zero.
- */
- public void clear() {
- arrays.clear();
- }
-
- /**
- * Concatenates an array onto the end of our array.
- * This is a relatively fast operation.
- *
- * @param array the array to concatenate.
- * @throws IllegalArgumentException if {@code array} is {@code null}.
- */
- public void concatenate(byte[] array) {
- if (array == null) {
- throw new IllegalArgumentException("array cannot be null");
- }
- arrays.add(array);
- }
-
- public void concatenate(LazilyConcatenatedByteArray other) {
- arrays.addAll(other.arrays);
- }
-
- /**
- * Gets the concatenated contents as a single byte array.
- *
- * This is a slower operation, but the concatenated array is stored off as a single
- * array again so that subsequent calls will not perform additional copying.
- *
- * @return the byte array. Returns {@code null} if no data has been placed into it.
- */
- public byte[] toArray() {
- if (arrays.isEmpty()) {
- return null;
- } else if (arrays.size() > 1) {
- int totalLength = 0;
- for (byte[] array : arrays) {
- totalLength += array.length;
- }
-
- byte[] concatenated = new byte[totalLength];
- int destPos = 0;
- for (byte[] array : arrays) {
- System.arraycopy(array, 0, concatenated, destPos, array.length);
- destPos += array.length;
- }
-
- arrays.clear();
- arrays.add(concatenated);
- }
-
- return arrays.get(0);
- }
- }
|