JIRA 4.4.4 Upgrade Notes
Upgrading from JIRA 4.4.x to 4.4.4
Please follow the instructions in the general upgrading JIRA documentation.
Notes for plugin developers with custom mail handlers
JIRA 4.4.4 includes a dependency on
1.25 which is not 100% backward compatible with
atlassian-mail 1.24 included in previous releases of JIRA.
JIRA 4.4.4 also ships with
javamail 1.4.4, which we cannot guarantee is 100% compatible with
javamail 1.4.1 (shipped with previous releases of JIRA).
Hence, there are two significant points to note as a result of these changes:
com.atlassian.mail.server.MailServer.getSession()method returns objects of the
javax.mail.Sessionclass rather than
- The classes from
mockobjects-j1.3-j2ee1.3.jarare no longer exported (i.e. made available) to Atlassian version 2 plugins. This
jaris no longer distributed with JIRA.
Potential Impact and Solution
We believe that very few (if any) 3rd party plugins will be affected by the two changes mentioned above and that such plugins will be broken as a result of these changes.
- If your plugin uses the
com.atlassian.mail.server.MailServer.getSession()method, doing either of the following should be sufficient to get it working with JIRA 4.4.4:
- Recompile your plugin against 4.4.4
- Use a higher level class like
- If your plugin depends on
mockobjects-j1.3-j2ee1.3.jar(which is highly unlikely and could be considered questionable), we encourage you to either:
- Remove this dependency or
- If it is not possible to remove this dependency, bundle this
jarwith the plugin.
According to the changelog for
javamail (http://www.oracle.com/technetwork/java/javaee/changes-220864.txt), we believe that these changes should not negatively impact current plugins. On the contrary, many bug fixes and compatibility improvements in this new version of
javamail should make existing JIRA mail handlers more robust.
JIRA 4.4.4 comes with substantial mail logging improvements and capabilities, which should be valuable to customers and support personnel troubleshooting problems related to incoming and outgoing mail.
Part of this feature work required the need to upgrade both the
javamail libraries to the versions mentioned above. The anticipated small negative impact resulting from these upgraded libraries led us to believe that there was little or no business justification for supporting their older versions.