docs: create documentation to builder supplier

Signed-off-by: Otavio Santana <otaviopolianasantana@gmail.com>

jnosql-mapping/jnosql-mapping-core/src/main/java/org/eclipse/jnosql/mapping/reflection/ConstructorBuilder.java

@@ -15,9 +15,13 @@
 package org.eclipse.jnosql.mapping.reflection;
 
 
+import jakarta.nosql.NoSQLException;
 import org.eclipse.jnosql.mapping.metadata.ParameterMetaData;
 
 import java.util.List;
+import java.util.Objects;
+import java.util.Optional;
+import java.util.ServiceLoader;
 
 /**
  * The ConstructorBuilder interface provides a way to create an entity from a constructor.
@@ -55,4 +59,16 @@ public interface ConstructorBuilder {
      */
     <T> T build();
 
+    /**
+     *  Creates a new instance of the {@link ConstructorBuilder} interface using the provided
+     *  * {@link ConstructorMetadata}.
+     * @param constructor the constructor
+     * @return the ConstructorBuilder instance
+     */
+    static ConstructorBuilder of(ConstructorMetadata constructor){
+        Objects.requireNonNull(constructor, "constructor is required");
+        var supplier = ServiceLoader.load(ConstructorBuilderSupplier.class).findFirst()
+                .orElseThrow(() -> new NoSQLException("There is not implementation for the ConstructorBuilderSupplier"));
+        return supplier.apply(constructor);
+    }
 }

jnosql-mapping/jnosql-mapping-core/src/main/java/org/eclipse/jnosql/mapping/reflection/ConstructorBuilderSupplier.java

@@ -0,0 +1,23 @@
+/*
+ *  Copyright (c) 2023 Contributors to the Eclipse Foundation
+ *   All rights reserved. This program and the accompanying materials
+ *   are made available under the terms of the Eclipse Public License v1.0
+ *   and Apache License v2.0 which accompanies this distribution.
+ *   The Eclipse Public License is available at http://www.eclipse.org/legal/epl-v10.html
+ *   and the Apache License v2.0 is available at http://www.opensource.org/licenses/apache2.0.php.
+ *
+ *   You may elect to redistribute this code under either of these licenses.
+ *
+ *   Contributors:
+ *
+ *   Otavio Santana
+ */
+package org.eclipse.jnosql.mapping.reflection;
+
+import java.util.function.Function;
+
+/**
+ * A supplier that create a ConstructorBuilder from the ConstructorMetadata.
+ */
+public interface ConstructorBuilderSupplier extends Function<ConstructorMetadata, ConstructorBuilder> {
+}