-
Notifications
You must be signed in to change notification settings - Fork 112
/
RELEASE-NOTES.txt
519 lines (352 loc) · 19 KB
/
RELEASE-NOTES.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
Apache Commons Email Parent POM 2.0.0-M1
RELEASE NOTES
The Apache Commons Email Parent POM team is pleased to announce the release of Apache Commons Email Parent POM 2.0.0-M1.
Apache Commons Email provides an API for sending email, simplifying the JavaMail API.
Feature release (Java 8 or above).
For complete information on Apache Commons Email Parent POM, including instructions on how to submit bug reports,
patches, or suggestions for improvement, see the Apache Commons Email Parent POM website:
https://commons.apache.org/proper/commons-email/
Download page: https://commons.apache.org/proper/commons-email/download_net.cgi
Changes in this version
-----------------------
New features
------------
* Split into a multi-module project for javax vs. jakarta. Thanks to Gary Gregory.
* Add Maven property project.build.outputTimestamp for build reproducibility. Thanks to Gary Gregory.
Fixed Bugs
----------
* Fix Checkstyle configuration. Thanks to Gary Gregory.
* Fix PMD UnnecessaryFullyQualifiedName issues. Thanks to Gary Gregory.
Changes
-------
* Bump org.slf4j:slf4j-jdk14 from 2.0.9 to 2.0.13 #238. Thanks to Dependabot.
* Bump com.github.davidmoten:subethasmtp from 6.0.7 to 7.1.1 #252. Thanks to Dependabot.
* Bump org.mockito:mockito-core from 5.8.0 to 5.12.0 #222, #251. Thanks to Dependabot.
* Bump commons-parent from 65 to 71 #233. Thanks to Gary Gregory.
* Bump commons-io:commons-io from 2.15.1 to 2.16.1 #231, #236. Thanks to Dependabot.
Historical list of changes: https://commons.apache.org/proper/commons-email/changes-report.html
Enjoy!
- The Apache Commons Team
-----------------------------------------------------------------------------
Apache Commons Email Parent POM 2.0.0-M1-SNAPSHOT
RELEASE NOTES
The Apache Commons Email Parent POM team is pleased to announce the release of Apache Commons Email Parent POM 2.0.0-M1-SNAPSHOT.
Apache Commons Email provides an API for sending email, simplifying the JavaMail API.
Feature release (Java 8 or above).
For complete information on Apache Commons Email Parent POM, including instructions on how to submit bug reports,
patches, or suggestions for improvement, see the Apache Commons Email Parent POM website:
https://commons.apache.org/proper/commons-email/
Download page: https://commons.apache.org/proper/commons-email/download_net.cgi
Changes in this version
----------------------
New features
------------
* Add Maven property project.build.outputTimestamp for build reproducibility. Thanks to Gary Gregory.
Fixed Bugs
----------
* Fix Checkstyle configuration. Thanks to Gary Gregory.
Changes
-------
* Bump org.slf4j:slf4j-jdk14 from 2.0.9 to 2.0.12. Thanks to Dependabot.
* Bump com.github.davidmoten:subethasmtp from 6.0.7 to 7.0.1. Thanks to Dependabot.
* Bump org.mockito:mockito-core from 5.8.0 to 5.10.0. Thanks to Dependabot.
* Bump commons-parent from 65 to 66. Thanks to Gary Gregory.
Historical list of changes: https://commons.apache.org/proper/commons-email/changes-report.html
Enjoy!
-Apache Commons Net team
------------------------------------------------------------------------
Apache Commons Email 1.6.0
RELEASE NOTES
The Apache Commons Email team is pleased to announce the release of Apache Commons Email 1.6.0.
Apache Commons Email provides an API for sending email, simplifying the JavaMail API.
Feature release (Java 8 or above).
For complete information on Apache Commons Email, including instructions on how to submit bug reports,
patches, or suggestions for improvement, see the Apache Commons Email website:
https://commons.apache.org/proper/commons-email/
Download page: https://commons.apache.org/proper/commons-email/download_net.cgi
Changes in this version include:
===============================
New features
------------
* Add github/codeql-action #75. Thanks to Dependabot.
* Add Maven plugin JapiCmp and remove Clirr. Thanks to Gary Gregory.
o EMAIL-176: Add Automatic-Module-Name MANIFEST entry for Java 9 compatibility.
o EMAIL-207: Add InputStreamDataSource. Thanks to Lee Jaeheon, Gary Gregory.
o EMAIL-207: Don't waste memory in MimeMessageParser#createDataSource(). Thanks to Lee Jaeheon, Gary Gregory.
* Add EmailConstants.SOCKET_TIMEOUT and deprecate SOCKET_TIMEOUT_MS. Thanks to Gary Gregory.
* Add Email.setSocketConnectionTimeout(Duration) and deprecate setSocketConnectionTimeout(int). Thanks to Gary Gregory.
* Add Email.setSocketTimeout(Duration) and deprecate setSocketTimeout(int). Thanks to Gary Gregory.
* Add PathDataSource. Thanks to Gary Gregory.
* Add DataSourcePathResolver. Thanks to Gary Gregory.
* Add MimeMessageUtils.createMimeMessage(Session, Path, OpenOption...). Thanks to Gary Gregory.
* Add MultiPartEmail.attach(Path, OpenOption...). Thanks to Gary Gregory.
Fixed Bugs
----------
o EMAIL-190: Fix broken JDK 9 build by updating "easymock" and other dependencies. Thanks to sgoeschl.
* Use JUnit 5 APIs #106, #108, #109, #114. Thanks to John Patrick, Gary Gregory.
* [StepSecurity] ci: Harden GitHub Actions #149. Thanks to step-security-bot, Gary Gregory.
* Better use of JUnit APIs #158. Thanks to Lee Jaeheon, sebbASF.
o EMAIL-205: Update conversion code #153. Thanks to Dimitrios Efthymiou, Alex Herbert.
* Email.setBounceAddress no longer accepts invalid email addresses. Thanks to Alexander Lehmann.
* Throw more specific exceptions in MimeMessageParser #11. Thanks to Amir Behnam, Michael Osipov.
* Email.setMailSession(Session) throws the more precise exception NullPointerException. Thanks to Gary Gregory.
* Avoid possible NullPointerException in DataSourceClassPathResolver.resolve(String, boolean). Thanks to Gary Gregory.
* Complete half-baked test DataSourceUrlResolverTest.testResolvingHttpNonLenient(). Thanks to Gary Gregory.
o EMAIL-206: Use SharedByteArrayInputStream for memory usage #157. Thanks to Lee Jaeheon, Gary Gregory.
* Migrate to JUnit 5 #186. Thanks to Loki-Afro, Gary Gregory.
o EMAIL-174: Bump javax.mail dependency to 1.6.1, so that i18n is supported for email addresses. Thanks to Vegard Stuen.
* Add missing getters and setters in EMail and subclasses; deprecate access to protected instance variables. Thanks to Loki-Afro, Gary Gregory.
* DataSourceUrlResolver.resolve(String, boolean) leaks InputStreams. Thanks to Gary Gregory.
* Use US-ASCII in MimeMessageUtils.createMimeMessage(Session, String). Thanks to Gary Gregory.
Changes
-------
* Bump org.slf4j:slf4j-jdk14 from 1.7.7 to 2.0.9 #165. Thanks to Dependabot.
* Bump mockito-core from 4.11.0 to 5.8.0 #187. Thanks to Dependabot.
* Bump actions/cache from 2 to 3.0.11 #39, #48, #60, #70, #102. Thanks to Dependabot, Gary Gregory.
* Bump actions/checkout from 1 to 3.2.0, #25 #33, #67, #99, #117. Thanks to Dependabot, Gary Gregory.
* Bump actions/setup-java from 1.4.0 to v3.6.0 #30, #74, #103. Thanks to Dependabot, Gary Gregory.
* Bump actions/upload-artifact from 3.1.0 to 3.1.1 #110. Thanks to Dependabot.
o EMAIL-177: Bump from Java 6 to 7. Thanks to Gary Gregory.
* Bump from Java 7 to 8. Thanks to Gary Gregory.
o EMAIL-183: Bump javax.mail:1.6.1 to jakarta.mail:1.6.7. Thanks to Lukas Petrovicky, gitmotte, Dependabot, Gary Gregory.
* Bump commons-parent from 50 to 65, #118, #128. Thanks to Gary Gregory, Dependabot.
* Bump spotbugs-maven-plugin from 4.0.0 to 4.7.2 #18. Thanks to Dependabot, Gary Gregory.
* Bump spotbugs from 4.0.6 to 4.7.2 #40. Thanks to Dependabot.
* Bump junit from 4.13 to 4.13.2 #32. Thanks to Dependabot, Gary Gregory.
* Bump commons-release-plugin from 1.0 to 1.7 #23. Thanks to Dependabot.
* Bump maven-pmd-plugin from 3.13.0 to 3.19.0 #34, #72, #79, #94. Thanks to Dependabot.
* Bump tests commons-io:commons-io 2.6 to 2.15.1. Thanks to Gary Gregory.
* Bump jacoco from 0.8.6 to 0.8.8; fixes jacoco on Java 17. Thanks to Gary Gregory.
* Bump org.easymock:easymock from 4.2 to 5.2.0, #107, #164. Thanks to Gary Gregory.
* Bump commons-release-plugin from 1.7 to 1.8.1 #73, #184. Thanks to Dependabot.
* Bump maven-checkstyle-plugin from 3.1.2 to 3.2.0 #87. Thanks to Dependabot.
Historical list of changes: https://commons.apache.org/proper/commons-email/changes-report.html
Enjoy!
-Apache Commons Net team
------------------------------------------------------------------------
Commons Email Package
Version 1.5
Release Notes
INTRODUCTION
------------
Commons Email aims to provide a API for sending email. It builds on the JavaMail
API with the aim of presenting a simplified API which is easy for developers who
are not mail experts to use. It is a compact component with a small number of
classes.
The Commons Email website is the source for the most recent information,
downloads, reports, and bug status:
http://commons.apache.org/email/
This is a major release which adds some new features and fixes several bugs
present in the 1.4.0 release. All current users are encouraged to upgrade.
CHANGES FROM 1.4
----------------
Compatibility
-------------
* Java 6 or later is required.
* JavaMail dependency has been upgraded to version 1.5.6,
as a consequence, the maven dependency has changed to:
<dependency>
<groupId>com.sun.mail</groupId>
<artifactId>javax.mail</artifactId>
<version>1.5.6</version>
</dependency>
New Features
------------
* Add Support for International Domain Names. This change requires JDK 1.6+.
Issue: EMAIL-160
* Add Email#getHeader(String) and Email#getHeaders() methods.
Issue: EMAIL-154. Thanks to Ken Geis, Balachandran Sivakumar
Updates
-------
* Update Oracle JavaMail dependency from 1.5.2 to 1.5.6.
Issue: EMAIL-165.
* Remove "javax.activation" dependency since it is included in JDK 1.6
Issue: EMAIL-161.
Fixed Bugs
----------
* DataSourceClassPathResolver doesn't close InputStream when resolving resources
Issue: EMAIL-167. Thanks to Lucian Burja.
CHANGES FROM 1.3.3
------------------
Compatibility
-------------
* Java 5 or later is required (unchanged since 1.3).
* JavaMail dependency has been upgraded to version 1.5.2,
as a consequence, the maven dependency has changed to:
<dependency>
<groupId>com.sun.mail</groupId>
<artifactId>javax.mail</artifactId>
<version>1.5.2</version>
</dependency>
== New Features ==
* Added getter for the bounce address of an email to class Email.
Issue: EMAIL-146. Thanks to Alexander Lehmann.
* Added support for mapping of content-ids to DataSource in "MimeMessageParser".
Issue: EMAIL-141. Thanks to Stephen Kruger.
== Updates ==
* Update Oracle JavaMail dependency from 1.4.5 to 1.5.2.
Issue: EMAIL-144.
Fixed Bugs
----------
* "Email" threw an "EmailException" when trying to send the email if neither a from
nor bounce address was specified, although a "mail.from" property was set in the mail session.
Issue: EMAIL-149. Thanks to Richard DiCroce.
* "ImageHtmlEmail" failed to embed attachments if their data source name was null.
Issue: EMAIL-151. Thanks to Andreas Kohn.
* Html emails did not have the correct content-type set when using the Apache Geronimo
JavaMail implementation v1.8.x.
Issue: EMAIL-147. Thanks to Can Eskikaya.
* An "HtmlEmail" with both, an html and plain text content but no attachments or embedded
images will now be created with mimetype "multipart/alternative" instead of "multipart/mixed".
Issue: EMAIL-142. Thanks to Marcin Tomiak.
CHANGES FROM 1.3.2
------------------
Compatibility
-------------
* Java 5 or later is required (unchanged since 1.3).
Fixed Bugs
----------
* The filename of an attachment was not properly encoded in case it contained
non-ascii characters.
Issue: EMAIL-138. Thanks to qed.
* MimeMessageParser did not correctly parse MimeMessage objects created by
calling HtmlEmail.buildMimeMessage() and HtmlEmail.getMimeMessage().
Issue: EMAIL-137. Thanks to Alex Kogan.
* Fix Javadoc 1.8 errors.
Issue: EMAIL-136. Thanks to Ville Skyttä.
CHANGES FROM 1.3.1
------------------
Compatibility
-------------
* Java 5 or later is required (unchanged since 1.3).
Fixed Bugs
----------
* Change visibility of DataSourceUrlResourceResolver.createUrl(String) to protected so
that sub-classes can override it.
Issue: EMAIL-135. Thanks to Andreas Kohn.
* Support default mime charset property "mail.mime.charset" when adding text content
to instances of either SimpleEmail or HtmlEmail.
Issue: EMAIL-104. Thanks to Hiroshi Ikeda.
* Added support for sending partial emails in case of invalid addresses.
Issue: EMAIL-132. Thanks to Allen Xudong Cheng.
* The MimeMessageParser will now correctly parse MIME multi-parts of type "text/plain"
and "text/html" with a content disposition header of "attachment". The parts will
be added to the list of attachments even if there is no other text or html content.
Issue: EMAIL-131. Thanks to Raju Y.
* Special characters in the body of an HTML email could lead to an exception when the
mime message was built.
Issue: EMAIL-127. Thanks to Dominik Stadler.
CHANGES FROM 1.3
----------------
Compatibility
-------------
* Java 5 or later is required (unchanged since 1.3).
Fixed Bugs
----------
* DataSourceClassPathResolver will now correctly set the DataSource name for resolved
resources. Additionally, it is now possible to set the name for a ByteArrayDataSource.
Issue: EMAIL-125. Thanks to Jean-Marc.
* Header values are not folded twice anymore. The actual encoding and folding is
now only performed in Email.buildMimeMessage().
Issue: EMAIL-124. Thanks to Stefan Schueffler.
CHANGES FROM 1.2
----------------
Compatibility
-------------
* Java 5 or later is now required.
== New Features ==
* Added new methods addTo(String[]), addCc(String[]) and addBcc(String[]) to Email.
Issue: EMAIL-114. Thanks to Gokul Nanthakumar C.
* HtmlmageEmail should support class path resources
Issue: EMAIL-108. Thanks to Elisabeth Kasimir, Alexander Kasimir.
* Added a MultiPartEmail.attach(File) method since attaching a file is a simple and common.
* Added MimeMessageParser and MimeMessageUtils.
Fixed Bugs
----------
* Use the provided Content-ID in HtmlEmail#embed(File, String) instead of creating
a random one. The used and returned Content-ID will be URL encoded (see RFC 2392).
Issue: EMAIL-101. Thanks to Andrew Starodub.
* Upgraded source and binary compatibility to JDK 1.5. Additionally the public/protected
methods and fields have been properly generified.
Issue: EMAIL-122. Thanks to sebb.
* Do not set the personal name of an address to the email address unless it is
explicitly specified (affects TO, CC, BCC and FROM addresses).
Issue: EMAIL-103. Thanks to David Rees.
* Removed emulation support for nested exceptions in EmailException.
Issue: EMAIL-117. Thanks to sebb.
* Prevent external modification of internal array in DataSourceCompositeResolver.
Issue: EMAIL-116. Thanks to sebb.
* Close temporary input stream in MultiPartEmail#attach(DataSource, String, String)
to prevent locking of file resources on windows systems.
Issue: EMAIL-120. Thanks to Mike Bell.
* The patch actually broke sending emails over a secured connection - disabled the
"MAIL_SMTP_SSL_CHECKSERVERIDENTITY" and "MAIL_SMTP_SSL_ENABLE" activation. Tested
the functionality using GMail, GMX and Office365 so the code is at least working for
a couple of existing SMTP servers. Also added 'sslCheckServerIdentity' including
setter and getter. Also added a chapter regarding "Security" to the user manual.
Issue: EMAIL-105. Thanks to Siegfried Goeschl.
* Maven Site fails with error in Checkstyle configuration.
Issue: EMAIL-113. Thanks to Peter Kofler.
* DataSourceFileResolverTest fails under IBM JDK 1.4 and 1.6 running on Windows.
Issue: EMAIL-112. Thanks to Peter Kofler.
* Update the current trunk to be binary compatible with the commons-email-1.2 release.
Issue: EMAIL-111. Thanks to Florian Pirchner.
* Added unit test to ensure that parsing the broken mime message does not cause an OutOfMemoryException.
Issue: EMAIL-110. Thanks to Thomas Pummer.
* Added mime.types to META-INF - the definition is actually found in activation.jar
but did not work. Issue: EMAIL-107. Thanks to Claus Polanka, Michael Jakl.
* STARTTLS can be used even without authenticator.
Issue: EMAIL-106. Thanks to Bruno Harbulot.
* Clarified the meaning of setTLS() which actually sends a "STARTTLS" command from the
client to the SMTP server. Please note that some "protected" variables were renamed
which could break existing code.
Issue: EMAIL-105. Thanks to Bruno Harbulot.
* Fixed HtmlEmail embed toLowerCase bug with Turkish locale.
Issue: EMAIL-102. Thanks to Okan Özeren.
* Specified Content-ID is now used when embedding a File object in an HtmlEmail.
Issue: EMAIL-101. Thanks to Andrew Starodub.
* Throwing an IllegalStateException when setting mail session properties for an already
created mail session because the settings would be ignored. Please note that this
change could potentially break existing (but invalid) code. Issue: EMAIL-96.
* Encoding and folding of headers is now done by commons-email.
Issue: EMAIL-98. Thanks to Mario Daepp.
* The default connection timeout is set to a reasonable default value of 60 seconds.
Issue: EMAIL-100. Thanks to David Parks.
* Moving the various constants from 'EMail' to 'EmailConstants'
* All setters are returning "this" to simplify building an email.
Issue: EMAIL-76. Thanks to Yu Kobayashi.
* Adding ImageHtmlEmail to create HTML emails with embedded images either
downloaded from HTTP or from the local file system.
Issue: EMAIL-92. Thanks to Dominik Stadler.
* Calling buildMimeMessage() before invoking send() caused
duplicated mime parts for HtmlEmail. The implementation now enforces
that an email can be only used once and throw an exception when
multiple invocations of buildMimeMessage() are detected.
Issue: EMAIL-95.
* Incorrect SMTP Port number shown in error message when an email fails
to send due to a blocked port and SSL is used.
Issue: EMAIL-91. Thanks to Kevin Lester.
REQUIREMENTS:
J2SE environments
-----------------
Commons Email requires JavaMail 1.5.2 or later. The reference implementation
is available at:
https://java.net/projects/javamail/pages/Home
However, the Apache Geronimo project (http://geronimo.apache.org)
provides a J2EE-certified implementation of the JavaMail 1.4
specification licensed under the Apache Software License.
Commons Email also requires the JavaBeans Activation Framework unless
you are running on Java SE 6 or later. The Oracle implementation is available
at:
http://www.oracle.com/technetwork/java/javase/downloads/index-135046.html
Apache Geronimo likewise provides an implementation under the Apache
Software License.
Commons Email has been tested with JDK 1.6 and 1.7.
J2EE environments
-----------------
Commons Email is compatible with all certified Java Enterprise Edition
5 implementations; no further dependencies are required.
Java 2 Enterprise Edition 1.4 users must ensure that the versions of
JavaMail and JAF indicated above are available to their applications;
the J2EE 1.4 specification only requires earlier versions.
Earlier versions of J2EE are not supported.