(commons-email) 02/06: 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

commit 2c791c319025188ba86d5cc8fc9f66c840875efb
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 b4cc973f..b4210efe 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 0aafbffa..92487287 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;
 
@@ -1662,8 +1662,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 a0d33e2a..47d0959d 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
@@ -1661,8 +1661,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.