Package org.jctools.queues.atomic
Class JavaParsingAtomicArrayQueueGenerator
java.lang.Object
com.github.javaparser.ast.visitor.VoidVisitorAdapter<Void>
org.jctools.queues.atomic.JavaParsingAtomicQueueGenerator
org.jctools.queues.atomic.JavaParsingAtomicArrayQueueGenerator
- All Implemented Interfaces:
com.github.javaparser.ast.visitor.VoidVisitor<Void>
,JCToolsGenerator
- Direct Known Subclasses:
JavaParsingAtomicUnpaddedArrayQueueGenerator
This generator takes in an JCTools 'ArrayQueue' Java source file and patches
Unsafe
accesses into
atomic AtomicLongFieldUpdater
. It outputs a Java source file with these patches.
An 'ArrayQueue' is one that is backed by a circular array and use a producerLimit
and a
consumerLimit
field to track the positions of each.
-
Field Summary
Fields inherited from class org.jctools.queues.atomic.JavaParsingAtomicQueueGenerator
GEN_DIRECTIVE_CLASS_CONTAINS_ORDERED_FIELD_ACCESSORS, GEN_DIRECTIVE_METHOD_IGNORE, sourceFileName
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprivate com.github.javaparser.ast.type.ClassOrInterfaceType
private com.github.javaparser.ast.type.ClassOrInterfaceType
atomicRefArrayType
(com.github.javaparser.ast.type.ArrayType in) (package private) String
fieldUpdaterFieldName
(String fieldName) private boolean
isLongArray
(com.github.javaparser.ast.type.Type in) static void
private void
patchAtomicFieldUpdaterAccessorMethods
(com.github.javaparser.ast.body.ClassOrInterfaceDeclaration n) For each method accessor to a field, add in the calls necessary to AtomicFieldUpdaters.private void
patchMethodAsDeprecatedRedirector
(com.github.javaparser.ast.body.MethodDeclaration methodToPatch, String toMethodName, com.github.javaparser.ast.type.Type returnType, com.github.javaparser.ast.body.Parameter... parameters) Given a method declaration node this method will replace it's code and signature with code to redirect all calls to it to thenewMethodName
.(package private) void
processSpecialNodeTypes
(com.github.javaparser.ast.nodeTypes.NodeWithType<?, com.github.javaparser.ast.type.Type> node, String name) Given a variable declaration of some sort, check it's name and type and if it looks like any of the key type changes between unsafe and atomic queues, perform the conversion to change it's type.void
void
Methods inherited from class org.jctools.queues.atomic.JavaParsingAtomicQueueGenerator
capitalise, classType, cleanupComments, declareLongFieldUpdater, fieldAssignment, fieldDeclarationWithInitialiser, fieldUpdaterCompareAndSet, fieldUpdaterLazySet, isCommentPresent, isRefArray, isRefType, methodCallExpr, newAtomicLongFieldUpdater, organiseImports, outputPackage, patchAtomicFieldUpdaterAccessorMethod, queueClassNamePrefix, removeStaticFieldsAndInitialisers, replaceParentClassesForAtomics, returnField, simpleParametricType, staticImportDeclaration, translateQueueName, visit, visit, visit
Methods inherited from class com.github.javaparser.ast.visitor.VoidVisitorAdapter
visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface org.jctools.queues.util.JCToolsGenerator
visit
-
Constructor Details
-
JavaParsingAtomicArrayQueueGenerator
-
-
Method Details
-
main
- Throws:
Exception
-
visit
-
visit
-
fieldUpdaterFieldName
- Specified by:
fieldUpdaterFieldName
in classJavaParsingAtomicQueueGenerator
-
processSpecialNodeTypes
void processSpecialNodeTypes(com.github.javaparser.ast.nodeTypes.NodeWithType<?, com.github.javaparser.ast.type.Type> node, String name) Given a variable declaration of some sort, check it's name and type and if it looks like any of the key type changes between unsafe and atomic queues, perform the conversion to change it's type.- Specified by:
processSpecialNodeTypes
in classJavaParsingAtomicQueueGenerator
-
patchMethodAsDeprecatedRedirector
private void patchMethodAsDeprecatedRedirector(com.github.javaparser.ast.body.MethodDeclaration methodToPatch, String toMethodName, com.github.javaparser.ast.type.Type returnType, com.github.javaparser.ast.body.Parameter... parameters) Given a method declaration node this method will replace it's code and signature with code to redirect all calls to it to thenewMethodName
. Method signatures of both methods must match exactly. -
patchAtomicFieldUpdaterAccessorMethods
private void patchAtomicFieldUpdaterAccessorMethods(com.github.javaparser.ast.body.ClassOrInterfaceDeclaration n) For each method accessor to a field, add in the calls necessary to AtomicFieldUpdaters. Only methods start with so/cas/sv/lv/lp followed by the field name are processed. Clearlylv
,
lp
and
sv
are simple field accesses with only
so and
cas
using the AtomicFieldUpdaters.
- Parameters:
n
- the AST node for the containing class
-
isLongArray
private boolean isLongArray(com.github.javaparser.ast.type.Type in) -
atomicRefArrayType
private com.github.javaparser.ast.type.ClassOrInterfaceType atomicRefArrayType(com.github.javaparser.ast.type.ArrayType in) -
atomicLongArrayType
private com.github.javaparser.ast.type.ClassOrInterfaceType atomicLongArrayType()
-