test/com/sun/javadoc/testTagInheritence/pkg/TestTagInheritence.java

Wed, 18 Sep 2013 22:47:06 -0700

author
bpatel
date
Wed, 18 Sep 2013 22:47:06 -0700
changeset 2036
8df12c315ea3
parent 554
9d9f26857129
child 2525
2eb010b6cb22
permissions
-rw-r--r--

8024096: some javadoc tests may contain false positive results
Reviewed-by: jjg

     1 /*
     2  * Copyright (c) 2001, 2003, 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  */
    24 package pkg;
    26 import java.lang.*;
    27 import java.io.*;
    29 public class TestTagInheritence extends TestAbstractClass implements TestInterface{
    31   //This method below tests tag inheritence from a class.
    34   public String testAbstractClass_method1(int p1, int p2) throws java.io.IOException,
    35 java.lang.NullPointerException {
    36       return null;
    37   }
    39   /**
    40    * This method tests @inheritDoc with a class.  Here is the inherited comment:<br>
    41    * {@inheritDoc}
    42    * @param p1 {@inheritDoc}
    43    * @param p2 {@inheritDoc}
    44    * @return {@inheritDoc}
    45    * @throws java.io.IOException {@inheritDoc}
    46    * @throws java.lang.NullPointerException {@inheritDoc}
    47    */
    48   public String testAbstractClass_method2(int p1, int p2) throws java.io.IOException,
    49 java.lang.NullPointerException {
    50       return null;
    51   }
    53   public String testInterface_method1(int p1, int p2) throws java.io.IOException,
    54 java.lang.NullPointerException
    55   {
    56       return null;
    57   }
    59   /**
    60    * This method tests @inheritDoc with an inteface.  Here is the inherited comment:<br>
    61    * {@inheritDoc}
    62    * @param p1 {@inheritDoc}
    63    * @param p2 {@inheritDoc}
    64    * @return {@inheritDoc}
    65    * @throws java.io.IOException {@inheritDoc}
    66    * @throws java.lang.NullPointerException {@inheritDoc}
    67    */
    68   public String testInterface_method2(int p1, int p2) throws java.io.IOException,
    69 java.lang.NullPointerException {
    70       return null;
    71   }
    73     /**
    74      * Here is the documentation that I should inherit from
    75      * the interface implemented by my superclass.
    76      * {@inheritDoc}
    77      */
    78     public void methodInTestInterfaceForAbstractClass() {}
    80     /**
    81      * {@inheritDoc}
    82      */
    83     public void testSuperSuperMethod() {}
    85     /**
    86      * Test inheritDoc warning message:
    87      * {@inheritDoc}
    88      */
    89     public void testBadInheritDocTag () {}
    91     /**
    92      * {@inheritDoc}
    93      * @param <X> {@inheritDoc}
    94      * @param <Y> {@inheritDoc}
    95      * @param p1 {@inheritDoc}
    96      * @param p2 {@inheritDoc}
    97      * @return {@inheritDoc}
    98      * @throws java.io.IOException {@inheritDoc}
    99      * @throws java.lang.NullPointerException {@inheritDoc}
   100      */
   101     public <X,Y> String testSuperSuperMethod(int p1, int p2) {
   102         return null;
   103     }
   105     public <X,Y> String testSuperSuperMethod2(int p1, int p2)
   106     throws java.io.IOException, java.lang.NullPointerException {
   107         return null;
   108     }
   110 }

mercurial