67 lines
3.0 KiB
Plaintext
67 lines
3.0 KiB
Plaintext
/*
|
|
* Copyright (c) 2015, Oracle and/or its affiliates. All rights reserved.
|
|
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
|
*
|
|
* This code is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU General Public License version 2 only, as
|
|
* published by the Free Software Foundation.
|
|
*
|
|
* This code is distributed in the hope that it will be useful, but WITHOUT
|
|
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
* version 2 for more details (a copy is included in the LICENSE file that
|
|
* accompanied this code).
|
|
*
|
|
* You should have received a copy of the GNU General Public License version
|
|
* 2 along with this work; if not, write to the Free Software Foundation,
|
|
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
*
|
|
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
|
* or visit www.oracle.com if you need additional information or have any
|
|
* questions.
|
|
*/
|
|
|
|
== Description of tests for RuntimeVisibleAnnotations, RuntimeInVisibleAnnotations
|
|
RuntimeVisibleParameterAnnotations and RuntimeInvisibleParameterAnnotations attributes ==
|
|
|
|
* AnnotationsTestBase class is a base class for the Annotations attribute tests.
|
|
It contains some convenience methods which might be used in derived classes.
|
|
|
|
* ClassType is a enum which is used for convenience code generation (see TestCase).
|
|
|
|
* TestCase is a class which represent a test case. TestCase contains TestClassInfo,
|
|
which represents a class, TestMethodInfo, which represents a method, TestFieldInfo,
|
|
which represents a field, and TestParameterInfo, which represents a method's parameter.
|
|
The class is used as test case builder. For example, the following code creates
|
|
the top-level class Test with method classMethod() and local class Local.
|
|
Each program member is annotated by some annotation which is an instance of
|
|
TestAnnotationInfo (see TestAnnotationInfo):
|
|
|
|
TestCase test = new TestCase(ClassType.CLASS, "Test", "public");
|
|
test.clazz.addAnnotation(annotations);
|
|
TestCase.TestMethodInfo classMethod = test.clazz.addMethod("classMethod()");
|
|
classMethod.addAnnotation(annotation);
|
|
TestCase.TestClassInfo localClassInClassMethod = classMethod.addLocalClass("Local");
|
|
localClassInClassMethod.addAnnotation(annotations);
|
|
|
|
Let "annotations" be a list of annotations A, B(i = 2). Thus, a test will generate the
|
|
following code:
|
|
|
|
@A
|
|
@B(i = 2)
|
|
public class Test {
|
|
@A
|
|
@B(i = 2)
|
|
void classMethod() {
|
|
@A
|
|
@B(i = 2)
|
|
class Local {
|
|
}
|
|
}
|
|
}
|
|
|
|
Thus, TestCase contains information about structure of classes and golden data
|
|
about annotations. Thereafter, sources can be generated from this class representation
|
|
by calling method generateSource(). Enum ClassType is used to handle "class type specific"
|
|
code generation. For example, not-abstract method in a class always has body,
|
|
while not-static and not-default method in an interface does not. |