jdk/src/share/classes/java/nio/channels/exceptions
author alanb
Sun, 15 Feb 2009 12:25:54 +0000
changeset 2057 3acf8e5e2ca0
parent 1247 b4c26443dee5
child 3632 399359a027de
permissions -rw-r--r--
6781363: New I/O: Update socket-channel API to jsr203/nio2-b99 4313887: New I/O: Improved filesystem interface 4607272: New I/O: Support asynchronous I/O Reviewed-by: sherman, chegar
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
     1
#
2057
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
     2
# Copyright 2000-2009 Sun Microsystems, Inc.  All Rights Reserved.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
     3
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
90ce3da70b43 Initial load
duke
parents:
diff changeset
     4
#
90ce3da70b43 Initial load
duke
parents:
diff changeset
     5
# This code is free software; you can redistribute it and/or modify it
90ce3da70b43 Initial load
duke
parents:
diff changeset
     6
# under the terms of the GNU General Public License version 2 only, as
90ce3da70b43 Initial load
duke
parents:
diff changeset
     7
# published by the Free Software Foundation.  Sun designates this
90ce3da70b43 Initial load
duke
parents:
diff changeset
     8
# particular file as subject to the "Classpath" exception as provided
90ce3da70b43 Initial load
duke
parents:
diff changeset
     9
# by Sun in the LICENSE file that accompanied this code.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    10
#
90ce3da70b43 Initial load
duke
parents:
diff changeset
    11
# This code is distributed in the hope that it will be useful, but WITHOUT
90ce3da70b43 Initial load
duke
parents:
diff changeset
    12
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
90ce3da70b43 Initial load
duke
parents:
diff changeset
    13
# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
90ce3da70b43 Initial load
duke
parents:
diff changeset
    14
# version 2 for more details (a copy is included in the LICENSE file that
90ce3da70b43 Initial load
duke
parents:
diff changeset
    15
# accompanied this code).
90ce3da70b43 Initial load
duke
parents:
diff changeset
    16
#
90ce3da70b43 Initial load
duke
parents:
diff changeset
    17
# You should have received a copy of the GNU General Public License version
90ce3da70b43 Initial load
duke
parents:
diff changeset
    18
# 2 along with this work; if not, write to the Free Software Foundation,
90ce3da70b43 Initial load
duke
parents:
diff changeset
    19
# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    20
#
90ce3da70b43 Initial load
duke
parents:
diff changeset
    21
# Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
90ce3da70b43 Initial load
duke
parents:
diff changeset
    22
# CA 95054 USA or visit www.sun.com if you need additional information or
90ce3da70b43 Initial load
duke
parents:
diff changeset
    23
# have any questions.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    24
#
90ce3da70b43 Initial load
duke
parents:
diff changeset
    25
90ce3da70b43 Initial load
duke
parents:
diff changeset
    26
# Generated exception classes for java.nio.channels
90ce3da70b43 Initial load
duke
parents:
diff changeset
    27
90ce3da70b43 Initial load
duke
parents:
diff changeset
    28
SINCE=1.4
90ce3da70b43 Initial load
duke
parents:
diff changeset
    29
PACKAGE=java.nio.channels
90ce3da70b43 Initial load
duke
parents:
diff changeset
    30
# This year should only change if the generated source is modified.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    31
COPYRIGHT_YEARS=2000-2007
90ce3da70b43 Initial load
duke
parents:
diff changeset
    32
90ce3da70b43 Initial load
duke
parents:
diff changeset
    33
90ce3da70b43 Initial load
duke
parents:
diff changeset
    34
SUPER=java.io.IOException
90ce3da70b43 Initial load
duke
parents:
diff changeset
    35
90ce3da70b43 Initial load
duke
parents:
diff changeset
    36
gen ClosedChannelException "
90ce3da70b43 Initial load
duke
parents:
diff changeset
    37
 * Checked exception thrown when an attempt is made to invoke or complete an
90ce3da70b43 Initial load
duke
parents:
diff changeset
    38
 * I/O operation upon channel that is closed, or at least closed to that
90ce3da70b43 Initial load
duke
parents:
diff changeset
    39
 * operation.  That this exception is thrown does not necessarily imply that
90ce3da70b43 Initial load
duke
parents:
diff changeset
    40
 * the channel is completely closed.  A socket channel whose write half has
90ce3da70b43 Initial load
duke
parents:
diff changeset
    41
 * been shut down, for example, may still be open for reading." \
90ce3da70b43 Initial load
duke
parents:
diff changeset
    42
 882777185433553857L
90ce3da70b43 Initial load
duke
parents:
diff changeset
    43
90ce3da70b43 Initial load
duke
parents:
diff changeset
    44
gen FileLockInterruptionException "
90ce3da70b43 Initial load
duke
parents:
diff changeset
    45
 * Checked exception received by a thread when another thread interrupts it
90ce3da70b43 Initial load
duke
parents:
diff changeset
    46
 * while it is waiting to acquire a file lock.  Before this exception is thrown
90ce3da70b43 Initial load
duke
parents:
diff changeset
    47
 * the interrupt status of the previously-blocked thread will have been set." \
90ce3da70b43 Initial load
duke
parents:
diff changeset
    48
 7104080643653532383L
90ce3da70b43 Initial load
duke
parents:
diff changeset
    49
90ce3da70b43 Initial load
duke
parents:
diff changeset
    50
90ce3da70b43 Initial load
duke
parents:
diff changeset
    51
SUPER=ClosedChannelException
90ce3da70b43 Initial load
duke
parents:
diff changeset
    52
90ce3da70b43 Initial load
duke
parents:
diff changeset
    53
gen AsynchronousCloseException "
90ce3da70b43 Initial load
duke
parents:
diff changeset
    54
 * Checked exception received by a thread when another thread closes the
90ce3da70b43 Initial load
duke
parents:
diff changeset
    55
 * channel or the part of the channel upon which it is blocked in an I/O
90ce3da70b43 Initial load
duke
parents:
diff changeset
    56
 * operation." \
90ce3da70b43 Initial load
duke
parents:
diff changeset
    57
 6891178312432313966L
90ce3da70b43 Initial load
duke
parents:
diff changeset
    58
90ce3da70b43 Initial load
duke
parents:
diff changeset
    59
90ce3da70b43 Initial load
duke
parents:
diff changeset
    60
SUPER=AsynchronousCloseException
90ce3da70b43 Initial load
duke
parents:
diff changeset
    61
90ce3da70b43 Initial load
duke
parents:
diff changeset
    62
gen ClosedByInterruptException "
90ce3da70b43 Initial load
duke
parents:
diff changeset
    63
 * Checked exception received by a thread when another thread interrupts it
90ce3da70b43 Initial load
duke
parents:
diff changeset
    64
 * while it is blocked in an I/O operation upon a channel.  Before this
90ce3da70b43 Initial load
duke
parents:
diff changeset
    65
 * exception is thrown the channel will have been closed and the interrupt
90ce3da70b43 Initial load
duke
parents:
diff changeset
    66
 * status of the previously-blocked thread will have been set." \
90ce3da70b43 Initial load
duke
parents:
diff changeset
    67
 -4488191543534286750L
90ce3da70b43 Initial load
duke
parents:
diff changeset
    68
90ce3da70b43 Initial load
duke
parents:
diff changeset
    69
90ce3da70b43 Initial load
duke
parents:
diff changeset
    70
SUPER=IllegalArgumentException
90ce3da70b43 Initial load
duke
parents:
diff changeset
    71
90ce3da70b43 Initial load
duke
parents:
diff changeset
    72
gen IllegalSelectorException "
90ce3da70b43 Initial load
duke
parents:
diff changeset
    73
 * Unchecked exception thrown when an attempt is made to register a channel
90ce3da70b43 Initial load
duke
parents:
diff changeset
    74
 * with a selector that was not created by the provider that created the
90ce3da70b43 Initial load
duke
parents:
diff changeset
    75
 * channel." \
90ce3da70b43 Initial load
duke
parents:
diff changeset
    76
 -8406323347253320987L
90ce3da70b43 Initial load
duke
parents:
diff changeset
    77
90ce3da70b43 Initial load
duke
parents:
diff changeset
    78
gen UnresolvedAddressException "
90ce3da70b43 Initial load
duke
parents:
diff changeset
    79
 * Unchecked exception thrown when an attempt is made to invoke a network
90ce3da70b43 Initial load
duke
parents:
diff changeset
    80
 * operation upon an unresolved socket address." \
90ce3da70b43 Initial load
duke
parents:
diff changeset
    81
 6136959093620794148L
90ce3da70b43 Initial load
duke
parents:
diff changeset
    82
90ce3da70b43 Initial load
duke
parents:
diff changeset
    83
gen UnsupportedAddressTypeException "
90ce3da70b43 Initial load
duke
parents:
diff changeset
    84
 * Unchecked exception thrown when an attempt is made to bind or connect
90ce3da70b43 Initial load
duke
parents:
diff changeset
    85
 * to a socket address of a type that is not supported." \
90ce3da70b43 Initial load
duke
parents:
diff changeset
    86
 -2964323842829700493L
90ce3da70b43 Initial load
duke
parents:
diff changeset
    87
90ce3da70b43 Initial load
duke
parents:
diff changeset
    88
90ce3da70b43 Initial load
duke
parents:
diff changeset
    89
SUPER=IllegalStateException
90ce3da70b43 Initial load
duke
parents:
diff changeset
    90
90ce3da70b43 Initial load
duke
parents:
diff changeset
    91
gen AlreadyConnectedException "
90ce3da70b43 Initial load
duke
parents:
diff changeset
    92
 * Unchecked exception thrown when an attempt is made to connect a {@link
90ce3da70b43 Initial load
duke
parents:
diff changeset
    93
 * SocketChannel} that is already connected." \
90ce3da70b43 Initial load
duke
parents:
diff changeset
    94
 -7331895245053773357L
90ce3da70b43 Initial load
duke
parents:
diff changeset
    95
90ce3da70b43 Initial load
duke
parents:
diff changeset
    96
gen ConnectionPendingException "
90ce3da70b43 Initial load
duke
parents:
diff changeset
    97
 * Unchecked exception thrown when an attempt is made to connect a {@link
90ce3da70b43 Initial load
duke
parents:
diff changeset
    98
 * SocketChannel} for which a non-blocking connection operation is already in
90ce3da70b43 Initial load
duke
parents:
diff changeset
    99
 * progress." \
90ce3da70b43 Initial load
duke
parents:
diff changeset
   100
 2008393366501760879L
90ce3da70b43 Initial load
duke
parents:
diff changeset
   101
90ce3da70b43 Initial load
duke
parents:
diff changeset
   102
gen ClosedSelectorException "
90ce3da70b43 Initial load
duke
parents:
diff changeset
   103
 * Unchecked exception thrown when an attempt is made to invoke an I/O
90ce3da70b43 Initial load
duke
parents:
diff changeset
   104
 * operation upon a closed selector." \
90ce3da70b43 Initial load
duke
parents:
diff changeset
   105
 6466297122317847835L
90ce3da70b43 Initial load
duke
parents:
diff changeset
   106
90ce3da70b43 Initial load
duke
parents:
diff changeset
   107
gen CancelledKeyException "
90ce3da70b43 Initial load
duke
parents:
diff changeset
   108
 * Unchecked exception thrown when an attempt is made to use
90ce3da70b43 Initial load
duke
parents:
diff changeset
   109
 * a selection key that is no longer valid." \
90ce3da70b43 Initial load
duke
parents:
diff changeset
   110
 -8438032138028814268L
90ce3da70b43 Initial load
duke
parents:
diff changeset
   111
90ce3da70b43 Initial load
duke
parents:
diff changeset
   112
gen IllegalBlockingModeException "
90ce3da70b43 Initial load
duke
parents:
diff changeset
   113
 * Unchecked exception thrown when a blocking-mode-specific operation
90ce3da70b43 Initial load
duke
parents:
diff changeset
   114
 * is invoked upon a channel in the incorrect blocking mode." \
90ce3da70b43 Initial load
duke
parents:
diff changeset
   115
 -3335774961855590474L
90ce3da70b43 Initial load
duke
parents:
diff changeset
   116
90ce3da70b43 Initial load
duke
parents:
diff changeset
   117
gen NoConnectionPendingException "
90ce3da70b43 Initial load
duke
parents:
diff changeset
   118
 * Unchecked exception thrown when the {@link SocketChannel#finishConnect
90ce3da70b43 Initial load
duke
parents:
diff changeset
   119
 * finishConnect} method of a {@link SocketChannel} is invoked without first
90ce3da70b43 Initial load
duke
parents:
diff changeset
   120
 * successfully invoking its {@link SocketChannel#connect connect} method." \
90ce3da70b43 Initial load
duke
parents:
diff changeset
   121
 -8296561183633134743L
90ce3da70b43 Initial load
duke
parents:
diff changeset
   122
90ce3da70b43 Initial load
duke
parents:
diff changeset
   123
gen NonReadableChannelException "
90ce3da70b43 Initial load
duke
parents:
diff changeset
   124
 * Unchecked exception thrown when an attempt is made to read
90ce3da70b43 Initial load
duke
parents:
diff changeset
   125
 * from a channel that was not originally opened for reading." \
90ce3da70b43 Initial load
duke
parents:
diff changeset
   126
 -3200915679294993514L
90ce3da70b43 Initial load
duke
parents:
diff changeset
   127
90ce3da70b43 Initial load
duke
parents:
diff changeset
   128
gen NonWritableChannelException "
90ce3da70b43 Initial load
duke
parents:
diff changeset
   129
 * Unchecked exception thrown when an attempt is made to write
90ce3da70b43 Initial load
duke
parents:
diff changeset
   130
 * to a channel that was not originally opened for writing." \
90ce3da70b43 Initial load
duke
parents:
diff changeset
   131
 -7071230488279011621L
90ce3da70b43 Initial load
duke
parents:
diff changeset
   132
90ce3da70b43 Initial load
duke
parents:
diff changeset
   133
gen NotYetBoundException "
90ce3da70b43 Initial load
duke
parents:
diff changeset
   134
 * Unchecked exception thrown when an attempt is made to invoke an I/O
90ce3da70b43 Initial load
duke
parents:
diff changeset
   135
 * operation upon a server socket channel that is not yet bound." \
90ce3da70b43 Initial load
duke
parents:
diff changeset
   136
 4640999303950202242L
90ce3da70b43 Initial load
duke
parents:
diff changeset
   137
90ce3da70b43 Initial load
duke
parents:
diff changeset
   138
gen NotYetConnectedException "
90ce3da70b43 Initial load
duke
parents:
diff changeset
   139
 * Unchecked exception thrown when an attempt is made to invoke an I/O
90ce3da70b43 Initial load
duke
parents:
diff changeset
   140
 * operation upon a socket channel that is not yet connected." \
90ce3da70b43 Initial load
duke
parents:
diff changeset
   141
 4697316551909513464L
90ce3da70b43 Initial load
duke
parents:
diff changeset
   142
90ce3da70b43 Initial load
duke
parents:
diff changeset
   143
gen OverlappingFileLockException "
90ce3da70b43 Initial load
duke
parents:
diff changeset
   144
 * Unchecked exception thrown when an attempt is made to acquire a lock on a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   145
 * region of a file that overlaps a region already locked by the same Java
90ce3da70b43 Initial load
duke
parents:
diff changeset
   146
 * virtual machine, or when another thread is already waiting to lock an
90ce3da70b43 Initial load
duke
parents:
diff changeset
   147
 * overlapping region of the same file." \
90ce3da70b43 Initial load
duke
parents:
diff changeset
   148
 2047812138163068433L
1152
29d6145d1097 4640544: New I/O: Complete socket-channel functionality
alanb
parents: 2
diff changeset
   149
29d6145d1097 4640544: New I/O: Complete socket-channel functionality
alanb
parents: 2
diff changeset
   150
29d6145d1097 4640544: New I/O: Complete socket-channel functionality
alanb
parents: 2
diff changeset
   151
SINCE=1.7
29d6145d1097 4640544: New I/O: Complete socket-channel functionality
alanb
parents: 2
diff changeset
   152
2057
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   153
SUPER=java.io.IOException
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   154
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   155
gen InterruptedByTimeoutException "
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   156
 * Checked exception received by a thread when a timeout elapses before an
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   157
 * asynchronous operation completes." \
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   158
 -4268008601014042947L
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   159
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   160
SUPER=IllegalArgumentException
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   161
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   162
gen IllegalChannelGroupException "
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   163
 * Unchecked exception thrown when an attempt is made to open a channel
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   164
 * in a group that was not created by the same provider. " \
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   165
 -2495041211157744253L
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   166
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   167
1152
29d6145d1097 4640544: New I/O: Complete socket-channel functionality
alanb
parents: 2
diff changeset
   168
SUPER=IllegalStateException
29d6145d1097 4640544: New I/O: Complete socket-channel functionality
alanb
parents: 2
diff changeset
   169
29d6145d1097 4640544: New I/O: Complete socket-channel functionality
alanb
parents: 2
diff changeset
   170
gen AlreadyBoundException "
29d6145d1097 4640544: New I/O: Complete socket-channel functionality
alanb
parents: 2
diff changeset
   171
 * Unchecked exception thrown when an attempt is made to bind the socket a
29d6145d1097 4640544: New I/O: Complete socket-channel functionality
alanb
parents: 2
diff changeset
   172
 * network oriented channel that is already bound." \
29d6145d1097 4640544: New I/O: Complete socket-channel functionality
alanb
parents: 2
diff changeset
   173
 6796072983322737592L
29d6145d1097 4640544: New I/O: Complete socket-channel functionality
alanb
parents: 2
diff changeset
   174
2057
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   175
gen AcceptPendingException "
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   176
 * Unchecked exception thrown when an attempt is made to initiate an accept
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   177
 * operation on a channel and a previous accept operation has not completed." \
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   178
 2721339977965416421L
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   179
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   180
gen ReadPendingException "
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   181
 * Unchecked exception thrown when an attempt is made to read from an
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   182
 * asynchronous socket channel and a previous read has not completed." \
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   183
 1986315242191227217L
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   184
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   185
gen WritePendingException "
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   186
 * Unchecked exception thrown when an attempt is made to write to an
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   187
 * asynchronous socket channel and a previous write has not completed." \
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   188
 7031871839266032276L
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   189
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   190
gen ShutdownChannelGroupException "
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   191
 * Unchecked exception thrown when an attempt is made to construct a channel in 
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   192
 * a group that is shutdown or the completion handler for an I/O operation 
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   193
 * cannot be invoked because the channel group is shutdown." \
3acf8e5e2ca0 6781363: New I/O: Update socket-channel API to jsr203/nio2-b99
alanb
parents: 1247
diff changeset
   194
 -3903801676350154157L