Commit 6f854bb6da16501b92d35959377280f842ca3e05
1 parent
d504f9da
fix javadoc
Showing
5 changed files
with
30 additions
and
16 deletions
Show diff stats
demoiselle-core/src/main/java/org/demoiselle/jee/core/annotation/Name.java
| ... | ... | @@ -6,13 +6,17 @@ |
| 6 | 6 | */ |
| 7 | 7 | package org.demoiselle.jee.core.annotation; |
| 8 | 8 | |
| 9 | -import static java.lang.annotation.ElementType.*; | |
| 9 | +import static java.lang.annotation.ElementType.FIELD; | |
| 10 | +import static java.lang.annotation.ElementType.METHOD; | |
| 11 | +import static java.lang.annotation.ElementType.PARAMETER; | |
| 12 | +import static java.lang.annotation.ElementType.TYPE; | |
| 13 | +import static java.lang.annotation.RetentionPolicy.RUNTIME; | |
| 14 | + | |
| 10 | 15 | import java.lang.annotation.Inherited; |
| 11 | 16 | import java.lang.annotation.Retention; |
| 12 | -import static java.lang.annotation.RetentionPolicy.RUNTIME; | |
| 13 | 17 | import java.lang.annotation.Target; |
| 18 | + | |
| 14 | 19 | import javax.enterprise.util.Nonbinding; |
| 15 | -import javax.inject.Named; | |
| 16 | 20 | import javax.inject.Qualifier; |
| 17 | 21 | |
| 18 | 22 | /** |
| ... | ... | @@ -21,12 +25,12 @@ import javax.inject.Qualifier; |
| 21 | 25 | * </p> |
| 22 | 26 | * |
| 23 | 27 | * <p> |
| 24 | - * This annotation is used to qualify beans using an user defined String. {@link javax.enterprise.inject.Produces} | |
| 28 | + * This annotation is used to qualify beans using an user defined String. | |
| 25 | 29 | * methods can then read this string and use it to customize the bean creation process. |
| 26 | 30 | * </p> |
| 27 | 31 | * |
| 28 | 32 | * <p> |
| 29 | - * The {@link #value()} attribute is non-binding (contrary to {@link Named#value()}, meaning multiple classes | |
| 33 | + * The attribute is non-binding (contrary to meaning multiple classes | |
| 30 | 34 | * qualified with this annotation, even with different values, will be considered the same candidate for |
| 31 | 35 | * injection points. To avoid ambiguous resolutions and select which candidate to choose usually you'll need a |
| 32 | 36 | * producer method to read the string and select the best fitted candidate. |
| ... | ... | @@ -52,7 +56,7 @@ public @interface Name { |
| 52 | 56 | * Specifies a name to access a custom configuration that will change how the annotated bean works. |
| 53 | 57 | * </p> |
| 54 | 58 | * <p> |
| 55 | - * This attribute is nonbinding so you can use the {@link Name} annotation to create {@linkplain javax.enterprise.inject.Produces} | |
| 59 | + * This attribute is nonbinding so you can use the annotation to create | |
| 56 | 60 | * methods or fields and have only one producer that works with all injection points no matter the value of this attribute. |
| 57 | 61 | * </p> |
| 58 | 62 | * @return Name of custom settings to personalize how the annotated bean works. | ... | ... |
demoiselle-core/src/main/java/org/demoiselle/jee/core/annotation/literal/NameQualifier.java
| ... | ... | @@ -10,11 +10,9 @@ import javax.enterprise.util.AnnotationLiteral; |
| 10 | 10 | import org.demoiselle.jee.core.annotation.Name; |
| 11 | 11 | |
| 12 | 12 | /** |
| 13 | - * Annotation litteral that allows to create instances of the {@link Name} literal. The created instance can then be | |
| 14 | - * used to call {@link javax.enterprise.inject.spi.CDI#select(Class subtype, java.lang.annotation.Annotation... qualifiers)} | |
| 13 | + * Annotation litteral that allows to create instances of the literal. The created instance can then be | |
| 15 | 14 | * |
| 16 | 15 | * @author SERPRO |
| 17 | - * @see javax.enterprise.inject.spi.CDI | |
| 18 | 16 | */ |
| 19 | 17 | @SuppressWarnings("all") |
| 20 | 18 | public class NameQualifier extends AnnotationLiteral<Name> implements Name { | ... | ... |
demoiselle-core/src/main/java/org/demoiselle/jee/core/annotation/literal/NamedQualifier.java
| ... | ... | @@ -11,13 +11,9 @@ import javax.enterprise.util.AnnotationLiteral; |
| 11 | 11 | import javax.inject.Named; |
| 12 | 12 | |
| 13 | 13 | /** |
| 14 | - * Annotation litteral that allows to create instances of the {@link Named} literal. | |
| 14 | + * Annotation litteral that allows to create instances of the literal. | |
| 15 | 15 | * Those instances can then be used to call |
| 16 | - * {@link javax.enterprise.inject.spi.CDI#select(Class subtype, Annotation... qualifiers)} | |
| 17 | 16 | * |
| 18 | - * @see javax.enterprise.inject.spi.CDI | |
| 19 | - * @see Named | |
| 20 | - * | |
| 21 | 17 | * @author SERPRO |
| 22 | 18 | */ |
| 23 | 19 | @SuppressWarnings("all") | ... | ... |
demoiselle-parent-bom/pom.xml
| ... | ... | @@ -28,6 +28,12 @@ |
| 28 | 28 | <url>http://www.serpro.gov.br</url> |
| 29 | 29 | </organization> |
| 30 | 30 | |
| 31 | + <parent> | |
| 32 | + <groupId>org.demoiselle.jee</groupId> | |
| 33 | + <artifactId>demoiselle-build</artifactId> | |
| 34 | + <version>3.0.0-BETA1-SNAPSHOT</version> | |
| 35 | + </parent> | |
| 36 | + | |
| 31 | 37 | <properties> |
| 32 | 38 | <!-- General --> |
| 33 | 39 | <demoiselle.version>3.0.0-BETA1-SNAPSHOT</demoiselle.version> |
| ... | ... | @@ -96,7 +102,7 @@ |
| 96 | 102 | <groupId>org.demoiselle.jee</groupId> |
| 97 | 103 | <artifactId>demoiselle-security-jwt</artifactId> |
| 98 | 104 | <version>${demoiselle.version}</version> |
| 99 | - </dependency> | |
| 105 | + </dependency> | |
| 100 | 106 | |
| 101 | 107 | <!-- jsr-299 api --> |
| 102 | 108 | <dependency> |
| ... | ... | @@ -219,4 +225,6 @@ |
| 219 | 225 | |
| 220 | 226 | </dependencyManagement> |
| 221 | 227 | |
| 228 | + | |
| 229 | + | |
| 222 | 230 | </project> | ... | ... |
pom.xml
| ... | ... | @@ -87,6 +87,14 @@ |
| 87 | 87 | </properties> |
| 88 | 88 | |
| 89 | 89 | <build> |
| 90 | + <pluginManagement> | |
| 91 | + <plugins> | |
| 92 | + <plugin> | |
| 93 | + <artifactId>maven-javadoc-plugin</artifactId> | |
| 94 | + <version>2.10</version> | |
| 95 | + </plugin> | |
| 96 | + </plugins> | |
| 97 | + </pluginManagement> | |
| 90 | 98 | <plugins> |
| 91 | 99 | <plugin> |
| 92 | 100 | <groupId>org.apache.maven.plugins</groupId> |
| ... | ... | @@ -156,7 +164,6 @@ |
| 156 | 164 | <plugin> |
| 157 | 165 | <groupId>org.apache.maven.plugins</groupId> |
| 158 | 166 | <artifactId>maven-javadoc-plugin</artifactId> |
| 159 | - <version>2.10.4</version> | |
| 160 | 167 | <executions> |
| 161 | 168 | <execution> |
| 162 | 169 | <id>attach-javadocs</id> |
| ... | ... | @@ -181,6 +188,7 @@ |
| 181 | 188 | </executions> |
| 182 | 189 | </plugin> |
| 183 | 190 | </plugins> |
| 191 | + | |
| 184 | 192 | </build> |
| 185 | 193 | </profile> |
| 186 | 194 | </profiles> | ... | ... |