278 lines
12 KiB
Java
278 lines
12 KiB
Java
/*
|
|
* Copyright (c) 2021, Oracle and/or its affiliates. All rights reserved.
|
|
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
|
*
|
|
* This code is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU General Public License version 2 only, as
|
|
* published by the Free Software Foundation.
|
|
*
|
|
* This code is distributed in the hope that it will be useful, but WITHOUT
|
|
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
* version 2 for more details (a copy is included in the LICENSE file that
|
|
* accompanied this code).
|
|
*
|
|
* You should have received a copy of the GNU General Public License version
|
|
* 2 along with this work; if not, write to the Free Software Foundation,
|
|
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
*
|
|
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
|
* or visit www.oracle.com if you need additional information or have any
|
|
* questions.
|
|
*/
|
|
|
|
import java.io.ByteArrayInputStream;
|
|
import java.io.ByteArrayOutputStream;
|
|
import java.io.IOException;
|
|
import java.io.InputStream;
|
|
import java.io.OutputStream;
|
|
import java.nio.channels.Channels;
|
|
import java.nio.channels.FileChannel;
|
|
import java.nio.file.Files;
|
|
import java.nio.file.Path;
|
|
import java.nio.file.StandardOpenOption;
|
|
import java.util.Arrays;
|
|
import java.util.Random;
|
|
import java.util.concurrent.atomic.AtomicReference;
|
|
import java.util.function.Consumer;
|
|
import java.util.function.Supplier;
|
|
|
|
import org.testng.annotations.DataProvider;
|
|
import org.testng.annotations.Test;
|
|
|
|
import jdk.test.lib.RandomFactory;
|
|
|
|
import static java.lang.String.format;
|
|
|
|
import static org.testng.Assert.assertEquals;
|
|
import static org.testng.Assert.assertThrows;
|
|
import static org.testng.Assert.assertTrue;
|
|
|
|
/*
|
|
* @test
|
|
* @library /test/lib
|
|
* @build jdk.test.lib.RandomFactory
|
|
* @run testng TransferTo
|
|
* @bug 8265891
|
|
* @summary tests whether sun.nio.ChannelInputStream.transferTo conforms to the
|
|
* InputStream.transferTo contract defined in the javadoc
|
|
* @key randomness
|
|
*/
|
|
public class TransferTo {
|
|
private static final int MIN_SIZE = 10_000;
|
|
private static final int MAX_SIZE_INCR = 100_000_000 - MIN_SIZE;
|
|
|
|
private static final int ITERATIONS = 10;
|
|
|
|
private static final int NUM_WRITES = 3 * 1024;
|
|
private static final int BYTES_PER_WRITE = 1024 * 1024;
|
|
private static final long BYTES_WRITTEN = (long) NUM_WRITES * BYTES_PER_WRITE;
|
|
|
|
private static final Random RND = RandomFactory.getRandom();
|
|
|
|
/*
|
|
* Provides test scenarios, i. e. combinations of input and output streams to be tested.
|
|
*/
|
|
@DataProvider
|
|
public static Object[][] streamCombinations() throws Exception {
|
|
return new Object[][] {
|
|
// tests FileChannel.transferTo(FileChannel) optimized case
|
|
{ fileChannelInput(), fileChannelOutput() },
|
|
|
|
// tests InputStream.transferTo(OutputStream) default case
|
|
{ readableByteChannelInput(), defaultOutput() }
|
|
};
|
|
}
|
|
|
|
/*
|
|
* Testing API compliance: Input stream must throw NullPointerException when parameter "out" is null.
|
|
*/
|
|
@Test(dataProvider = "streamCombinations")
|
|
public void testNullPointerException(InputStreamProvider inputStreamProvider,
|
|
OutputStreamProvider outputStreamProvider) throws Exception {
|
|
// tests empty input stream
|
|
assertThrows(NullPointerException.class, () -> inputStreamProvider.input().transferTo(null));
|
|
|
|
// tests single-byte input stream
|
|
assertThrows(NullPointerException.class, () -> inputStreamProvider.input((byte) 1).transferTo(null));
|
|
|
|
// tests dual-byte input stream
|
|
assertThrows(NullPointerException.class, () -> inputStreamProvider.input((byte) 1, (byte) 2).transferTo(null));
|
|
}
|
|
|
|
/*
|
|
* Testing API compliance: Complete content of input stream must be transferred to output stream.
|
|
*/
|
|
@Test(dataProvider = "streamCombinations")
|
|
public void testStreamContents(InputStreamProvider inputStreamProvider,
|
|
OutputStreamProvider outputStreamProvider) throws Exception {
|
|
// tests empty input stream
|
|
checkTransferredContents(inputStreamProvider, outputStreamProvider, new byte[0]);
|
|
|
|
// tests input stream with a length between 1k and 4k
|
|
checkTransferredContents(inputStreamProvider, outputStreamProvider, createRandomBytes(1024, 4096));
|
|
|
|
// tests input stream with several data chunks, as 16k is more than a single chunk can hold
|
|
checkTransferredContents(inputStreamProvider, outputStreamProvider, createRandomBytes(16384, 16384));
|
|
|
|
// tests randomly chosen starting positions within source and target stream
|
|
for (int i = 0; i < ITERATIONS; i++) {
|
|
byte[] inBytes = createRandomBytes(MIN_SIZE, MAX_SIZE_INCR);
|
|
int posIn = RND.nextInt(inBytes.length);
|
|
int posOut = RND.nextInt(MIN_SIZE);
|
|
checkTransferredContents(inputStreamProvider, outputStreamProvider, inBytes, posIn, posOut);
|
|
}
|
|
|
|
// tests reading beyond source EOF (must not transfer any bytes)
|
|
checkTransferredContents(inputStreamProvider, outputStreamProvider, createRandomBytes(4096, 0), 4096, 0);
|
|
|
|
// tests writing beyond target EOF (must extend output stream)
|
|
checkTransferredContents(inputStreamProvider, outputStreamProvider, createRandomBytes(4096, 0), 0, 4096);
|
|
}
|
|
|
|
/*
|
|
* Special test for file-to-file transfer of more than two GB.
|
|
* This test covers multiple iterations of FileChannel.transerTo(FileChannel),
|
|
* which ChannelInputStream.transferTo() only applies in this particular case,
|
|
* and cannot get tested using a single byte[] due to size limitation of arrays.
|
|
*/
|
|
@Test
|
|
public void testMoreThanTwoGB() throws IOException {
|
|
// preparing two temporary files which will be compared at the end of the test
|
|
Path sourceFile = Files.createTempFile(null, null);
|
|
Path targetFile = Files.createTempFile(null, null);
|
|
|
|
// writing 3 GB of random bytes into source file
|
|
for (int i = 0; i < NUM_WRITES; i++)
|
|
Files.write(sourceFile, createRandomBytes(BYTES_PER_WRITE, 0), StandardOpenOption.APPEND);
|
|
|
|
// performing actual transfer, effectively by multiple invocations of Filechannel.transferTo(FileChannel)
|
|
long count;
|
|
try (InputStream inputStream = Channels.newInputStream(FileChannel.open(sourceFile));
|
|
OutputStream outputStream = Channels
|
|
.newOutputStream(FileChannel.open(targetFile, StandardOpenOption.WRITE))) {
|
|
count = inputStream.transferTo(outputStream);
|
|
}
|
|
|
|
// comparing reported transferred bytes, must be 3 GB
|
|
assertEquals(count, BYTES_WRITTEN);
|
|
|
|
// comparing content of both files, failing in case of any difference
|
|
assertEquals(Files.mismatch(sourceFile, targetFile), -1);
|
|
}
|
|
|
|
/*
|
|
* Asserts that the transferred content is correct, i. e. compares the actually transferred bytes
|
|
* to the expected assumption. The position of the input and output stream before the transfer is
|
|
* the start of stream (BOF).
|
|
*/
|
|
private static void checkTransferredContents(InputStreamProvider inputStreamProvider,
|
|
OutputStreamProvider outputStreamProvider, byte[] inBytes) throws Exception {
|
|
checkTransferredContents(inputStreamProvider, outputStreamProvider, inBytes, 0, 0);
|
|
}
|
|
|
|
/*
|
|
* Asserts that the transferred content is correct, i. e. compares the actually transferred bytes
|
|
* to the expected assumption. The position of the input and output stream before the transfer is
|
|
* provided by the caller.
|
|
*/
|
|
private static void checkTransferredContents(InputStreamProvider inputStreamProvider,
|
|
OutputStreamProvider outputStreamProvider, byte[] inBytes, int posIn, int posOut) throws Exception {
|
|
AtomicReference<Supplier<byte[]>> recorder = new AtomicReference<>();
|
|
try (InputStream in = inputStreamProvider.input(inBytes);
|
|
OutputStream out = outputStreamProvider.output(recorder::set)) {
|
|
// skip bytes till starting position
|
|
in.skipNBytes(posIn);
|
|
out.write(new byte[posOut]);
|
|
|
|
long reported = in.transferTo(out);
|
|
int count = inBytes.length - posIn;
|
|
|
|
assertEquals(reported, count, format("reported %d bytes but should report %d", reported, count));
|
|
|
|
byte[] outBytes = recorder.get().get();
|
|
assertTrue(Arrays.equals(inBytes, posIn, posIn + count, outBytes, posOut, posOut + count),
|
|
format("inBytes.length=%d, outBytes.length=%d", count, outBytes.length));
|
|
}
|
|
}
|
|
|
|
/*
|
|
* Creates an array of random size (between min and min + maxRandomAdditive) filled with random bytes
|
|
*/
|
|
private static byte[] createRandomBytes(int min, int maxRandomAdditive) {
|
|
byte[] bytes = new byte[min + (maxRandomAdditive == 0 ? 0 : RND.nextInt(maxRandomAdditive))];
|
|
RND.nextBytes(bytes);
|
|
return bytes;
|
|
}
|
|
|
|
private interface InputStreamProvider {
|
|
InputStream input(byte... bytes) throws Exception;
|
|
}
|
|
|
|
private interface OutputStreamProvider {
|
|
OutputStream output(Consumer<Supplier<byte[]>> spy) throws Exception;
|
|
}
|
|
|
|
/*
|
|
* Creates a provider for an output stream which does not wrap a channel
|
|
*/
|
|
private static OutputStreamProvider defaultOutput() {
|
|
return new OutputStreamProvider() {
|
|
@Override
|
|
public OutputStream output(Consumer<Supplier<byte[]>> spy) {
|
|
ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
|
|
spy.accept(outputStream::toByteArray);
|
|
return outputStream;
|
|
}
|
|
};
|
|
}
|
|
|
|
/*
|
|
* Creates a provider for an input stream which wraps a file channel
|
|
*/
|
|
private static InputStreamProvider fileChannelInput() {
|
|
return new InputStreamProvider() {
|
|
@Override
|
|
public InputStream input(byte... bytes) throws Exception {
|
|
Path path = Files.createTempFile(null, null);
|
|
Files.write(path, bytes);
|
|
FileChannel fileChannel = FileChannel.open(path);
|
|
return Channels.newInputStream(fileChannel);
|
|
}
|
|
};
|
|
}
|
|
|
|
/*
|
|
* Creates a provider for an input stream which wraps a readable byte channel but is not a file channel
|
|
*/
|
|
private static InputStreamProvider readableByteChannelInput() {
|
|
return new InputStreamProvider() {
|
|
@Override
|
|
public InputStream input(byte... bytes) throws Exception {
|
|
return Channels.newInputStream(Channels.newChannel(new ByteArrayInputStream(bytes)));
|
|
}
|
|
};
|
|
}
|
|
|
|
/*
|
|
* Creates a provider for an output stream which wraps a file channel
|
|
*/
|
|
private static OutputStreamProvider fileChannelOutput() {
|
|
return new OutputStreamProvider() {
|
|
public OutputStream output(Consumer<Supplier<byte[]>> spy) throws Exception {
|
|
Path path = Files.createTempFile(null, null);
|
|
FileChannel fileChannel = FileChannel.open(path, StandardOpenOption.WRITE);
|
|
spy.accept(() -> {
|
|
try {
|
|
return Files.readAllBytes(path);
|
|
} catch (IOException e) {
|
|
throw new AssertionError("Failed to verify output file", e);
|
|
}
|
|
});
|
|
return Channels.newOutputStream(fileChannel);
|
|
}
|
|
};
|
|
}
|
|
|
|
}
|