Sync documentation of main branch

Author: actions-user

_versions/main/guides/hibernate-orm-panache.adoc

@@ -223,6 +223,9 @@ List<Person> allPersons = Person.listAll();
 // finding a specific person by ID
 person = Person.findById(personId);
 
+// finding specific persons by their IDs
+List<Person> personsById = Person.findByIds(List.of(personId1, personId2));
+
 // finding a specific person by ID via an Optional
 Optional<Person> optional = Person.findByIdOptional(personId);
 person = optional.orElseThrow(() -> new NotFoundException());
@@ -441,6 +444,9 @@ List<Person> allPersons = personRepository.listAll();
 // finding a specific person by ID
 person = personRepository.findById(personId);
 
+// finding specific persons by their IDs
+List<Person> personsById = personRepository.findByIds(List.of(personId1, personId2);
+
 // finding a specific person by ID via an Optional
 Optional<Person> optional = personRepository.findByIdOptional(personId);
 person = optional.orElseThrow(() -> new NotFoundException());

_versions/main/guides/mongodb-panache.adoc

@@ -205,6 +205,11 @@ List<Person> allPersons = Person.listAll();
 ObjectId personId = new ObjectId(idAsString);
 person = Person.findById(personId);
 
+// finding a specific persons by their ID
+ObjectId personId1 = new ObjectId(id1AsString);
+ObjectId personId2 = new ObjectId(id2AsString);
+List<Person> person = Person.findByIds(List.of(personId1, personId2);
+
 // finding a specific person by ID via an Optional
 Optional<Person> optional = Person.findByIdOptional(personId);
 person = optional.orElseThrow(() -> new NotFoundException());
@@ -373,6 +378,11 @@ List<Person> allPersons = personRepository.listAll();
 ObjectId personId = new ObjectId(idAsString);
 person = personRepository.findById(personId);
 
+// finding a specific persons by their ID
+ObjectId personId1 = new ObjectId(id1AsString);
+ObjectId personId2 = new ObjectId(id2AsString);
+List<Person> person = personRepository.findByIds(List.of(personId1, personId2);
+
 // finding a specific person by ID via an Optional
 Optional<Person> optional = personRepository.findByIdOptional(personId);
 person = optional.orElseThrow(() -> new NotFoundException());
@@ -863,7 +873,7 @@ data class Person (
 
 [IMPORTANT]
 ====
-Unlike the @BsonCreator approach, `val` cannot be used here. Properties must be defined as `var`, otherwise, the system creates an object with 
+Unlike the @BsonCreator approach, `val` cannot be used here. Properties must be defined as `var`, otherwise, the system creates an object with
 `null` values for every property.
 ====
 
@@ -935,6 +945,11 @@ Uni<List<ReactivePerson>> allPersons = ReactivePerson.listAll();
 ObjectId personId = new ObjectId(idAsString);
 Uni<ReactivePerson> personById = ReactivePerson.findById(personId);
 
+// finding a specific persons by their ID
+ObjectId personId1 = new ObjectId(id1AsString);
+ObjectId personId2 = new ObjectId(id2AsString);
+Uni<List<Person>> person = ReactivePerson.findByIds(List.of(personId1, personId2);
+
 // finding a specific person by ID via an Optional
 Uni<Optional<ReactivePerson>> optional = ReactivePerson.findByIdOptional(personId);
 personById = optional.map(o -> o.orElseThrow(() -> new NotFoundException()));