Javadoc

Author: garydgregory

src/main/java/org/apache/commons/io/input/XmlStreamReader.java

@@ -340,7 +340,7 @@ static boolean isTextXml(final String mime) {
      * @param file File to create a Reader from.
      * @throws NullPointerException if the input is {@code null}.
      * @throws IOException thrown if there is a problem reading the file.
-     * @deprecated Use {@link #builder()}
+     * @deprecated Use {@link #builder()} and {@link Builder#get()}
      */
     @Deprecated
     public XmlStreamReader(final File file) throws IOException {
@@ -359,7 +359,7 @@ public XmlStreamReader(final File file) throws IOException {
      * @param inputStream InputStream to create a Reader from.
      * @throws NullPointerException if the input stream is {@code null}.
      * @throws IOException thrown if there is a problem reading the stream.
-     * @deprecated Use {@link #builder()}
+     * @deprecated Use {@link #builder()} and {@link Builder#get()}
      */
     @Deprecated
     public XmlStreamReader(final InputStream inputStream) throws IOException {
@@ -395,7 +395,7 @@ public XmlStreamReader(final InputStream inputStream) throws IOException {
      * @throws NullPointerException if the input stream is {@code null}.
      * @throws IOException              thrown if there is a problem reading the stream.
      * @throws XmlStreamReaderException thrown if the charset encoding could not be determined according to the specs.
-     * @deprecated Use {@link #builder()}
+     * @deprecated Use {@link #builder()} and {@link Builder#get()}
      */
     @Deprecated
     public XmlStreamReader(final InputStream inputStream, final boolean lenient) throws IOException {
@@ -432,7 +432,7 @@ public XmlStreamReader(final InputStream inputStream, final boolean lenient) thr
      * @throws NullPointerException if the input stream is {@code null}.
      * @throws IOException              thrown if there is a problem reading the stream.
      * @throws XmlStreamReaderException thrown if the charset encoding could not be determined according to the specs.
-     * @deprecated Use {@link #builder()}
+     * @deprecated Use {@link #builder()} and {@link Builder#get()}
      */
     @Deprecated
     @SuppressWarnings("resource") // InputStream is managed through a InputStreamReader in this instance.
@@ -459,7 +459,7 @@ public XmlStreamReader(final InputStream inputStream, final boolean lenient, fin
      * @param httpContentType content-type header to use for the resolution of the charset encoding.
      * @throws NullPointerException if the input stream is {@code null}.
      * @throws IOException thrown if there is a problem reading the file.
-     * @deprecated Use {@link #builder()}
+     * @deprecated Use {@link #builder()} and {@link Builder#get()}
      */
     @Deprecated
     public XmlStreamReader(final InputStream inputStream, final String httpContentType) throws IOException {
@@ -497,7 +497,7 @@ public XmlStreamReader(final InputStream inputStream, final String httpContentTy
      * @throws NullPointerException if the input stream is {@code null}.
      * @throws IOException              thrown if there is a problem reading the file.
      * @throws XmlStreamReaderException thrown if the charset encoding could not be determined according to the specification.
-     * @deprecated Use {@link #builder()}
+     * @deprecated Use {@link #builder()} and {@link Builder#get()}
      */
     @Deprecated
     public XmlStreamReader(final InputStream inputStream, final String httpContentType, final boolean lenient) throws IOException {
@@ -536,7 +536,7 @@ public XmlStreamReader(final InputStream inputStream, final String httpContentTy
      * @throws NullPointerException if the input stream is {@code null}.
      * @throws IOException              thrown if there is a problem reading the file.
      * @throws XmlStreamReaderException thrown if the charset encoding could not be determined according to the specification.
-     * @deprecated Use {@link #builder()}
+     * @deprecated Use {@link #builder()} and {@link Builder#get()}
      */
     @Deprecated
     @SuppressWarnings("resource") // InputStream is managed through a InputStreamReader in this instance.
@@ -563,7 +563,7 @@ public XmlStreamReader(final InputStream inputStream, final String httpContentTy
      * @throws NullPointerException if the input is {@code null}.
      * @throws IOException thrown if there is a problem reading the file.
      * @since 2.11.0
-     * @deprecated Use {@link #builder()}
+     * @deprecated Use {@link #builder()} and {@link Builder#get()}
      */
     @Deprecated
     @SuppressWarnings("resource") // InputStream is managed through another reader in this instance.