Javadoc fixes

specs/src/main/java/org/seedstack/business/domain/Entity.java

@@ -12,15 +12,13 @@
  * It is not defined primarily by its attributes but by its identity that stays the same through time and across
  * distinct representations.
  *
- * <p>
  * The identity of an entity must be unique and immutable. It must be chosen carefully and well defined in the model.
  * Identification can come from:
  * <ul>
  * <li>The outside: a user of the system can provide the identity, handling the uniqueness himself.</li>
  * <li>The inside: the entity can generate its own identity using an algorithm.</li>
  * <li>An {@link IdentityGenerator}.</li>
  * </ul>
- * </p>
  *
  * <p>
  * An entity should not be merely a holder of attributes, but should also contain the behavior that is directly relevant to
@@ -37,6 +35,7 @@
  *
  * <p>
  * Example:
+ * </p>
  * <pre>
  * public class SomeEntity implements Entity&lt;SomeEntityId&gt; {
  *     private SomeEntityId id;
@@ -63,7 +62,6 @@
  *     // Other methods
  * }
  * </pre>
- * </p>
  *
  * @param <ID> the type of the entity identifier.
  */

specs/src/main/java/org/seedstack/business/domain/ValueObject.java

@@ -39,6 +39,7 @@
  *
  * <p>
  * Example:
+ * </p>
  * <pre>
  * public class SomeValueObject implements ValueObject {
  *     private String attribute1;
@@ -62,9 +63,21 @@
  *     // Other methods
  * }
  * </pre>
- * </p>
  */
 @DomainValueObject
 public interface ValueObject extends Producible {
+    /**
+     * As per Domain-Driven Design semantics, value object equality must be computed on all its attributes.
+     *
+     * @param other other object.
+     * @return true if the other object is of the same class as this value object and if all attributes are equals, false otherwise.
+     */
+    boolean equals(Object other);
 
+    /**
+     * As per Domain-Driven Design semantics, the hash code of a value object must be computed on all its attributes.
+     *
+     * @return a hash code value for this value object.
+     */
+    int hashCode();
 }

specs/src/main/java/org/seedstack/business/specification/dsl/SpecificationBuilder.java

@@ -16,13 +16,13 @@
  *
  * <p>
  * Examples of formulae in DNF:
+ * </p>
  * <ul>
  * <li>(A ∧ ¬B ∧ ¬C) ∨ (¬D ∧ E ∧ F)</li>
  * <li>(A ∧ B) ∨ C</li>
  * <li>A ∧ B</li>
  * <li>A</li>
  * </ul>
- * </p>
  */
 public interface SpecificationBuilder {
     /**

specs/src/main/java/org/seedstack/business/specification/dsl/SpecificationPicker.java

@@ -46,6 +46,7 @@ public interface SpecificationPicker<T, SELECTOR extends BaseSelector> {
      * Picks a general purpose equality specification that will be satisfied if the current selection equals to the specified value.
      *
      * @param value the value to be equal to.
+     * @param <V>   the type of the value.
      * @return the next operation of the builder DSL, allowing to combine this specification with another one.
      */
     <V> OperatorPicker<T, SELECTOR> equalTo(V value);
@@ -55,6 +56,7 @@ public interface SpecificationPicker<T, SELECTOR extends BaseSelector> {
      * specified value.
      *
      * @param value the value to be greater than.
+     * @param <V>   the type of the value.
      * @return the next operation of the builder DSL, allowing to combine this specification with another one.
      */
     <V extends Comparable<? super V>> OperatorPicker<T, SELECTOR> greaterThan(V value);
@@ -64,6 +66,7 @@ public interface SpecificationPicker<T, SELECTOR extends BaseSelector> {
      * equal to the specified value.
      *
      * @param value the value to be greater than or equal to.
+     * @param <V>   the type of the value.
      * @return the next operation of the builder DSL, allowing to combine this specification with another one.
      */
     <V extends Comparable<? super V>> OperatorPicker<T, SELECTOR> greaterThanOrEqualTo(V value);
@@ -73,6 +76,7 @@ public interface SpecificationPicker<T, SELECTOR extends BaseSelector> {
      * specified value.
      *
      * @param value the value to be less than.
+     * @param <V>   the type of the value.
      * @return the next operation of the builder DSL, allowing to combine this specification with another one.
      */
     <V extends Comparable<? super V>> OperatorPicker<T, SELECTOR> lessThan(V value);
@@ -82,6 +86,7 @@ public interface SpecificationPicker<T, SELECTOR extends BaseSelector> {
      * equal to the specified value.
      *
      * @param value the value to be less than or equal to.
+     * @param <V>   the type of the value.
      * @return the next operation of the builder DSL, allowing to combine this specification with another one.
      */
     <V extends Comparable<? super V>> OperatorPicker<T, SELECTOR> lessThanOrEqualTo(V value);
@@ -92,6 +97,7 @@ public interface SpecificationPicker<T, SELECTOR extends BaseSelector> {
      *
      * @param leftValue  the value to be greater than.
      * @param rightValue the value to be less than.
+     * @param <V>        the type of the value.
      * @return the next operation of the builder DSL, allowing to combine this specification with another one.
      */
     <V extends Comparable<? super V>> OperatorPicker<T, SELECTOR> between(V leftValue, V rightValue);
@@ -104,6 +110,7 @@ public interface SpecificationPicker<T, SELECTOR extends BaseSelector> {
      * @param rightValue     the value to be less than  (or equal to if rightInclusive is true).
      * @param leftInclusive  if true, the leftValue argument will be included in the interval, otherwise it will be excluded.
      * @param rightInclusive if true, the rightValue argument will be included in the interval, otherwise it will be excluded.
+     * @param <V>            the type of the value.
      * @return the next operation of the builder DSL, allowing to combine this specification with another one.
      */
     <V extends Comparable<? super V>> OperatorPicker<T, SELECTOR> between(V leftValue, V rightValue, boolean leftInclusive, boolean rightInclusive);

specs/src/main/java/org/seedstack/business/spi/GenericImplementation.java

@@ -50,7 +50,7 @@
  * public class SomeClass {
  *     {@literal @}Inject
  *     {@literal @}SomeQualifier
- *      private Repository<SomeAggregate, SomeId&gt someAggregateRepository;
+ *      private Repository<SomeAggregate, SomeId> someAggregateRepository;
  * }
  * </pre>
  */