jdk

1
/*
2
 * Copyright (c) 2012, 2021, 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 SerialFieldTest.java
34
 */
35

36
class SerialFieldTest {
37

38
    /**
39
     * @serialField field String
40
     */
41
    String f1;
42
/*
43
DocComment[DOC_COMMENT, pos:1
44
  firstSentence: empty
45
  body: empty
46
  block tags: 1
47
    SerialField[SERIAL_FIELD, pos:1
48
      name:
49
        Identifier[IDENTIFIER, pos:14, field]
50
      type:
51
        Reference[REFERENCE, pos:20, String]
52
      description: empty
53
    ]
54
]
55
*/
56

57
    /**
58
     * @serialField field String f2 is a String
59
     */
60
    String f2;
61
/*
62
DocComment[DOC_COMMENT, pos:1
63
  firstSentence: empty
64
  body: empty
65
  block tags: 1
66
    SerialField[SERIAL_FIELD, pos:1
67
      name:
68
        Identifier[IDENTIFIER, pos:14, field]
69
      type:
70
        Reference[REFERENCE, pos:20, String]
71
      description: 1
72
        Text[TEXT, pos:27, f2_is_a_String]
73
    ]
74
]
75
*/
76

77
    /**
78
     * @serialField field String#member f3 is a String
79
     */
80
    String f3;
81
/*
82
DocComment[DOC_COMMENT, pos:1
83
  firstSentence: empty
84
  body: empty
85
  block tags: 1
86
    Erroneous[ERRONEOUS, pos:1, prefPos:26
87
      code: compiler.err.dc.ref.unexpected.input
88
      body: @serialField_field_String#member_f3_is_a_String
89
    ]
90
]
91
*/
92

93
    /**
94
     * @serialField field String##fragment f4 is a String
95
     */
96
    String f4;
97
/*
98
DocComment[DOC_COMMENT, pos:1
99
  firstSentence: empty
100
  body: empty
101
  block tags: 1
102
    Erroneous[ERRONEOUS, pos:1, prefPos:26
103
      code: compiler.err.dc.ref.unexpected.input
104
      body: @serialField_field_String##fragment_f4_is_a_String
105
    ]
106
]
107
*/
108

109
}
110

111