Package org.jruby.anno

Class AnnotationBinder

java.lang.Object

javax.annotation.processing.AbstractProcessor

org.jruby.anno.AnnotationBinder

All Implemented Interfaces:

Processor

@SupportedAnnotationTypes("org.jruby.anno.JRubyMethod")
public class AnnotationBinder
extends AbstractProcessor

Annotation processor for generating "populators" to bind native Java methods as Ruby methods, and to gather a list of classes seen during compilation that should have their invokers regenerated. NOTE: This class must ONLY reference classes in the org.jruby.anno package, to avoid forcing a transitive dependency on any runtime JRuby classes.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	AnnotationBinder.ParametersInfo

Field Summary

Fields

Modifier and Type	Field	Description
private final List<CharSequence>	classNames
private static final boolean	DEBUG
private PrintStream	out
static final String	POPULATOR_SUFFIX
static final String	SRC_GEN_DIR
private Types	types

Fields inherited from class javax.annotation.processing.AbstractProcessor

processingEnv

Constructor Summary

Constructors

Constructor	Description
AnnotationBinder()

Method Summary

Modifier and Type	Method	Description
void	addSubclassNames(List<String> classAndSubs, JRubyClass classAnno)
private static int	calculateActualRequired(ExecutableElement method, int paramsLength, int optional, boolean rest, boolean isStatic, boolean hasContext, boolean hasBlock)
static void	checkForThrows(TypeElement type, ExecutableElement method)
private void	defineMethodOnClass(String methodVar, String classVar, String[] names, String[] aliases, ExecutableElement md)
void	emitIndexCode(int bits, String names, String format)
protected void	gatherMappings(Map<CharSequence,List<ExecutableElement>> methods, Map<CharSequence,CharSequence> mappings)
private void	generateMethodAddCalls(ExecutableElement md, boolean meta, boolean module, String[] names, String[] aliases)
void	generateMethodAddCalls(ExecutableElement md, JRubyMethod anno)
private static CharSequence	getActualQualifiedName(TypeElement elem)
static String	getBaseName(String[] names, ExecutableElement md)
SourceVersion	getSupportedSourceVersion()
private static AnnotationBinder.ParametersInfo	identifyParameters(List<? extends VariableElement> parameters)
void	init(ProcessingEnvironment processingEnv)
private static StringBuilder	join(Object... vals)
private static StringBuilder	join(String sep, Iterable<?> names)
boolean	process(Set<? extends TypeElement> typeElements, RoundEnvironment roundEnvironment)
void	processMethodDeclaration(ExecutableElement method)
void	processMethodDeclarationMulti(ExecutableElement method)
void	processMethodDeclarations(Map<CharSequence,List<ExecutableElement>> declarations)
void	processType(TypeElement cd)
private static CharSequence	quote(Object name)
private static void	warn(CharSequence msg)

Methods inherited from class javax.annotation.processing.AbstractProcessor

getCompletions, getSupportedAnnotationTypes, getSupportedOptions, isInitialized

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

POPULATOR_SUFFIX

public static final String POPULATOR_SUFFIX

See Also:

• Constant Field Values

SRC_GEN_DIR

public static final String SRC_GEN_DIR

See Also:

• Constant Field Values

classNames

private final List<CharSequence> classNames

out

private PrintStream out

types

private Types types

DEBUG

private static final boolean DEBUG

See Also:

• Constant Field Values

Constructor Details

AnnotationBinder

public AnnotationBinder()

Method Details

init

public void init(ProcessingEnvironment processingEnv)

Specified by:

init in interface Processor

Overrides:

init in class AbstractProcessor

process

public boolean process(Set<? extends TypeElement> typeElements,
 RoundEnvironment roundEnvironment)

Specified by:

process in interface Processor

Specified by:

process in class AbstractProcessor

getSupportedSourceVersion

public SourceVersion getSupportedSourceVersion()

Specified by:

getSupportedSourceVersion in interface Processor

Overrides:

getSupportedSourceVersion in class AbstractProcessor

processType

public void processType(TypeElement cd)

addSubclassNames

public void addSubclassNames(List<String> classAndSubs,
 JRubyClass classAnno)

gatherMappings

protected void gatherMappings(Map<CharSequence,List<ExecutableElement>> methods,
 Map<CharSequence,CharSequence> mappings)

emitIndexCode

public void emitIndexCode(int bits,
 String names,
 String format)

processMethodDeclarations

public void processMethodDeclarations(Map<CharSequence,List<ExecutableElement>> declarations)

processMethodDeclaration

public void processMethodDeclaration(ExecutableElement method)

processMethodDeclarationMulti

public void processMethodDeclarationMulti(ExecutableElement method)

identifyParameters

private static AnnotationBinder.ParametersInfo identifyParameters(List<? extends VariableElement> parameters)

getActualQualifiedName

private static CharSequence getActualQualifiedName(TypeElement elem)

join

private static StringBuilder join(Object... vals)

join

private static StringBuilder join(String sep,
 Iterable<?> names)

quote

private static CharSequence quote(Object name)

calculateActualRequired

private static int calculateActualRequired(ExecutableElement method,
 int paramsLength,
 int optional,
 boolean rest,
 boolean isStatic,
 boolean hasContext,
 boolean hasBlock)

generateMethodAddCalls

public void generateMethodAddCalls(ExecutableElement md,
 JRubyMethod anno)

generateMethodAddCalls

private void generateMethodAddCalls(ExecutableElement md,
 boolean meta,
 boolean module,
 String[] names,
 String[] aliases)

defineMethodOnClass

private void defineMethodOnClass(String methodVar,
 String classVar,
 String[] names,
 String[] aliases,
 ExecutableElement md)

checkForThrows

public static void checkForThrows(TypeElement type,
 ExecutableElement method)

getBaseName

public static String getBaseName(String[] names,
 ExecutableElement md)

warn

private static void warn(CharSequence msg)