jdk

1
/*
2
 * Copyright (c) 2012, 2022, Oracle and/or its affiliates. All rights reserved.
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.
8
 *
9
 * This code is distributed in the hope that it will be useful, but WITHOUT
10
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
12
 * version 2 for more details (a copy is included in the LICENSE file that
13
 * accompanied this code).
14
 *
15
 * You should have received a copy of the GNU General Public License version
16
 * 2 along with this work; if not, write to the Free Software Foundation,
17
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18
 *
19
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
20
 * or visit www.oracle.com if you need additional information or have any
21
 * questions.
22
 */
23

24
/*
25
 * @test
26
 * @bug 7021614 8273244
27
 * @summary extend com.sun.source API to support parsing javadoc comments
28
 * @modules jdk.compiler/com.sun.tools.javac.api
29
 *          jdk.compiler/com.sun.tools.javac.file
30
 *          jdk.compiler/com.sun.tools.javac.tree
31
 *          jdk.compiler/com.sun.tools.javac.util
32
 * @build DocCommentTester
33
 * @run main DocCommentTester ThrowableTest.java
34
 */
35

36
class ThrowableTest {
37
    /**
38
     * @throws Exception
39
     */
40
    void exception() throws Exception { }
41
/*
42
DocComment[DOC_COMMENT, pos:1
43
  firstSentence: empty
44
  body: empty
45
  block tags: 1
46
    Throws[THROWS, pos:1
47
      exceptionName:
48
        Reference[REFERENCE, pos:9, Exception]
49
      description: empty
50
    ]
51
]
52
*/
53

54
    /**
55
     * @throws Exception text
56
     */
57
    void exception_text() throws Exception { }
58
/*
59
DocComment[DOC_COMMENT, pos:1
60
  firstSentence: empty
61
  body: empty
62
  block tags: 1
63
    Throws[THROWS, pos:1
64
      exceptionName:
65
        Reference[REFERENCE, pos:9, Exception]
66
      description: 1
67
        Text[TEXT, pos:19, text]
68
    ]
69
]
70
*/
71

72
    /**
73
     * @throws Exception#member text
74
     */
75
    void exception_member() throws Exception { }
76
/*
77
DocComment[DOC_COMMENT, pos:1
78
  firstSentence: empty
79
  body: empty
80
  block tags: 1
81
    Erroneous[ERRONEOUS, pos:1, prefPos:18
82
      code: compiler.err.dc.ref.unexpected.input
83
      body: @throws_Exception#member_text
84
    ]
85
]
86
*/
87

88
    /**
89
     * @throws Exception##fragment text
90
     */
91
    void exception_fragment() throws Exception { }
92
/*
93
DocComment[DOC_COMMENT, pos:1
94
  firstSentence: empty
95
  body: empty
96
  block tags: 1
97
    Erroneous[ERRONEOUS, pos:1, prefPos:18
98
      code: compiler.err.dc.ref.unexpected.input
99
      body: @throws_Exception##fragment_text
100
    ]
101
]
102
*/
103
}
104

105