author | rfield |
Sat, 21 May 2016 22:32:08 -0700 | |
changeset 38535 | 4a25025e0b0d |
parent 33362 | langtools/src/jdk.jshell/share/classes/jdk/internal/jshell/remote/RemoteResolutionException.java@65ec6de1d6b4 |
child 39807 | ba0ff343d241 |
permissions | -rw-r--r-- |
33362 | 1 |
/* |
38535
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
2 |
* Copyright (c) 2016, Oracle and/or its affiliates. All rights reserved. |
33362 | 3 |
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
4 |
* |
|
5 |
* This code is free software; you can redistribute it and/or modify it |
|
6 |
* under the terms of the GNU General Public License version 2 only, as |
|
7 |
* published by the Free Software Foundation. Oracle designates this |
|
8 |
* particular file as subject to the "Classpath" exception as provided |
|
9 |
* by Oracle in the LICENSE file that accompanied this code. |
|
10 |
* |
|
11 |
* This code is distributed in the hope that it will be useful, but WITHOUT |
|
12 |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
|
13 |
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
|
14 |
* version 2 for more details (a copy is included in the LICENSE file that |
|
15 |
* accompanied this code). |
|
16 |
* |
|
17 |
* You should have received a copy of the GNU General Public License version |
|
18 |
* 2 along with this work; if not, write to the Free Software Foundation, |
|
19 |
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
|
20 |
* |
|
21 |
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
|
22 |
* or visit www.oracle.com if you need additional information or have any |
|
23 |
* questions. |
|
24 |
*/ |
|
25 |
||
38535
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
26 |
package jdk.jshell.spi; |
33362 | 27 |
|
28 |
/** |
|
38535
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
29 |
* The construction and throw of this exception is embedded in code generated by |
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
30 |
* the JShell core implementation in such a way that, upon executing a |
33362 | 31 |
* {@link jdk.jshell.Snippet.Status#RECOVERABLE_DEFINED RECOVERABLE_DEFINED} |
38535
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
32 |
* user method, this exception is thrown. |
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
33 |
* <p> |
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
34 |
* This exception is seen by the execution engine, but not seen by |
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
35 |
* the end user nor through the JShell API. |
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
36 |
* |
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
37 |
* @see ExecutionEnv#createUnresolvedReferenceException(int, |
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
38 |
* java.lang.StackTraceElement[]) |
33362 | 39 |
*/ |
40 |
@SuppressWarnings("serial") // serialVersionUID intentionally omitted |
|
38535
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
41 |
public class SPIResolutionException extends RuntimeException { |
33362 | 42 |
|
38535
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
43 |
private final int id; |
33362 | 44 |
|
45 |
/** |
|
38535
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
46 |
* Constructs an SPI layer exception indicating that a |
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
47 |
* {@code DeclarationSnippet} with unresolved references has been |
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
48 |
* encountered. The throw of this exception is generated into the body of a |
33362 | 49 |
* {@link jdk.jshell.Snippet.Status#RECOVERABLE_DEFINED RECOVERABLE_DEFINED} |
50 |
* method. |
|
38535
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
51 |
* |
33362 | 52 |
* @param id An internal identifier of the specific method |
53 |
*/ |
|
38535
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
54 |
public SPIResolutionException(int id) { |
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
55 |
super("resolution exception"); |
33362 | 56 |
this.id = id; |
57 |
} |
|
38535
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
58 |
|
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
59 |
/** |
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
60 |
* Retrieves the internal identifer of the unresolved identifer. |
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
61 |
* |
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
62 |
* @return the internal identifer |
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
63 |
* @see ExecutionEnv#createUnresolvedReferenceException(int, |
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
64 |
* java.lang.StackTraceElement[]) |
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
65 |
*/ |
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
66 |
public int id() { |
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
67 |
return id; |
4a25025e0b0d
8156101: JShell SPI: Provide a pluggable execution control SPI
rfield
parents:
33362
diff
changeset
|
68 |
} |
33362 | 69 |
} |