jaxws/src/java.xml.ws/share/classes/com/sun/xml/internal/messaging/saaj/packaging/mime/util/ASCIIUtility.java

*** 1,7 ****
  /*
!  * Copyright (c) 1997, 2014, 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.  Oracle designates this
--- 1,7 ----
  /*
!  * Copyright (c) 1997, 2017, 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.  Oracle designates this
*** 41,53 ****
  
  
      /**
       * Convert the bytes within the specified range of the given byte
       * array into a signed integer in the given radix . The range extends
!      * from <code>start</code> till, but not including <code>end</code>. <p>
       *
-      * Based on java.lang.Integer.parseInt()
       */
      public static int parseInt(byte[] b, int start, int end, int radix)
                  throws NumberFormatException {
          if (b == null)
              throw new NumberFormatException("null");
--- 41,61 ----
  
  
      /**
       * Convert the bytes within the specified range of the given byte
       * array into a signed integer in the given radix . The range extends
!      * from <code>start</code> till, but not including <code>end</code>.
!      *
!      * Based on java.lang.Integer.parseInt().
!      *
!      * @param b bytes to convert to integer.
!      * @param start start of the range.
!      * @param end end of the range (not including).
!      * @param radix radix.
!      *
!      * @return integer.
       *
       */
      public static int parseInt(byte[] b, int start, int end, int radix)
                  throws NumberFormatException {
          if (b == null)
              throw new NumberFormatException("null");
*** 108,118 ****
      }
  
      /**
       * Convert the bytes within the specified range of the given byte
       * array into a String. The range extends from <code>start</code>
!      * till, but not including <code>end</code>. <p>
       */
      public static String toString(byte[] b, int start, int end) {
          int size = end - start;
          char[] theChars = new char[size];
  
--- 116,133 ----
      }
  
      /**
       * Convert the bytes within the specified range of the given byte
       * array into a String. The range extends from <code>start</code>
!      * till, but not including <code>end</code>.
!      *
!      * @param b bytes to convert to integer.
!      * @param start start of the range.
!      * @param end end of the range (not including).
!      *
!      * @return integer.
!      *
       */
      public static String toString(byte[] b, int start, int end) {
          int size = end - start;
          char[] theChars = new char[size];
  
*** 120,129 ****
--- 135,153 ----
              theChars[i++] = (char)(b[j++]&0xff);
  
          return new String(theChars);
      }
  
+         /**
+          * Encodes specified String into a sequence of bytes using the platform's
+          * default charset, storing the result into a new byte array.
+          *
+          * @param s string to encode into byte array.
+          *
+          * @return byte array.
+          *
+          */
      public static byte[] getBytes(String s) {
          char [] chars= s.toCharArray();
          int size = chars.length;
          byte[] bytes = new byte[size];
  
*** 131,147 ****
--- 155,179 ----
              bytes[i] = (byte) chars[i++];
          return bytes;
      }
  
      /**
+          * Converts input stream to array.
+          *
+          * @param is stream to convert to array.
+          *
+          * @return byte array.
+          *
+          * @throws IOException if an I/O error occurs.
       *
       * @deprecated
       *      this is an expensive operation that require an additional
       *      buffer reallocation just to get the array of an exact size.
       *      Unless you absolutely need the exact size array, don't use this.
       *      Use {@link ByteOutputStream} and {@link ByteOutputStream#write(InputStream)}.
       */
+     @Deprecated
      public static byte[] getBytes(InputStream is) throws IOException {
          ByteOutputStream bos = null;
          try {
              bos = new ByteOutputStream();
              bos.write(is);