release 1.1.0

Author: Vitalii.Chornobryvyi

CHANGELOG.md

@@ -5,6 +5,10 @@ All _notable_ changes to this project will be documented in this file.
 The format is based on _[Keep a Changelog][keepachangelog]_, and this project
 adheres to _[Semantic Versioning][semver]_.
 
+## [1.1.0] (released: 2023-10-23)
+### Updated
+- add ability to get the first / last / next / previous page data.
+
 ## [1.0.9] (released: 2023-09-27)
 ### Updated
 - allows for appending custom MIME headers to a message
@@ -59,6 +63,7 @@ adheres to _[Semantic Versioning][semver]_.
 - Add Import a list of bounces from CSV file API
 
 
+[1.1.0]: https://github.com/mailgun/mailgun-java/compare/release/1.0.8...release/1.1.0
 [1.0.9]: https://github.com/mailgun/mailgun-java/compare/release/1.0.8...release/1.0.9
 [1.0.8]: https://github.com/mailgun/mailgun-java/compare/release/1.0.7...release/1.0.8
 [1.0.7]: https://github.com/mailgun/mailgun-java/compare/release/1.0.6...release/1.0.7

README.md

@@ -76,7 +76,7 @@ Add the following to your `pom.xml`:
   <dependency>
     <groupId>com.mailgun</groupId>
     <artifactId>mailgun-java</artifactId>
-    <version>1.0.9</version>
+    <version>1.1.0</version>
   </dependency>
   ...
 </dependencies>
@@ -85,7 +85,7 @@ Add the following to your `pom.xml`:
 Gradle Groovy DSL .
 
 ```xml
-implementation 'com.mailgun:mailgun-java:1.0.9'
+implementation 'com.mailgun:mailgun-java:1.1.0'
 ```
 
 
@@ -1632,6 +1632,62 @@ Returns the list of members in the given mailing list.
         MailingListMembersResponse response = mailgunMailingListApi.getMailingListMembers(MAILING_LIST_ADDRESS, request);
 ``` 
 
+Returns the first page of the list of members in the given mailing list.
+```java
+        MailingListMembersRequest request = MailingListMembersRequest.builder()
+                .limit(10)
+                .page("first")
+                .build();
+
+        MailingListMembersResponse response = mailgunMailingListApi.getMailingListMembers(MAILING_LIST_ADDRESS, request);
+``` 
+
+Returns the last page of the list of members in the given mailing list.
+```java
+        MailingListMembersRequest request = MailingListMembersRequest.builder()
+                .limit(10)
+                .page("last")
+                .build();
+
+        MailingListMembersResponse response = mailgunMailingListApi.getMailingListMembers(MAILING_LIST_ADDRESS, request);
+``` 
+
+Returns the next page after specified email of the list of members in the given mailing list.
+```java
+        MailingListMembersResponse response = mailgunMailingListApi.getMailingListMembers(MAILING_LIST_ADDRESS, request);
+
+        memberAddress = response.getItems().stream()
+                .reduce((first, last) -> last)
+                .orElseThrow(NoSuchElementException::new)
+                .getAddress();
+		
+        MailingListMembersRequest request = MailingListMembersRequest.builder()
+                .limit(10)
+                .page("next")
+                .address(memberAddress)
+                .build();
+
+        response = mailgunMailingListApi.getMailingListMembers(MAILING_LIST_ADDRESS, request);
+``` 
+
+Returns the previous page before specified email of the list of members in the given mailing list.
+```java
+        MailingListMembersResponse response = mailgunMailingListApi.getMailingListMembers(MAILING_LIST_ADDRESS, request);
+
+        memberAddress = response.getItems().stream()
+                .findFirst()
+                .orElseThrow(NoSuchElementException::new)
+                .getAddress();
+
+        MailingListMembersRequest request = MailingListMembersRequest.builder()
+                .limit(10)
+                .page("prev")
+                .address(memberAddress)
+                .build();
+        
+        response = mailgunMailingListApi.getMailingListMembers(MAILING_LIST_ADDRESS, request);
+``` 
+
 #### Mailing List member
 
 Retrieves a mailing list member.

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>com.mailgun</groupId>
     <artifactId>mailgun-java</artifactId>
-    <version>1.0.9</version>
+    <version>1.1.0</version>
     <packaging>jar</packaging>
 
     <name>${project.groupId}:${project.artifactId}</name>

src/main/java/com/mailgun/model/mailing/lists/MailingListMembersRequest.java

@@ -24,6 +24,20 @@ public class MailingListMembersRequest {
      */
     Integer limit;
 
+	/**
+	 * <p>
+	 * Page name: first, last, next or prev.
+	 * </p>
+	 */
+	String page;
+
+	/**
+	 * <p>
+	 * The email address after or before which the list should be returned
+	 * </p>
+	 */
+	String address;
+
     /**
      * <p>
      * <code>yes</code> to lists subscribed.