+ *
+ * | attribute type |
+ * expected tree type |
+ *
+ *
+ * | primitive type |
+ * {@link LiteralTree} created by {@link TreeMaker#Literal(java.lang.Object) } |
+ *
+ *
+ * | {@code java.lang.String} |
+ * {@link LiteralTree} created by {@link TreeMaker#Literal(java.lang.Object) } |
+ *
+ *
+ * | {@code java.lang.Class} |
+ * {@link MemberSelectTree} created by {@link TreeMaker#MemberSelect(com.sun.source.tree.ExpressionTree, java.lang.CharSequence) },
+ * with identifier {@code class} and expression created by {@link TreeMaker#QualIdent(javax.lang.model.element.Element) } |
+ *
+ *
+ * | enum constant |
+ * {@link MemberSelectTree}, with identifier representing the enum constant
+ * and expression created by {@link TreeMaker#QualIdent(javax.lang.model.element.Element) } |
+ *
+ *
+ * | annotation type |
+ * {@link AnnotationTree} created by {@link TreeMaker#Annotation(com.sun.source.tree.Tree, java.util.List) } |
+ *
+ *
+ * | array (of a supported type) |
+ * {@link NewArrayTree} created by {@link TreeMaker#NewArray(com.sun.source.tree.Tree, java.util.List, java.util.List) },
+ * where {@code elemtype} is {@code null}, {@code dimensions} is {@code Collections.emptyList()},
+ * {@code initializers} should contain the elements that should appear in the array |
+ *
+ *
+ *
+ * @param modifiers into which the values should be added
+ * @param annotation the annotation type that should be added or augmented
+ * @param attributeName the attribute that should be added or augmented
+ * @param attributeValuesToAdd values that should be added into the given attribute of the given annotation
+ * @return {@code modifiers} augmented in such a way that it contains the given annotation, with the given values
+ * @since 0.97
+ */
+ public ModifiersTree appendToAnnotationValue(ModifiersTree modifiers, TypeElement annotation, String attributeName, ExpressionTree... attributeValuesToAdd) {
+ return (ModifiersTree) appendToAnnotationValue((Tree) modifiers, annotation, attributeName, attributeValuesToAdd);
+ }
+
+ /**Ensures that the given {@code compilationUnit} contains annotation of the given type,
+ * which has attribute name {@code attributeName}, which contains values {@code attributeValuesToAdd}.
+ * The annotation or the attribute will be added as needed, as will be the attribute value
+ * converted from a single value into an array. This method is intended to be called on
+ * {@link CompilationUnitTree} from {@code package-info.java}.
+ *
+ * The typical trees passed as {@code attributeValuesToAdd} are:
+ *
+ *
+ * | attribute type |
+ * expected tree type |
+ *
+ *
+ * | primitive type |
+ * {@link LiteralTree} created by {@link TreeMaker#Literal(java.lang.Object) } |
+ *
+ *
+ * | {@code java.lang.String} |
+ * {@link LiteralTree} created by {@link TreeMaker#Literal(java.lang.Object) } |
+ *
+ *
+ * | {@code java.lang.Class} |
+ * {@link MemberSelectTree} created by {@link TreeMaker#MemberSelect(com.sun.source.tree.ExpressionTree, java.lang.CharSequence) },
+ * with identifier {@code class} and expression created by {@link TreeMaker#QualIdent(javax.lang.model.element.Element) } |
+ *
+ *
+ * | enum constant |
+ * {@link MemberSelectTree}, with identifier representing the enum constant
+ * and expression created by {@link TreeMaker#QualIdent(javax.lang.model.element.Element) } |
+ *
+ *
+ * | annotation type |
+ * {@link AnnotationTree} created by {@link TreeMaker#Annotation(com.sun.source.tree.Tree, java.util.List) } |
+ *
+ *
+ * | array (of a supported type) |
+ * {@link NewArrayTree} created by {@link TreeMaker#NewArray(com.sun.source.tree.Tree, java.util.List, java.util.List) },
+ * where {@code elemtype} is {@code null}, {@code dimensions} is {@code Collections.emptyList()},
+ * {@code initializers} should contain the elements that should appear in the array |
+ *
+ *
+ *
+ * @param compilationUnit into which the values should be added
+ * @param annotation the annotation type that should be added or augmented
+ * @param attributeName the attribute that should be added or augmented
+ * @param attributeValuesToAdd values that should be added into the given attribute of the given annotation
+ * @return {@code compilationUnit} augmented in such a way that it contains the given annotation, with the given values
+ * @since 0.97
+ */
+ public CompilationUnitTree appendToAnnotationValue(CompilationUnitTree compilationUnit, TypeElement annotation, String attributeName, ExpressionTree... attributeValuesToAdd) {
+ return (CompilationUnitTree) appendToAnnotationValue((Tree) compilationUnit, annotation, attributeName, attributeValuesToAdd);
+ }
+
+ private Tree appendToAnnotationValue(Tree/*CompilationUnitTree|ModifiersTree*/ modifiers, TypeElement annotation, String attributeName, ExpressionTree... attributeValuesToAdd) {
+ TreeMaker make = copy.getTreeMaker();
+
+ //check for already existing SuppressWarnings annotation:
+ List annotations = null;
+
+ if (modifiers.getKind() == Kind.MODIFIERS) {
+ annotations = ((ModifiersTree) modifiers).getAnnotations();
+ } else if (modifiers.getKind() == Kind.COMPILATION_UNIT) {
+ annotations = ((CompilationUnitTree) modifiers).getPackageAnnotations();
+ } else {
+ throw new IllegalStateException();
+ }
+
+ for (AnnotationTree at : annotations) {
+ TreePath tp = new TreePath(new TreePath(copy.getCompilationUnit()), at.getAnnotationType());
+ Element e = copy.getTrees().getElement(tp);
+
+ if (annotation.equals(e)) {
+ //found SuppressWarnings:
+ List arguments = at.getArguments();
+
+ for (ExpressionTree et : arguments) {
+ ExpressionTree expression;
+
+ if (et.getKind() == Kind.ASSIGNMENT) {
+ AssignmentTree assignment = (AssignmentTree) et;
+
+ if (!((IdentifierTree) assignment.getVariable()).getName().contentEquals(attributeName)) continue;
+
+ expression = assignment.getExpression();
+ } else if ("value".equals(attributeName)) {
+ expression = et;
+ } else {
+ continue;
+ }
+
+ List currentValues;
+
+ if (expression.getKind() == Kind.NEW_ARRAY) {
+ currentValues = ((NewArrayTree) expression).getInitializers();
+ } else {
+ currentValues = Collections.singletonList(expression);
+ }
+
+ assert currentValues != null;
+
+ List