You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by gg...@apache.org on 2026/01/04 20:46:31 UTC
(commons-weaver) branch master updated (0a8150c -> 0acdfa5)
This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a change to branch master
in repository https://gitbox.apache.org/repos/asf/commons-weaver.git
from 0a8150c Javadoc
new dc8d2d8 Javadoc
new 7eae9e7 Javadoc
new 7a6febe Javadoc
new 9556a54 Javadoc
new 0acdfa5 Javadoc
The 5 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
.../src/main/java/org/apache/commons/weaver/maven/AbstractCWMojo.java | 1 +
.../src/main/java/org/apache/commons/weaver/maven/PrepareMojo.java | 1 +
.../src/main/java/org/apache/commons/weaver/maven/TestPrepareMojo.java | 1 +
.../src/main/java/org/apache/commons/weaver/normalizer/Utils.java | 1 +
.../src/main/java/org/apache/commons/weaver/privilizer/Privilizing.java | 2 ++
.../src/main/java/org/apache/commons/weaver/privilizer/AccessLevel.java | 1 +
.../src/main/java/org/apache/commons/weaver/privilizer/Field.java | 1 +
.../src/main/java/org/apache/commons/weaver/privilizer/FieldAccess.java | 1 +
.../src/main/java/org/apache/commons/weaver/privilizer/Policy.java | 1 +
.../src/main/java/org/apache/commons/weaver/privilizer/Privilized.java | 1 +
.../src/main/java/org/apache/commons/weaver/privilizer/Privilizer.java | 1 +
processor/src/main/java/org/apache/commons/weaver/Consumes.java | 1 +
processor/src/main/java/org/apache/commons/weaver/Produces.java | 1 +
.../main/java/org/apache/commons/weaver/lifecycle/WeaveLifecycle.java | 1 +
.../java/org/apache/commons/weaver/lifecycle/WeaveLifecycleToken.java | 2 ++
.../main/java/org/apache/commons/weaver/model/AnnotatedElements.java | 1 +
.../src/main/java/org/apache/commons/weaver/model/WeaveEnvironment.java | 1 +
processor/src/main/java/org/apache/commons/weaver/spi/Cleaner.java | 1 +
processor/src/main/java/org/apache/commons/weaver/spi/Weaver.java | 1 +
processor/src/main/java/org/apache/commons/weaver/utils/Providers.java | 1 +
processor/src/main/java/org/apache/commons/weaver/utils/URLArray.java | 1 +
21 files changed, 23 insertions(+)
(commons-weaver) 02/05: Javadoc
Posted by gg...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-weaver.git
commit 7eae9e79dcf0bbc3646e225e188765b559decbf6
Author: Gary Gregory <ga...@gmail.com>
AuthorDate: Sun Jan 4 15:46:02 2026 -0500
Javadoc
Add an empty line before a Javadoc comment
---
.../src/main/java/org/apache/commons/weaver/normalizer/Utils.java | 1 +
1 file changed, 1 insertion(+)
diff --git a/modules/normalizer/src/main/java/org/apache/commons/weaver/normalizer/Utils.java b/modules/normalizer/src/main/java/org/apache/commons/weaver/normalizer/Utils.java
index d8190b5..a60cf51 100644
--- a/modules/normalizer/src/main/java/org/apache/commons/weaver/normalizer/Utils.java
+++ b/modules/normalizer/src/main/java/org/apache/commons/weaver/normalizer/Utils.java
@@ -27,6 +27,7 @@ import org.apache.commons.lang3.Validate;
* Normalization utilities.
*/
final class Utils {
+
/**
* Validate a package name.
* @param pkg to validate
(commons-weaver) 04/05: Javadoc
Posted by gg...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-weaver.git
commit 9556a549b50ae8bce0307f5a43d8f32f002b9a0a
Author: Gary Gregory <ga...@gmail.com>
AuthorDate: Sun Jan 4 15:46:15 2026 -0500
Javadoc
Add an empty line before a Javadoc comment
---
.../src/main/java/org/apache/commons/weaver/privilizer/AccessLevel.java | 1 +
.../weaver/src/main/java/org/apache/commons/weaver/privilizer/Field.java | 1 +
.../src/main/java/org/apache/commons/weaver/privilizer/FieldAccess.java | 1 +
.../src/main/java/org/apache/commons/weaver/privilizer/Policy.java | 1 +
.../src/main/java/org/apache/commons/weaver/privilizer/Privilized.java | 1 +
.../src/main/java/org/apache/commons/weaver/privilizer/Privilizer.java | 1 +
6 files changed, 6 insertions(+)
diff --git a/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/AccessLevel.java b/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/AccessLevel.java
index 114a9f4..06f8fc2 100644
--- a/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/AccessLevel.java
+++ b/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/AccessLevel.java
@@ -30,6 +30,7 @@ import org.apache.commons.lang3.Validate;
* Enumerates the Java access levels.
*/
public enum AccessLevel {
+
/**
* {@code public}.
*/
diff --git a/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/Field.java b/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/Field.java
index 775d9a5..9c5e2cc 100644
--- a/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/Field.java
+++ b/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/Field.java
@@ -28,6 +28,7 @@ import org.objectweb.asm.Type;
* Represents a Java field.
*/
public class Field {
+
/**
* Access modifier.
*/
diff --git a/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/FieldAccess.java b/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/FieldAccess.java
index d924b1e..efb9bf5 100644
--- a/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/FieldAccess.java
+++ b/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/FieldAccess.java
@@ -25,6 +25,7 @@ import org.objectweb.asm.Type;
* accessing type.
*/
public class FieldAccess extends Field {
+
/**
* {@link Type} from which field is accessed.
*/
diff --git a/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/Policy.java b/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/Policy.java
index 84b5646..a0736a2 100644
--- a/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/Policy.java
+++ b/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/Policy.java
@@ -27,6 +27,7 @@ import org.apache.commons.lang3.StringUtils;
* Weaving policy: when to use {@link PrivilegedAction}s.
*/
public enum Policy {
+
/**
* Disables weaving.
*/
diff --git a/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/Privilized.java b/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/Privilized.java
index 8ad226d..bb408e2 100644
--- a/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/Privilized.java
+++ b/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/Privilized.java
@@ -26,6 +26,7 @@ import java.lang.annotation.Target;
*/
@Target(ElementType.TYPE)
public @interface Privilized {
+
/**
* Name of {@link Policy} with which privilized weaving was performed.
* @return {@link String}
diff --git a/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/Privilizer.java b/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/Privilizer.java
index 712633f..73b76cf 100644
--- a/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/Privilizer.java
+++ b/modules/privilizer/weaver/src/main/java/org/apache/commons/weaver/privilizer/Privilizer.java
@@ -42,6 +42,7 @@ import org.objectweb.asm.util.TraceClassVisitor;
* Coordinates privilization activities.
*/
public class Privilizer {
+
/**
* An ASM {@link ClassVisitor} for privilization.
*/
(commons-weaver) 05/05: Javadoc
Posted by gg...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-weaver.git
commit 0acdfa5a0a88f8c0f45cc1ff1a024e62d239070e
Author: Gary Gregory <ga...@gmail.com>
AuthorDate: Sun Jan 4 15:46:25 2026 -0500
Javadoc
Add an empty line before a Javadoc comment
---
processor/src/main/java/org/apache/commons/weaver/Consumes.java | 1 +
processor/src/main/java/org/apache/commons/weaver/Produces.java | 1 +
.../main/java/org/apache/commons/weaver/lifecycle/WeaveLifecycle.java | 1 +
.../java/org/apache/commons/weaver/lifecycle/WeaveLifecycleToken.java | 2 ++
.../main/java/org/apache/commons/weaver/model/AnnotatedElements.java | 1 +
.../src/main/java/org/apache/commons/weaver/model/WeaveEnvironment.java | 1 +
processor/src/main/java/org/apache/commons/weaver/spi/Cleaner.java | 1 +
processor/src/main/java/org/apache/commons/weaver/spi/Weaver.java | 1 +
processor/src/main/java/org/apache/commons/weaver/utils/Providers.java | 1 +
processor/src/main/java/org/apache/commons/weaver/utils/URLArray.java | 1 +
10 files changed, 11 insertions(+)
diff --git a/processor/src/main/java/org/apache/commons/weaver/Consumes.java b/processor/src/main/java/org/apache/commons/weaver/Consumes.java
index e267436..561f6df 100644
--- a/processor/src/main/java/org/apache/commons/weaver/Consumes.java
+++ b/processor/src/main/java/org/apache/commons/weaver/Consumes.java
@@ -36,6 +36,7 @@ import org.apache.commons.weaver.spi.WeaveLifecycleProvider;
@Target(ElementType.TYPE)
@Inherited
public @interface Consumes {
+
/**
* The consumed types.
* @return array of {@link WeaveLifecycleProvider} subclasses
diff --git a/processor/src/main/java/org/apache/commons/weaver/Produces.java b/processor/src/main/java/org/apache/commons/weaver/Produces.java
index 33f956c..5ba5aee 100644
--- a/processor/src/main/java/org/apache/commons/weaver/Produces.java
+++ b/processor/src/main/java/org/apache/commons/weaver/Produces.java
@@ -36,6 +36,7 @@ import org.apache.commons.weaver.spi.WeaveLifecycleProvider;
@Target(ElementType.TYPE)
@Inherited
public @interface Produces {
+
/**
* The consuming types.
* @return array of {@link WeaveLifecycleProvider} subclasses
diff --git a/processor/src/main/java/org/apache/commons/weaver/lifecycle/WeaveLifecycle.java b/processor/src/main/java/org/apache/commons/weaver/lifecycle/WeaveLifecycle.java
index d846de0..de76516 100644
--- a/processor/src/main/java/org/apache/commons/weaver/lifecycle/WeaveLifecycle.java
+++ b/processor/src/main/java/org/apache/commons/weaver/lifecycle/WeaveLifecycle.java
@@ -25,6 +25,7 @@ package org.apache.commons.weaver.lifecycle;
* @since 1.2
*/
public enum WeaveLifecycle {
+
/**
* Depicts the 'clean' stage of the lifecycle.
*/
diff --git a/processor/src/main/java/org/apache/commons/weaver/lifecycle/WeaveLifecycleToken.java b/processor/src/main/java/org/apache/commons/weaver/lifecycle/WeaveLifecycleToken.java
index 130b6a9..d65e868 100644
--- a/processor/src/main/java/org/apache/commons/weaver/lifecycle/WeaveLifecycleToken.java
+++ b/processor/src/main/java/org/apache/commons/weaver/lifecycle/WeaveLifecycleToken.java
@@ -30,6 +30,7 @@ import java.lang.annotation.Target;
* @since 1.2
*/
public class WeaveLifecycleToken {
+
/**
* Declares the association between a {@link WeaveLifecycleToken} and an element of the {@link WeaveLifecycle}.
*/
@@ -37,6 +38,7 @@ public class WeaveLifecycleToken {
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface Represents {
+
/**
* The {@link WeaveLifecycle} stage represented by the annotated {@link WeaveLifecycleToken} type.
* @return {@link WeaveLifecycle}
diff --git a/processor/src/main/java/org/apache/commons/weaver/model/AnnotatedElements.java b/processor/src/main/java/org/apache/commons/weaver/model/AnnotatedElements.java
index 6ae0a79..7a16d3a 100644
--- a/processor/src/main/java/org/apache/commons/weaver/model/AnnotatedElements.java
+++ b/processor/src/main/java/org/apache/commons/weaver/model/AnnotatedElements.java
@@ -30,6 +30,7 @@ import java.lang.reflect.AnnotatedElement;
* @param <T> element type
*/
public interface AnnotatedElements<T extends AnnotatedElement> extends Iterable<T> {
+
/**
* Filter by annotation type.
* @param annotationType filter
diff --git a/processor/src/main/java/org/apache/commons/weaver/model/WeaveEnvironment.java b/processor/src/main/java/org/apache/commons/weaver/model/WeaveEnvironment.java
index c50d322..0e55c56 100644
--- a/processor/src/main/java/org/apache/commons/weaver/model/WeaveEnvironment.java
+++ b/processor/src/main/java/org/apache/commons/weaver/model/WeaveEnvironment.java
@@ -33,6 +33,7 @@ import org.apache.commons.weaver.spi.Weaver;
* Encapsulates the environment in which a {@link Weaver} or {@link Cleaner} must operate.
*/
public abstract class WeaveEnvironment {
+
/**
* Represents a {@link WeaveEnvironment} resource.
*/
diff --git a/processor/src/main/java/org/apache/commons/weaver/spi/Cleaner.java b/processor/src/main/java/org/apache/commons/weaver/spi/Cleaner.java
index e73c49c..83db001 100644
--- a/processor/src/main/java/org/apache/commons/weaver/spi/Cleaner.java
+++ b/processor/src/main/java/org/apache/commons/weaver/spi/Cleaner.java
@@ -28,6 +28,7 @@ import org.apache.commons.weaver.model.WeaveEnvironment;
* Implements the {@code CLEAN} stage of the {@link WeaveLifecycle}.
*/
public interface Cleaner extends WeaveLifecycleProvider<Clean> {
+
/**
* Using the supplied {@link Scanner}, clean a {@link WeaveEnvironment}.
*
diff --git a/processor/src/main/java/org/apache/commons/weaver/spi/Weaver.java b/processor/src/main/java/org/apache/commons/weaver/spi/Weaver.java
index 7db620e..a07ff7e 100644
--- a/processor/src/main/java/org/apache/commons/weaver/spi/Weaver.java
+++ b/processor/src/main/java/org/apache/commons/weaver/spi/Weaver.java
@@ -28,6 +28,7 @@ import org.apache.commons.weaver.model.WeaveEnvironment;
* byte code enhancement in the classes.
*/
public interface Weaver extends WeaveLifecycleProvider<Weave> {
+
/**
* Using the supplied {@link Scanner}, process a {@link WeaveEnvironment}.
*
diff --git a/processor/src/main/java/org/apache/commons/weaver/utils/Providers.java b/processor/src/main/java/org/apache/commons/weaver/utils/Providers.java
index a3a572c..3d8d4bd 100644
--- a/processor/src/main/java/org/apache/commons/weaver/utils/Providers.java
+++ b/processor/src/main/java/org/apache/commons/weaver/utils/Providers.java
@@ -43,6 +43,7 @@ public final class Providers {
}
private static class SortWorker<P extends WeaveLifecycleProvider<?>> {
+
/**
* Implement {@link Providers#sort(Iterable)}.
*
diff --git a/processor/src/main/java/org/apache/commons/weaver/utils/URLArray.java b/processor/src/main/java/org/apache/commons/weaver/utils/URLArray.java
index 842ee04..0db369a 100644
--- a/processor/src/main/java/org/apache/commons/weaver/utils/URLArray.java
+++ b/processor/src/main/java/org/apache/commons/weaver/utils/URLArray.java
@@ -28,6 +28,7 @@ import java.util.stream.Stream;
* {@link URL} Array utilities.
*/
public final class URLArray {
+
/**
* Convert an {@link Iterable} of file system paths.
* @param files to convert
(commons-weaver) 01/05: Javadoc
Posted by gg...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-weaver.git
commit dc8d2d84a1a54dde2ffc2bf39ca012be6041b58f
Author: Gary Gregory <ga...@gmail.com>
AuthorDate: Sun Jan 4 15:45:56 2026 -0500
Javadoc
Add an empty line before a Javadoc comment
---
.../src/main/java/org/apache/commons/weaver/maven/AbstractCWMojo.java | 1 +
.../src/main/java/org/apache/commons/weaver/maven/PrepareMojo.java | 1 +
.../src/main/java/org/apache/commons/weaver/maven/TestPrepareMojo.java | 1 +
3 files changed, 3 insertions(+)
diff --git a/maven-plugin/src/main/java/org/apache/commons/weaver/maven/AbstractCWMojo.java b/maven-plugin/src/main/java/org/apache/commons/weaver/maven/AbstractCWMojo.java
index 048a59c..23eeb85 100644
--- a/maven-plugin/src/main/java/org/apache/commons/weaver/maven/AbstractCWMojo.java
+++ b/maven-plugin/src/main/java/org/apache/commons/weaver/maven/AbstractCWMojo.java
@@ -51,6 +51,7 @@ import org.eclipse.aether.util.filter.ScopeDependencyFilter;
* @since 1.3
*/
abstract class AbstractCWMojo extends AbstractMojo {
+
/**
* Marks a mojo as requiring dependencies in {@link JavaScopes#TEST} scope.
*/
diff --git a/maven-plugin/src/main/java/org/apache/commons/weaver/maven/PrepareMojo.java b/maven-plugin/src/main/java/org/apache/commons/weaver/maven/PrepareMojo.java
index 880e748..c5de6ea 100644
--- a/maven-plugin/src/main/java/org/apache/commons/weaver/maven/PrepareMojo.java
+++ b/maven-plugin/src/main/java/org/apache/commons/weaver/maven/PrepareMojo.java
@@ -36,6 +36,7 @@ import org.apache.maven.plugins.annotations.ResolutionScope;
requiresDependencyResolution = ResolutionScope.RUNTIME_PLUS_SYSTEM
)
public class PrepareMojo extends AbstractPrepareMojo {
+
/**
* {@link Build#getOutputDirectory()}.
*/
diff --git a/maven-plugin/src/main/java/org/apache/commons/weaver/maven/TestPrepareMojo.java b/maven-plugin/src/main/java/org/apache/commons/weaver/maven/TestPrepareMojo.java
index 1873d59..a44c044 100644
--- a/maven-plugin/src/main/java/org/apache/commons/weaver/maven/TestPrepareMojo.java
+++ b/maven-plugin/src/main/java/org/apache/commons/weaver/maven/TestPrepareMojo.java
@@ -38,6 +38,7 @@ import org.apache.maven.plugins.annotations.ResolutionScope;
)
@TestScope
public class TestPrepareMojo extends AbstractPrepareMojo {
+
/**
* {@link Build#getTestOutputDirectory()}.
*/
(commons-weaver) 03/05: Javadoc
Posted by gg...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-weaver.git
commit 7a6febed739942462607bd97e4ad07c1fbff2b92
Author: Gary Gregory <ga...@gmail.com>
AuthorDate: Sun Jan 4 15:46:10 2026 -0500
Javadoc
Add an empty line before a Javadoc comment
---
.../src/main/java/org/apache/commons/weaver/privilizer/Privilizing.java | 2 ++
1 file changed, 2 insertions(+)
diff --git a/modules/privilizer/api/src/main/java/org/apache/commons/weaver/privilizer/Privilizing.java b/modules/privilizer/api/src/main/java/org/apache/commons/weaver/privilizer/Privilizing.java
index f3de7c6..0305834 100644
--- a/modules/privilizer/api/src/main/java/org/apache/commons/weaver/privilizer/Privilizing.java
+++ b/modules/privilizer/api/src/main/java/org/apache/commons/weaver/privilizer/Privilizing.java
@@ -28,10 +28,12 @@ import java.lang.annotation.Target;
*/
@Target(ElementType.TYPE)
public @interface Privilizing {
+
/**
* Models calls to blueprint methods defined on a specific class.
*/
@interface CallTo {
+
/**
* The class owning one or more blueprint method.
* @return {@link Class}