add Metamodel.entity(String)

see #85

Author: gavinking

api/src/main/java/jakarta/persistence/metamodel/Metamodel.java

@@ -11,6 +11,7 @@
  */
 
 // Contributors:
+//     Gavin King      - 3.2
 //     Linda DeMichiel - 2.1
 //     Linda DeMichiel - 2.0
 
@@ -26,6 +27,16 @@
  */
 public interface Metamodel {
 
+    /**
+     *  Return the metamodel entity type representing the entity.
+     *  @param entityName  the name of the represented entity
+     *  @return the metamodel entity type
+     *  @throws IllegalArgumentException if not an entity
+     *  @see jakarta.persistence.Entity#name
+     *  @since 3.2
+     */
+    EntityType<?> entity(String entityName);
+
     /**
      *  Return the metamodel entity type representing the entity.
      *  @param cls  the type of the represented entity

spec/src/main/asciidoc/appendixes.adoc

@@ -137,3 +137,5 @@ Entity and embeddable classes may now be static inner classes
 Primary key classes are no longer required to be public and serializable
 
 Pulled _getParameters()_ up from _CriteriaQuery_ to _CommonAbstractCriteria_
+
+Add overload of _entity()_ accepting an entity name to _Metamodel_

spec/src/main/asciidoc/ch05-metamodel-api.adoc

@@ -38,6 +38,16 @@ import java.util.Set;
  */
 public interface Metamodel {
 
+    /**
+     *  Return the metamodel entity type representing the entity.
+     *  @param entityName  the name of the represented entity
+     *  @return the metamodel entity type
+     *  @throws IllegalArgumentException if not an entity
+     *  @see jakarta.persistence.Entity#name
+     *  @since 3.2
+     */
+    EntityType<?> entity(String entityName);
+
     /**
      *  Return the metamodel entity type representing the entity.
      *  @param cls  the type of the represented entity