aboutsummaryrefslogtreecommitdiffstats
path: root/pf4j
diff options
context:
space:
mode:
authorDecebal Suiu <decebal.suiu@gmail.com>2019-11-13 19:46:08 +0200
committerDecebal Suiu <decebal.suiu@gmail.com>2019-11-13 19:46:08 +0200
commite6093a313b8d4970dfe2826bd539c777e51c9aef (patch)
tree75d01ee78671ac81b1416ff0abc7b0fca42a9a63 /pf4j
parent0652d7945db4ec0b10fea03e2949cc1960d05992 (diff)
downloadpf4j-e6093a313b8d4970dfe2826bd539c777e51c9aef.tar.gz
pf4j-e6093a313b8d4970dfe2826bd539c777e51c9aef.zip
Add javadoc
Diffstat (limited to 'pf4j')
-rw-r--r--pf4j/src/main/java/org/pf4j/processor/ExtensionAnnotationProcessor.java6
-rw-r--r--pf4j/src/main/java/org/pf4j/processor/ExtensionStorage.java4
-rw-r--r--pf4j/src/main/java/org/pf4j/processor/LegacyExtensionStorage.java2
-rw-r--r--pf4j/src/main/java/org/pf4j/processor/ServiceProviderExtensionStorage.java2
4 files changed, 14 insertions, 0 deletions
diff --git a/pf4j/src/main/java/org/pf4j/processor/ExtensionAnnotationProcessor.java b/pf4j/src/main/java/org/pf4j/processor/ExtensionAnnotationProcessor.java
index 55bbbc2..e8629bc 100644
--- a/pf4j/src/main/java/org/pf4j/processor/ExtensionAnnotationProcessor.java
+++ b/pf4j/src/main/java/org/pf4j/processor/ExtensionAnnotationProcessor.java
@@ -40,6 +40,11 @@ import java.util.Set;
import java.util.TreeSet;
/**
+ * Processes {@link Extension} annotations and generates an {@link ExtensionStorage}.
+ * You can specify the concrete {@link ExtensionStorage} via processor's environment options
+ * ({@link ProcessingEnvironment#getOptions()}) or system property.
+ * In both variants the option/property name is {@code pf4j.storageClassName}.
+ *
* @author Decebal Suiu
*/
public class ExtensionAnnotationProcessor extends AbstractProcessor {
@@ -241,4 +246,5 @@ public class ExtensionAnnotationProcessor extends AbstractProcessor {
return storage;
}
+
}
diff --git a/pf4j/src/main/java/org/pf4j/processor/ExtensionStorage.java b/pf4j/src/main/java/org/pf4j/processor/ExtensionStorage.java
index 5088068..20a684f 100644
--- a/pf4j/src/main/java/org/pf4j/processor/ExtensionStorage.java
+++ b/pf4j/src/main/java/org/pf4j/processor/ExtensionStorage.java
@@ -21,6 +21,10 @@ import java.util.Map;
import java.util.Set;
/**
+ * It's a storage (database) that persists {@link org.pf4j.Extension}s.
+ * The standard operations supported by storage are {@link #read} and {@link #write}.
+ * The storage is populated by {@link ExtensionAnnotationProcessor}.
+ *
* @author Decebal Suiu
*/
public abstract class ExtensionStorage {
diff --git a/pf4j/src/main/java/org/pf4j/processor/LegacyExtensionStorage.java b/pf4j/src/main/java/org/pf4j/processor/LegacyExtensionStorage.java
index 3f9c61b..38ebfb5 100644
--- a/pf4j/src/main/java/org/pf4j/processor/LegacyExtensionStorage.java
+++ b/pf4j/src/main/java/org/pf4j/processor/LegacyExtensionStorage.java
@@ -31,6 +31,8 @@ import java.util.Set;
import java.util.regex.Pattern;
/**
+ * Stores {@link org.pf4j.Extension}s in {@code META-INF/extensions.idx}.
+ *
* @author Decebal Suiu
*/
public class LegacyExtensionStorage extends ExtensionStorage {
diff --git a/pf4j/src/main/java/org/pf4j/processor/ServiceProviderExtensionStorage.java b/pf4j/src/main/java/org/pf4j/processor/ServiceProviderExtensionStorage.java
index b087a4e..7e07cd0 100644
--- a/pf4j/src/main/java/org/pf4j/processor/ServiceProviderExtensionStorage.java
+++ b/pf4j/src/main/java/org/pf4j/processor/ServiceProviderExtensionStorage.java
@@ -31,6 +31,8 @@ import java.util.Set;
import java.util.regex.Pattern;
/**
+ * Stores {@link org.pf4j.Extension}s in {@code META-INF/services}.
+ *
* @author Decebal Suiu
*/
public class ServiceProviderExtensionStorage extends ExtensionStorage {