typed analyzers javadoc

Author: rashtao

src/main/java/com/arangodb/entity/arangosearch/AnalyzerFeature.java

@@ -22,7 +22,23 @@
 
 /**
  * @author Michele Rastelli
+ * @see <a href= "https://www.arangodb.com/docs/stable/arangosearch-analyzers.html#analyzer-features">API Documentation</a>
  */
 public enum AnalyzerFeature {
-    frequency, norm, position
+
+    /**
+     * how often a term is seen, required for PHRASE()
+     */
+    frequency,
+
+    /**
+     * the field normalization factor
+     */
+    norm,
+
+    /**
+     * sequentially increasing term position, required for PHRASE(). If present then the frequency feature is also required
+     */
+    position
+
 }

src/main/java/com/arangodb/entity/arangosearch/analyzer/DelimiterAnalyzer.java

@@ -26,7 +26,10 @@
 import java.util.Objects;
 
 /**
+ * An Analyzer capable of breaking up delimited text into tokens as per RFC 4180 (without starting new records on newlines).
+ *
  * @author Michele Rastelli
+ * @see <a href= "https://www.arangodb.com/docs/stable/arangosearch-analyzers.html#delimiter">API Documentation</a>
  */
 public class DelimiterAnalyzer extends SearchAnalyzer {
     public DelimiterAnalyzer() {

src/main/java/com/arangodb/entity/arangosearch/analyzer/DelimiterAnalyzerProperties.java

@@ -30,6 +30,9 @@ public class DelimiterAnalyzerProperties {
 
     private String delimiter;
 
+    /**
+     * @return the delimiting character(s)
+     */
     public String getDelimiter() {
         return delimiter;
     }

src/main/java/com/arangodb/entity/arangosearch/analyzer/EdgeNgram.java

@@ -31,6 +31,9 @@ public class EdgeNgram {
     private long max;
     private boolean preserveOriginal;
 
+    /**
+     * @return minimal n-gram length
+     */
     public long getMin() {
         return min;
     }
@@ -39,6 +42,9 @@ public void setMin(long min) {
         this.min = min;
     }
 
+    /**
+     * @return maximal n-gram length
+     */
     public long getMax() {
         return max;
     }
@@ -47,6 +53,9 @@ public void setMax(long max) {
         this.max = max;
     }
 
+    /**
+     * @return whether to include the original token even if its length is less than min or greater than max
+     */
     public boolean isPreserveOriginal() {
         return preserveOriginal;
     }

src/main/java/com/arangodb/entity/arangosearch/analyzer/IdentityAnalyzer.java

@@ -24,7 +24,10 @@
 import com.arangodb.entity.arangosearch.AnalyzerType;
 
 /**
+ * An Analyzer applying the identity transformation, i.e. returning the input unmodified.
+ *
  * @author Michele Rastelli
+ * @see <a href= "https://www.arangodb.com/docs/stable/arangosearch-analyzers.html#identity">API Documentation</a>
  */
 public class IdentityAnalyzer extends SearchAnalyzer {
     public IdentityAnalyzer() {

src/main/java/com/arangodb/entity/arangosearch/analyzer/NGramAnalyzer.java

@@ -26,7 +26,15 @@
 import java.util.Objects;
 
 /**
+ * An Analyzer capable of producing n-grams from a specified input in a range of min..max (inclusive). Can optionally
+ * preserve the original input.
+ * <p>
+ * This Analyzer type can be used to implement substring matching. Note that it slices the input based on bytes and not
+ * characters by default (streamType). The “binary” mode supports single-byte characters only; multi-byte UTF-8
+ * characters raise an Invalid UTF-8 sequence query error.
+ *
  * @author Michele Rastelli
+ * @see <a href= "https://www.arangodb.com/docs/stable/arangosearch-analyzers.html#n-gram">API Documentation</a>
  */
 public class NGramAnalyzer extends SearchAnalyzer {
     public NGramAnalyzer() {

src/main/java/com/arangodb/entity/arangosearch/analyzer/NGramAnalyzerProperties.java

@@ -24,7 +24,15 @@
 import java.util.Objects;
 
 /**
+ * An Analyzer capable of producing n-grams from a specified input in a range of min..max (inclusive). Can optionally
+ * preserve the original input.
+ * <p>
+ * This Analyzer type can be used to implement substring matching. Note that it slices the input based on bytes and not
+ * characters by default (streamType). The “binary” mode supports single-byte characters only; multi-byte UTF-8
+ * characters raise an Invalid UTF-8 sequence query error.
+ *
  * @author Michele Rastelli
+ * @see <a href= "https://www.arangodb.com/docs/stable/arangosearch-analyzers.html#n-gram">API Documentation</a>
  */
 public class NGramAnalyzerProperties {
 
@@ -41,6 +49,9 @@ public NGramAnalyzerProperties() {
         streamType = StreamType.binary;
     }
 
+    /**
+     * @return minimum n-gram length
+     */
     public long getMin() {
         return min;
     }
@@ -49,6 +60,9 @@ public void setMin(long min) {
         this.min = min;
     }
 
+    /**
+     * @return maximum n-gram length
+     */
     public long getMax() {
         return max;
     }
@@ -57,6 +71,10 @@ public void setMax(long max) {
         this.max = max;
     }
 
+    /**
+     * @return <code>true</code> to include the original value as well
+     *         <code>false</code> to produce the n-grams based on min and max only
+     */
     public boolean isPreserveOriginal() {
         return preserveOriginal;
     }
@@ -65,6 +83,10 @@ public void setPreserveOriginal(boolean preserveOriginal) {
         this.preserveOriginal = preserveOriginal;
     }
 
+    /**
+     * @return this value will be prepended to n-grams which include the beginning of the input. Can be used for
+     * matching prefixes. Choose a character or sequence as marker which does not occur in the input
+     */
     public String getStartMarker() {
         return startMarker;
     }
@@ -73,6 +95,10 @@ public void setStartMarker(String startMarker) {
         this.startMarker = startMarker;
     }
 
+    /**
+     * @return this value will be appended to n-grams which include the end of the input. Can be used for matching
+     * suffixes. Choose a character or sequence as marker which does not occur in the input.
+     */
     public String getEndMarker() {
         return endMarker;
     }

src/main/java/com/arangodb/entity/arangosearch/analyzer/NormAnalyzer.java

@@ -26,7 +26,10 @@
 import java.util.Objects;
 
 /**
+ * An Analyzer capable of normalizing the text, treated as a single token, i.e. case conversion and accent removal.
+ *
  * @author Michele Rastelli
+ * @see <a href= "https://www.arangodb.com/docs/stable/arangosearch-analyzers.html#norm">API Documentation</a>
  */
 public class NormAnalyzer extends SearchAnalyzer {
     public NormAnalyzer() {

src/main/java/com/arangodb/entity/arangosearch/analyzer/NormAnalyzerProperties.java

@@ -37,6 +37,11 @@ public class NormAnalyzerProperties {
     @SerializedName("case")
     private SearchAnalyzerCase analyzerCase;
 
+    /**
+     * @return a locale in the format `language[_COUNTRY][.encoding][@variant]` (square brackets denote optional parts),
+     * e.g. `de.utf-8` or `en_US.utf-8`. Only UTF-8 encoding is meaningful in ArangoDB.
+     * @see <a href= "https://www.arangodb.com/docs/stable/arangosearch-analyzers.html#supported-languages">Supported Languages</a>
+     */
     public String getLocale() {
         return locale;
     }
@@ -45,6 +50,10 @@ public void setLocale(String locale) {
         this.locale = locale;
     }
 
+    /**
+     * @return <code>true</code> to preserve accented characters (default)
+     *         <code>false</code> to convert accented characters to their base characters
+     */
     public boolean isAccent() {
         return accent;
     }

src/main/java/com/arangodb/entity/arangosearch/analyzer/SearchAnalyzer.java

@@ -35,6 +35,9 @@ public abstract class SearchAnalyzer {
     private AnalyzerType type;
     private Set<AnalyzerFeature> features;
 
+    /**
+     * @return The Analyzer name.
+     */
     public String getName() {
         return name;
     }
@@ -43,6 +46,9 @@ public void setName(String name) {
         this.name = name;
     }
 
+    /**
+     * @return The Analyzer type.
+     */
     public AnalyzerType getType() {
         return type;
     }
@@ -51,6 +57,9 @@ public void setType(AnalyzerType type) {
         this.type = type;
     }
 
+    /**
+     * @return The set of features to set on the Analyzer generated fields.
+     */
     public Set<AnalyzerFeature> getFeatures() {
         return features;
     }