Skip to content
GitLab
Menu
Projects
Groups
Snippets
/
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
Menu
Open sidebar
Jamie Mansfield
asm
Commits
317ff960
Commit
317ff960
authored
Oct 22, 2017
by
Eric Bruneton
Browse files
Fix the Javadoc errors and fail the build on Javadoc errors.
parent
db3d4fb2
Changes
17
Expand all
Hide whitespace changes
Inline
Side-by-side
asm-test/src/main/java/org/objectweb/asm/test/AsmTest.java
View file @
317ff960
...
...
@@ -234,7 +234,7 @@ public abstract class AsmTest {
/**
* Returns the int value of this version, as expected by ASM.
*
* @return one of
{@link Opcodes.ASM4},{@link Opcodes.
ASM5
}
or
{@link Opcodes.ASM6}
.
* @return one of
the ASM4,
ASM5 or
ASM6 constants from the ASM Opcodes interface
.
*/
public
int
value
()
{
return
value
;
...
...
@@ -310,7 +310,7 @@ public abstract class AsmTest {
* representation details (e.g. the order of the constants in the constant pool, the order of
* attributes and annotations, and low level details such as ldc vs ldc_w instructions).
*
* @param expected
String a string which should be contained in a dump of
the subject class.
* @param expected
ClassFile a class file content which should be equal to
the subject class.
*/
public
void
isEqualTo
(
byte
[]
expectedClassFile
)
{
try
{
...
...
asm-test/src/main/java/org/objectweb/asm/test/ClassDump.java
View file @
317ff960
This diff is collapsed.
Click to expand it.
asm-tree/src/main/java/org/objectweb/asm/tree/AbstractInsnNode.java
View file @
317ff960
...
...
@@ -96,9 +96,6 @@ public abstract class AbstractInsnNode {
* The runtime visible type annotations of this instruction. This field is only used for real
* instructions (i.e. not for labels, frames, or line number nodes). This list is a list of {@link
* TypeAnnotationNode} objects. May be <tt>null</tt>.
*
* @associates org.objectweb.asm.tree.TypeAnnotationNode
* @label visible
*/
public
List
<
TypeAnnotationNode
>
visibleTypeAnnotations
;
...
...
@@ -106,9 +103,6 @@ public abstract class AbstractInsnNode {
* The runtime invisible type annotations of this instruction. This field is only used for real
* instructions (i.e. not for labels, frames, or line number nodes). This list is a list of {@link
* TypeAnnotationNode} objects. May be <tt>null</tt>.
*
* @associates org.objectweb.asm.tree.TypeAnnotationNode
* @label invisible
*/
public
List
<
TypeAnnotationNode
>
invisibleTypeAnnotations
;
...
...
asm-tree/src/main/java/org/objectweb/asm/tree/ClassNode.java
View file @
317ff960
...
...
@@ -109,66 +109,46 @@ public class ClassNode extends ClassVisitor {
/**
* The runtime visible annotations of this class. This list is a list of {@link AnnotationNode}
* objects. May be <tt>null</tt>.
*
* @associates org.objectweb.asm.tree.AnnotationNode
* @label visible
*/
public
List
<
AnnotationNode
>
visibleAnnotations
;
/**
* The runtime invisible annotations of this class. This list is a list of {@link AnnotationNode}
* objects. May be <tt>null</tt>.
*
* @associates org.objectweb.asm.tree.AnnotationNode
* @label invisible
*/
public
List
<
AnnotationNode
>
invisibleAnnotations
;
/**
* The runtime visible type annotations of this class. This list is a list of {@link
* TypeAnnotationNode} objects. May be <tt>null</tt>.
*
* @associates org.objectweb.asm.tree.TypeAnnotationNode
* @label visible
*/
public
List
<
TypeAnnotationNode
>
visibleTypeAnnotations
;
/**
* The runtime invisible type annotations of this class. This list is a list of {@link
* TypeAnnotationNode} objects. May be <tt>null</tt>.
*
* @associates org.objectweb.asm.tree.TypeAnnotationNode
* @label invisible
*/
public
List
<
TypeAnnotationNode
>
invisibleTypeAnnotations
;
/**
* The non standard attributes of this class. This list is a list of {@link Attribute} objects.
* May be <tt>null</tt>.
*
* @associates org.objectweb.asm.Attribute
*/
public
List
<
Attribute
>
attrs
;
/**
* Informations about the inner classes of this class. This list is a list of {@link
* InnerClassNode} objects.
*
* @associates org.objectweb.asm.tree.InnerClassNode
*/
public
List
<
InnerClassNode
>
innerClasses
;
/**
* The fields of this class. This list is a list of {@link FieldNode} objects.
*
* @associates org.objectweb.asm.tree.FieldNode
*/
public
List
<
FieldNode
>
fields
;
/**
* The methods of this class. This list is a list of {@link MethodNode} objects.
*
* @associates org.objectweb.asm.tree.MethodNode
*/
public
List
<
MethodNode
>
methods
;
...
...
asm-tree/src/main/java/org/objectweb/asm/tree/FieldNode.java
View file @
317ff960
...
...
@@ -69,44 +69,30 @@ public class FieldNode extends FieldVisitor {
/**
* The runtime visible annotations of this field. This list is a list of {@link AnnotationNode}
* objects. May be <tt>null</tt>.
*
* @associates org.objectweb.asm.tree.AnnotationNode
* @label visible
*/
public
List
<
AnnotationNode
>
visibleAnnotations
;
/**
* The runtime invisible annotations of this field. This list is a list of {@link AnnotationNode}
* objects. May be <tt>null</tt>.
*
* @associates org.objectweb.asm.tree.AnnotationNode
* @label invisible
*/
public
List
<
AnnotationNode
>
invisibleAnnotations
;
/**
* The runtime visible type annotations of this field. This list is a list of {@link
* TypeAnnotationNode} objects. May be <tt>null</tt>.
*
* @associates org.objectweb.asm.tree.TypeAnnotationNode
* @label visible
*/
public
List
<
TypeAnnotationNode
>
visibleTypeAnnotations
;
/**
* The runtime invisible type annotations of this field. This list is a list of {@link
* TypeAnnotationNode} objects. May be <tt>null</tt>.
*
* @associates org.objectweb.asm.tree.TypeAnnotationNode
* @label invisible
*/
public
List
<
TypeAnnotationNode
>
invisibleTypeAnnotations
;
/**
* The non standard attributes of this field. This list is a list of {@link Attribute} objects.
* May be <tt>null</tt>.
*
* @associates org.objectweb.asm.Attribute
*/
public
List
<
Attribute
>
attrs
;
...
...
asm-tree/src/main/java/org/objectweb/asm/tree/MethodNode.java
View file @
317ff960
...
...
@@ -75,44 +75,30 @@ public class MethodNode extends MethodVisitor {
/**
* The runtime visible annotations of this method. This list is a list of {@link AnnotationNode}
* objects. May be <tt>null</tt>.
*
* @associates org.objectweb.asm.tree.AnnotationNode
* @label visible
*/
public
List
<
AnnotationNode
>
visibleAnnotations
;
/**
* The runtime invisible annotations of this method. This list is a list of {@link AnnotationNode}
* objects. May be <tt>null</tt>.
*
* @associates org.objectweb.asm.tree.AnnotationNode
* @label invisible
*/
public
List
<
AnnotationNode
>
invisibleAnnotations
;
/**
* The runtime visible type annotations of this method. This list is a list of {@link
* TypeAnnotationNode} objects. May be <tt>null</tt>.
*
* @associates org.objectweb.asm.tree.TypeAnnotationNode
* @label visible
*/
public
List
<
TypeAnnotationNode
>
visibleTypeAnnotations
;
/**
* The runtime invisible type annotations of this method. This list is a list of {@link
* TypeAnnotationNode} objects. May be <tt>null</tt>.
*
* @associates org.objectweb.asm.tree.TypeAnnotationNode
* @label invisible
*/
public
List
<
TypeAnnotationNode
>
invisibleTypeAnnotations
;
/**
* The non standard attributes of this method. This list is a list of {@link Attribute} objects.
* May be <tt>null</tt>.
*
* @associates org.objectweb.asm.Attribute
*/
public
List
<
Attribute
>
attrs
;
...
...
@@ -128,33 +114,22 @@ public class MethodNode extends MethodVisitor {
/**
* The runtime visible parameter annotations of this method. These lists are lists of {@link
* AnnotationNode} objects. May be <tt>null</tt>.
*
* @associates org.objectweb.asm.tree.AnnotationNode
* @label invisible parameters
*/
public
List
<
AnnotationNode
>[]
visibleParameterAnnotations
;
/**
* The runtime invisible parameter annotations of this method. These lists are lists of {@link
* AnnotationNode} objects. May be <tt>null</tt>.
*
* @associates org.objectweb.asm.tree.AnnotationNode
* @label visible parameters
*/
public
List
<
AnnotationNode
>[]
invisibleParameterAnnotations
;
/**
* The instructions of this method. This list is a list of {@link AbstractInsnNode} objects.
*
* @associates org.objectweb.asm.tree.AbstractInsnNode
* @label instructions
*/
public
InsnList
instructions
;
/**
* The try catch blocks of this method. This list is a list of {@link TryCatchBlockNode} objects.
*
* @associates org.objectweb.asm.tree.TryCatchBlockNode
*/
public
List
<
TryCatchBlockNode
>
tryCatchBlocks
;
...
...
@@ -167,24 +142,18 @@ public class MethodNode extends MethodVisitor {
/**
* The local variables of this method. This list is a list of {@link LocalVariableNode} objects.
* May be <tt>null</tt>
*
* @associates org.objectweb.asm.tree.LocalVariableNode
*/
public
List
<
LocalVariableNode
>
localVariables
;
/**
* The visible local variable annotations of this method. This list is a list of {@link
* LocalVariableAnnotationNode} objects. May be <tt>null</tt>
*
* @associates org.objectweb.asm.tree.LocalVariableAnnotationNode
*/
public
List
<
LocalVariableAnnotationNode
>
visibleLocalVariableAnnotations
;
/**
* The invisible local variable annotations of this method. This list is a list of {@link
* LocalVariableAnnotationNode} objects. May be <tt>null</tt>
*
* @associates org.objectweb.asm.tree.LocalVariableAnnotationNode
*/
public
List
<
LocalVariableAnnotationNode
>
invisibleLocalVariableAnnotations
;
...
...
asm-tree/src/main/java/org/objectweb/asm/tree/TryCatchBlockNode.java
View file @
317ff960
...
...
@@ -56,18 +56,12 @@ public class TryCatchBlockNode {
/**
* The runtime visible type annotations on the exception handler type. This list is a list of
* {@link TypeAnnotationNode} objects. May be <tt>null</tt>.
*
* @associates org.objectweb.asm.tree.TypeAnnotationNode
* @label visible
*/
public
List
<
TypeAnnotationNode
>
visibleTypeAnnotations
;
/**
* The runtime invisible type annotations on the exception handler type. This list is a list of
* {@link TypeAnnotationNode} objects. May be <tt>null</tt>.
*
* @associates org.objectweb.asm.tree.TypeAnnotationNode
* @label invisible
*/
public
List
<
TypeAnnotationNode
>
invisibleTypeAnnotations
;
...
...
asm-util/src/main/java/org/objectweb/asm/util/Printer.java
View file @
317ff960
...
...
@@ -178,13 +178,13 @@ public abstract class Printer {
public
abstract
void
visitSource
(
final
String
source
,
final
String
debug
);
/**
* Module. See {@link org.objectweb.asm.ClassVisitor#visitModule
(String, int)
}.
* Module. See {@link org.objectweb.asm.ClassVisitor#visitModule}.
*
* @param name module name.
* @param access module flags, among {@code ACC_OPEN}, {@code ACC_SYNTHETIC} and {@code
* ACC_MANDATED}.
* @param version module version or null.
* @return
* @return
the printer.
*/
public
Printer
visitModule
(
String
name
,
int
access
,
String
version
)
{
throw
new
RuntimeException
(
"Must be overriden"
);
...
...
asm/src/main/java/org/objectweb/asm/AnnotationWriter.java
View file @
317ff960
...
...
@@ -34,8 +34,10 @@ package org.objectweb.asm;
* attributes can be generated with the {@link #putAnnotations()} method. Similarly, arrays of such
* lists can be used to generate Runtime[In]VisibleParameterAnnotations attributes.
*
* @see https://docs.oracle.com/javase/specs/jvms/se9/html/jvms-4.html#jvms-4.7.16
* @see https://docs.oracle.com/javase/specs/jvms/se9/html/jvms-4.html#jvms-4.7.20
* @see <a href="https://docs.oracle.com/javase/specs/jvms/se9/html/jvms-4.html#jvms-4.7.16">JVMS
* 4.7.16</a>
* @see <a href="https://docs.oracle.com/javase/specs/jvms/se9/html/jvms-4.html#jvms-4.7.20>JVMS
* 4.7.20</a>
* @author Eric Bruneton
* @author Eugene Kuleshov
*/
...
...
asm/src/main/java/org/objectweb/asm/Attribute.java
View file @
317ff960
...
...
@@ -31,8 +31,10 @@ package org.objectweb.asm;
* A non standard class, field, method or code attribute, as defined in the Java Virtual Machine
* Specification (JVMS).
*
* @see https://docs.oracle.com/javase/specs/jvms/se9/html/jvms-4.html#jvms-4.7
* @see https://docs.oracle.com/javase/specs/jvms/se9/html/jvms-4.html#jvms-4.7.3
* @see <a href="https://docs.oracle.com/javase/specs/jvms/se9/html/jvms-4.html#jvms-4.7">JVMS
* 4.7</a>
* @see <a href="https://docs.oracle.com/javase/specs/jvms/se9/html/jvms-4.html#jvms-4.7.3">JVMS
* 4.7.3</a>
* @author Eric Bruneton
* @author Eugene Kuleshov
*/
...
...
asm/src/main/java/org/objectweb/asm/Context.java
View file @
317ff960
...
...
@@ -52,7 +52,8 @@ class Context {
* The offsets, from the start of the class file structure, to the first byte of each element of
* the bootstrap_methods array (in the BootstrapMethod attribute).
*
* @see https://docs.oracle.com/javase/specs/jvms/se9/html/jvms-4.html#jvms-4.7.23
* @see <a href="https://docs.oracle.com/javase/specs/jvms/se9/html/jvms-4.html#jvms-4.7.23">JVMS
* 4.7.23</a>
*/
int
[]
bootstrapMethodOffsets
;
...
...
asm/src/main/java/org/objectweb/asm/Handler.java
View file @
317ff960
...
...
@@ -33,7 +33,8 @@ package org.objectweb.asm;
* can be chained together, with their {@link #nextHandler} field, to describe a full JVMS
* exception_table array.
*
* @see https://docs.oracle.com/javase/specs/jvms/se9/html/jvms-4.html#jvms-4.7.3
* @see <a href="https://docs.oracle.com/javase/specs/jvms/se9/html/jvms-4.html#jvms-4.7.3">JVMS
* 4.7.3</a>
* @author Eric Bruneton
*/
final
class
Handler
{
...
...
asm/src/main/java/org/objectweb/asm/Label.java
View file @
317ff960
...
...
@@ -87,8 +87,8 @@ public class Label {
/**
* Field used to associate user information to a label. Warning: this field is used by the ASM
* tree package. In order to use it with the ASM tree package you must override the
{@link
*
org.objectweb.asm.tree.MethodNode#getLabelNode} method
.
* tree package. In order to use it with the ASM tree package you must override the
getLabelNode
*
method in MethodNode
.
*/
public
Object
info
;
...
...
asm/src/main/java/org/objectweb/asm/TypePath.java
View file @
317ff960
...
...
@@ -53,7 +53,9 @@ public class TypePath {
* Specification (JVMS) - corresponding to this TypePath is stored. The first byte of the
* structure in this array is given by {@link #typePathOffset}.
*
* @see https://docs.oracle.com/javase/specs/jvms/se9/html/jvms-4.html#jvms-4.7.20.2
* @see <a
* href="https://docs.oracle.com/javase/specs/jvms/se9/html/jvms-4.html#jvms-4.7.20.2">JVMS
* 4.7.20.2</a>
*/
private
final
byte
[]
typePathContainer
;
...
...
asm/src/main/java/org/objectweb/asm/TypeReference.java
View file @
317ff960
...
...
@@ -176,8 +176,11 @@ public class TypeReference {
* fields which reference bytecode offsets are set to 0 (these offsets are ignored in ClassReader,
* and recomputed in MethodWriter).
*
* @see https://docs.oracle.com/javase/specs/jvms/se9/html/jvms-4.html#jvms-4.7.20
* @see https://docs.oracle.com/javase/specs/jvms/se9/html/jvms-4.html#jvms-4.7.20.1
* @see <a href="https://docs.oracle.com/javase/specs/jvms/se9/html/jvms-4.html#jvms-4.7.20">JVMS
* 4.7.20</a>
* @see <a
* href="https://docs.oracle.com/javase/specs/jvms/se9/html/jvms-4.html#jvms-4.7.20.1">JVMS
* 4.7.20.1</a>
*/
private
final
int
targetTypeAndInfo
;
...
...
@@ -185,7 +188,7 @@ public class TypeReference {
* Creates a new TypeReference.
*
* @param typeRef the int encoded value of the type reference, as received in a visit method
* related to type annotations, such as {@link ClassVisitor#visitTypeAnnotation
()
}.
* related to type annotations, such as {@link ClassVisitor#visitTypeAnnotation}.
*/
public
TypeReference
(
final
int
typeRef
)
{
this
.
targetTypeAndInfo
=
typeRef
;
...
...
build.gradle
View file @
317ff960
...
...
@@ -215,7 +215,6 @@ subprojects {
googleJavaFormat
.
toolVersion
=
'1.4'
sourceCompatibility
=
'1.5'
targetCompatibility
=
'1.5'
javadoc
{
failOnError
=
false
}
// TODO fix the Javadoc and remove this!
dependencies
{
requires
.
each
{
projectName
->
compile
project
(
projectName
)
}
depends
.
each
{
artifactName
->
compile
artifactName
}
...
...
examples/compiler-indy/src/main/java/RT.java
View file @
317ff960
...
...
@@ -91,10 +91,7 @@ public class RT {
return
callSite
;
}
/**
* Garbage class containing the method used to apply 'not' on a boolean. See {@link
* RT#unary(Lookup, String, MethodType)}
*/
/** Garbage class containing the method used to apply 'not' on a boolean. See {@link RT#unary} */
public
static
class
UnayOps
{
public
static
Object
not
(
boolean
b
)
{
...
...
@@ -123,7 +120,7 @@ public class RT {
* previously computed method handle will be called again. Otherwise, a new method handle will be
* computed and two new guards will be installed.
*/
static
class
BinaryOpCallSite
extends
MutableCallSite
{
public
static
class
BinaryOpCallSite
extends
MutableCallSite
{
private
final
String
opName
;
...
...
Write
Preview
Supports
Markdown
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment