jdk/src/share/classes/java/sql/BatchUpdateException.java
changeset 23590 ffd8b0b70511
parent 21278 ef8a3a2a72f2
child 25976 4de01a56e3ee
equal deleted inserted replaced
23589:05e692d15fcd 23590:ffd8b0b70511
   201    * The <code>reason</code>, <code>SQLState</code> and <code>updateCounts</code>
   201    * The <code>reason</code>, <code>SQLState</code> and <code>updateCounts</code>
   202    *  are initialized to <code>null</code> and the vendor code is initialized to 0.
   202    *  are initialized to <code>null</code> and the vendor code is initialized to 0.
   203    * The <code>cause</code> is not initialized, and may subsequently be
   203    * The <code>cause</code> is not initialized, and may subsequently be
   204    * initialized by a call to the
   204    * initialized by a call to the
   205    * {@link Throwable#initCause(java.lang.Throwable)} method.
   205    * {@link Throwable#initCause(java.lang.Throwable)} method.
   206    * <p>
       
   207    *
   206    *
   208    * @since 1.2
   207    * @since 1.2
   209    * @see #BatchUpdateException(java.lang.String, java.lang.String, int, long[],
   208    * @see #BatchUpdateException(java.lang.String, java.lang.String, int, long[],
   210    * java.lang.Throwable)
   209    * java.lang.Throwable)
   211    */
   210    */
   376    * fails to execute properly. If the driver continues processing commands,
   375    * fails to execute properly. If the driver continues processing commands,
   377    * the array returned by this method will have as many elements as
   376    * the array returned by this method will have as many elements as
   378    * there are commands in the batch; otherwise, it will contain an
   377    * there are commands in the batch; otherwise, it will contain an
   379    * update count for each command that executed successfully before
   378    * update count for each command that executed successfully before
   380    * the <code>BatchUpdateException</code> was thrown.
   379    * the <code>BatchUpdateException</code> was thrown.
   381    *<P>
   380    * <P>
   382    * The possible return values for this method were modified for
   381    * The possible return values for this method were modified for
   383    * the Java 2 SDK, Standard Edition, version 1.3.  This was done to
   382    * the Java 2 SDK, Standard Edition, version 1.3.  This was done to
   384    * accommodate the new option of continuing to process commands
   383    * accommodate the new option of continuing to process commands
   385    * in a batch update after a <code>BatchUpdateException</code> object
   384    * in a batch update after a <code>BatchUpdateException</code> object
   386    * has been thrown.
   385    * has been thrown.
   408    * a given <code>reason</code>, <code>SQLState</code>, <code>vendorCode</code>
   407    * a given <code>reason</code>, <code>SQLState</code>, <code>vendorCode</code>
   409    * <code>cause</code> and <code>updateCounts</code>.
   408    * <code>cause</code> and <code>updateCounts</code>.
   410    * <p>
   409    * <p>
   411    * This constructor should be used when the returned update count may exceed
   410    * This constructor should be used when the returned update count may exceed
   412    * {@link Integer#MAX_VALUE}.
   411    * {@link Integer#MAX_VALUE}.
   413    * <p>
   412    *
   414    * @param reason a description of the error
   413    * @param reason a description of the error
   415    * @param SQLState an XOPEN or SQL:2003 code identifying the exception
   414    * @param SQLState an XOPEN or SQL:2003 code identifying the exception
   416    * @param vendorCode an exception code used by a particular
   415    * @param vendorCode an exception code used by a particular
   417    * database vendor
   416    * database vendor
   418    * @param updateCounts an array of <code>long</code>, with each element
   417    * @param updateCounts an array of <code>long</code>, with each element
   446    * update count for each command that executed successfully before
   445    * update count for each command that executed successfully before
   447    * the <code>BatchUpdateException</code> was thrown.
   446    * the <code>BatchUpdateException</code> was thrown.
   448    * <p>
   447    * <p>
   449    * This method should be used when {@code Statement.executeLargeBatch} is
   448    * This method should be used when {@code Statement.executeLargeBatch} is
   450    * invoked and the returned update count may exceed {@link Integer#MAX_VALUE}.
   449    * invoked and the returned update count may exceed {@link Integer#MAX_VALUE}.
   451    * <p>
   450    *
   452    * @return an array of <code>long</code> containing the update counts
   451    * @return an array of <code>long</code> containing the update counts
   453    * for the updates that were executed successfully before this error
   452    * for the updates that were executed successfully before this error
   454    * occurred.  Or, if the driver continues to process commands after an
   453    * occurred.  Or, if the driver continues to process commands after an
   455    * error, one of the following for every command in the batch:
   454    * error, one of the following for every command in the batch:
   456    * <OL>
   455    * <OL>