(commons-email) branch Features/EMAIL-163 updated: EMAIL-163 Support for OAuth2 authentication

[sgoeschl]

This is an automated email from the ASF dual-hosted git repository.

sgoeschl pushed a commit to branch Features/EMAIL-163
in repository https://gitbox.apache.org/repos/asf/commons-email.git


The following commit(s) were added to refs/heads/Features/EMAIL-163 by this 
push:
     new 971fa86  EMAIL-163 Support for OAuth2 authentication
971fa86 is described below

commit 971fa86cd21d1c8ba14280d7c30e816bc74766f7
Author: sgoeschl <siegfried.goes...@gmail.com>
AuthorDate: Wed May 14 21:15:22 2025 +0200

    EMAIL-163 Support for OAuth2 authentication
---
 .../src/main/java/org/apache/commons/mail2/core/EmailConstants.java   | 2 +-
 .../src/main/java/org/apache/commons/mail2/jakarta/Email.java         | 4 +---
 .../src/main/java/org/apache/commons/mail2/javax/Email.java           | 2 --
 3 files changed, 2 insertions(+), 6 deletions(-)

diff --git 
a/commons-email2-core/src/main/java/org/apache/commons/mail2/core/EmailConstants.java
 
b/commons-email2-core/src/main/java/org/apache/commons/mail2/core/EmailConstants.java
index 6103006..70bdd5d 100644
--- 
a/commons-email2-core/src/main/java/org/apache/commons/mail2/core/EmailConstants.java
+++ 
b/commons-email2-core/src/main/java/org/apache/commons/mail2/core/EmailConstants.java
@@ -56,7 +56,7 @@ public final class EmailConstants {
     /** If set to true, tries to authenticate the user using the AUTH command. 
*/
     public static final String MAIL_SMTP_AUTH = "mail.smtp.auth";
 
-    /** If set to true, tries to authenticate the user using the OAuth2. */
+    /** If set to true, tries to authenticate the user using an OAuth2 token. 
*/
     public static final String MAIL_SMTP_AUTH_MECHANISMS = 
"mail.smtp.auth.mechanisms";
 
     /** The SMTP user name. */
diff --git 
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/Email.java
 
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/Email.java
index dd64473..7745e08 100644
--- 
a/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/Email.java
+++ 
b/commons-email2-jakarta/src/main/java/org/apache/commons/mail2/jakarta/Email.java
@@ -215,7 +215,7 @@ public abstract class Email {
     private boolean startTlsRequired;
 
     /**
-     * If true, use OAuth2 for authentication.
+     * If true, use OAuth2 token for authentication.
      */
     private boolean oauth2Required;
 
@@ -1657,8 +1657,6 @@ public abstract class Email {
     /**
      * Sets or disable OAuth2 authentication.
      * <p>
-     * Defaults to {@link #smtpPort}; can be overridden by using {@link 
#setSmtpPort(int)}
-     * </p>
      *
      * @param oauth2Required true if OAUth2 authentication is required, false 
otherwise
      * @return An Email.
diff --git 
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/Email.java 
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/Email.java
index 8cccb4b..960f563 100644
--- 
a/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/Email.java
+++ 
b/commons-email2-javax/src/main/java/org/apache/commons/mail2/javax/Email.java
@@ -1656,8 +1656,6 @@ public abstract class Email {
     /**
      * Sets or disable OAuth2 authentication.
      * <p>
-     * Defaults to {@link #smtpPort}; can be overridden by using {@link 
#setSmtpPort(int)}
-     * </p>
      *
      * @param oauth2Required true if OAUth2 authentication is required, false 
otherwise
      * @return An Email.