TestThrowsTagInheritence.java revision 3233:b5d08bc0d224 
1/*
2 * Copyright (c) 2002, 2016, 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 4684827 4633969
27 * @summary This test verifies that throws tags in implementing class
28 * override the throws tags in interface. This test also verifies that throws tags are inherited properly
29 * the case where the name of one exception is not fully qualified.
30 * @author jamieh
31 * @library ../lib
32 * @modules jdk.javadoc
33 * @build JavadocTester
34 * @run main TestThrowsTagInheritence
35 */
36
37// TODO: should be TestThrowsInheritance!
38public class TestThrowsTagInheritence extends JavadocTester {
39
40    public static void main(String... args) throws Exception {
41        TestThrowsTagInheritence tester = new TestThrowsTagInheritence();
42        tester.runTests();
43    }
44
45    @Test
46    void test() {
47        javadoc("-d", "out",
48                "-sourcepath", testSrc,
49                testSrc("C.java"),
50                testSrc("I.java"),
51                testSrc("Foo.java"),
52                testSrc("Iface.java"));
53        checkExit(Exit.OK);
54
55        // The class should not inherit the tag from the interface.
56        checkOutput("Foo.html", true,
57                "Test 1 passes.");
58
59        //The class should not inherit the tag from the interface.
60        checkOutput("C.html", false,
61                "Test 1 fails.");
62    }
63
64    @Test
65    void test1() {
66        javadoc("-d", "out-1",
67                "-sourcepath", testSrc,
68                "-package", "pkg");
69        checkExit(Exit.OK);
70
71        // The method should not inherit the IOOBE throws tag from the abstract class,
72        // for now keep keep this bug compatible, should fix this correctly in
73        // the future.
74        checkOutput("pkg/Extender.html", false, "java.lang.IndexOutOfBoundsException");
75    }
76}
77