Prevent inclusion of portal-impl.jar in plugins portlets

• Type: Improvement
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 5.1 EE SP3 (5.1.6), 5.2 EE SP1 (5.2.5)
• Fix Version/s: 5.1 EE SP4 (5.1.7), 5.2 EE SP2 (5.2.6)
• Component/s: Dev Tools > MVC Portlet
• Labels:
  • 5.2_release_notes
• Environment: All

portal-impl.jar is designed with a large number of singleton classes which are erected on the basis that they will exist alone in the app server.

While compilation-time issues may be resolved, portlets cannot be made to work by simply adding portal-impl.jar, because doing so violates the above assumption, and the resulting problems will be extremely difficult to debug.

However, many new users/developers will attempt to add portal-impl.jar in order to get a portlet to compile, and will inevitably run into these difficult to debug problems.

To address this issue, the build script in the plugins SDK will no longer allow portal-impl.jar to be included. If the build script detects a portal-impl.jar, it will automatically fail the compilation and display a helpful message.