Browse Source

Polishing

pull/28850/head
Sam Brannen 2 years ago
parent
commit
ea27206a32
  1. 2
      spring-core/src/main/java/org/springframework/core/ResolvableType.java
  2. 24
      spring-core/src/main/java/org/springframework/util/FastByteArrayOutputStream.java

2
spring-core/src/main/java/org/springframework/core/ResolvableType.java

@ -1012,7 +1012,7 @@ public class ResolvableType implements Serializable { @@ -1012,7 +1012,7 @@ public class ResolvableType implements Serializable {
/**
* Return a {@link ResolvableType} for the specified {@link Class},
* doing assignability checks against the raw class only (analogous to
* {@link Class#isAssignableFrom}), which this serves as a wrapper for.
* {@link Class#isAssignableFrom}, which this serves as a wrapper for).
* <p>For example: {@code ResolvableType.forRawClass(List.class)}.
* @param clazz the class to introspect ({@code null} is semantically
* equivalent to {@code Object.class} for typical use cases here)

24
spring-core/src/main/java/org/springframework/util/FastByteArrayOutputStream.java

@ -1,5 +1,5 @@ @@ -1,5 +1,5 @@
/*
* Copyright 2002-2020 the original author or authors.
* Copyright 2002-2022 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
@ -32,11 +32,11 @@ import org.springframework.lang.Nullable; @@ -32,11 +32,11 @@ import org.springframework.lang.Nullable;
* its sibling {@link ResizableByteArrayOutputStream}.
*
* <p>Unlike {@link java.io.ByteArrayOutputStream}, this implementation is backed
* by an {@link java.util.ArrayDeque} of {@code byte[]} instead of 1 constantly
* by a {@link java.util.ArrayDeque} of {@code byte[]} instead of 1 constantly
* resizing {@code byte[]}. It does not copy buffers when it gets expanded.
*
* <p>The initial buffer is only created when the stream is first written.
* There is also no copying of the internal buffer if its contents is extracted
* There is also no copying of the internal buffer if its content is extracted
* with the {@link #writeTo(OutputStream)} method.
*
* @author Craig Andrews
@ -177,10 +177,11 @@ public class FastByteArrayOutputStream extends OutputStream { @@ -177,10 +177,11 @@ public class FastByteArrayOutputStream extends OutputStream {
/**
* Convert the stream's data to a byte array and return the byte array.
* <p>Also replaces the internal structures with the byte array to conserve memory:
* if the byte array is being made anyway, mind as well as use it. This approach
* also means that if this method is called twice without any writes in between,
* the second call is a no-op.
* <p>Also replaces the internal structures with the byte array to
* conserve memory: if the byte array is being created anyway, we might
* as well as use it. This approach also means that if this method is
* called twice without any writes in the interim, the second call is
* a no-op.
* <p>This method is "unsafe" as it returns the internal buffer.
* Callers should not modify the returned buffer.
* @return the current contents of this output stream, as a byte array.
@ -197,11 +198,10 @@ public class FastByteArrayOutputStream extends OutputStream { @@ -197,11 +198,10 @@ public class FastByteArrayOutputStream extends OutputStream {
}
/**
* Creates a newly allocated byte array.
* <p>Its size is the current
* size of this output stream and the valid contents of the buffer
* have been copied into it.</p>
* @return the current contents of this output stream, as a byte array.
* Create a newly allocated byte array.
* <p>Its size is the current size of this output stream, and it will
* contain the valid contents of the internal buffer.
* @return the current contents of this output stream, as a byte array
* @see #size()
* @see #toByteArrayUnsafe()
*/

Loading…
Cancel
Save