Uploaded image for project: 'PUBLIC - Liferay Portal Community Edition'
  1. PUBLIC - Liferay Portal Community Edition
  2. LPS-106666

NOTE FOR DEVELOPERS mistakenly added as method Javadoc

Details

    Description

      The Service Builder generated classes have a note that warns developers to NOT modify the source code. The note is meant to be read by developers viewing the source code and was therefore written as a Java comment. 

      The note was mistakenly changed to a Javadoc comment and was applied to the next member of the generated class (typically the first method). 

      Example:

      See the generated code here: https://github.com/liferay/liferay-portal/blob/master/portal-kernel/src/com/liferay/announcements/kernel/service/AnnouncementsEntryService.java#L49-L58

      /** NOTE FOR DEVELOPERS: Never modify or reference this interface directly. Always use {@link AnnouncementsEntryServiceUtil} to access the announcements entry remote service. Add custom service methods to <code>com.liferay.portlet.announcements.service.impl.AnnouncementsEntryServiceImpl</code> and rerun ServiceBuilder to automatically copy the method declarations to this interface.
      */
      public AnnouncementsEntry addEntry( long classNameId, long classPK, String title, String content, String url, String type, Date displayDate, Date expirationDate, int priority, boolean alert) throws PortalException;

      The templates that generate the classes needs to be changed back to having the note as a java comment, not a Javadoc.

       

      Attachments

        Issue Links

          Activity

            People

              kevin.valencia Kevin Valencia
              james.hinkey James Hinkey (Inactive)
              Kiyoshi Lee Kiyoshi Lee
              James Hinkey James Hinkey (Inactive)
              Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved:
                38 weeks, 3 days ago

                Packages

                  Version Package
                  7.0.0 DXP FP89
                  7.0.10.13 DXP SP13
                  7.0.X
                  7.1.10 DXP FP17
                  7.1.10.4 SP4
                  7.1.X
                  7.2.10 DXP FP4
                  7.2.X