枚举的Javadoc始终使用字母顺序显示其常量。有可能改变吗?

例如,如果未将常量显示为FRIDAY,MONDAY,SATURDAY,SUNDAY,THURSDAY TUESDAY,WEDNESDAY,则javadoc for java.time.DayOfWeek 看起来会更好。

最佳答案

默认的HTML doclet对其成员的摘要进行排序。

Collections.sort(members);

来自/com/sun/tools/doclets/internal/toolkit/builders/MemberSummaryBuilder.java :312

最好不要这样做。

Javadoc将摘要按字母顺序排列,以便您可以快速找到所需的摘要。破坏该模型将使Javadoc更加难以快速扫描和查找所需内容。

字母顺序仅适用于摘要,完整的Javadoc将按照源文件中的declecle顺序排列。

如果您确实需要执行此操作,则可以滚动自己的doclettaglet也许可以执行此操作。

10-07 13:00
查看更多