2016-01-27 3 views
2

Для курса программирования, я должен поместить комментарии в пределах каждого класса и методы описания следующих пять вещей: Метод, поля, методы на полях, параметров, и методы по параметрам. Первые три должны быть помещены непосредственно под заголовком класса, а последние два относятся к каждому методу.Затмение комментарьего авто поколение

Ниже приведен пример того, как выглядят эти комментарии.

class ConsLoString implements ILoString { 
    /* 
    * Methods: 
    * - String convertToString(); 
    * - String formatString(); 
    * Fields: 
    * - String first; 
    * - ILoString rest 
    * Methods on fields: 
    * - All String methods 
    * - All ILoString methods 
    */ 

    String first; 
    ILoString rest; 

    ... 

Естественно, это утомительно и излишнее вводить все эти вне для каждого класса и методы в большом файле. Есть ли способ генерировать их автоматически, в Eclipse или иначе?

Я просмотрел Eclipse, но, похоже, не существует способа перебора каждого метода/поля в классе в редакторе шаблонов Eclipse.

Любая помощь очень ценится!

+0

Оцените свой вопрос, нижний план для этого требования с вашего курса. Вернитесь к ним, покажите им, как должен работать javadoc. Если вы правильно используете javadoc, вы получаете правильное резюме, не требуя от вас того, что ваш курс программирования запрашивает у вас. В «реальном» мире я бы очень опасался любой компании, которая требовала такого стиля документации в java. –

ответ

1

В Eclipse перейдите в Окно -> Настройки -> Java -> Стиль кода -> Шаблоны кода С правой стороны нажмите кнопку «Стиль кода», чтобы открыть его, нажмите «Методы», а внизу проверьте флажок в которой говорится: Автоматически добавлять комментарии к новым методам и типам. Вы можете сделать то же самое и для полей.

Я не видел нигде так, как вы пытаетесь документировать классы Java. Но если это то, что вы хотите: см. this, и найдите java ClassSpy ClassMember FIELD METHOD. Вы можете напрямую взять класс ClassSpy.java из этой ссылки, скомпилировать его и выполнить класс ClassSpy.class, например: java ClassSpy ConsLoString FIELD METHOD - Он выведет поля, методы в качестве вывода. Скопируйте вывод и используйте его так, как хотите.

+0

С помощью этого метода я не могу перебирать список методов и полей данного класса/интерфейса, которые мне нужно сделать. Я могу получить, например, имя вложенного типа или имя файла. – camden

+0

Что вы подразумеваете под повторением списка методов, полей? Пожалуйста, уточните, что именно вы хотите в своем посте. – SomeDude

+0

В примере в моем сообщении блок комментариев отображает список всех полей и методов в классе 'ConsLoString'. Мне нужно получить каждое поле и метод (перебирать их), чтобы они могли помещать их в комментарий. – camden

1

Когда вы вводите /** непосредственно перед определением класса или метода, а затем нажмите return, Eclipse генерирует некоторые (шаблонные) комментарии для классов и методов. Вы можете определить содержимое сгенерированных комментариев, перейдя в Window> Preferences> Java> Code Style> Code Templates> Comments.

+0

С помощью этого метода я не могу перебирать список методов и полей данного класса/интерфейса, которые мне нужно сделать. Я могу получить, например, имя вложенного типа или имя файла. – camden

+0

Когда вы говорите «перебираете список методов и полей», это звучит так, будто вы пытаетесь «разобрать» существующие файлы «без комментирования», добавляя комментарии, соответствующие полученной анализируемой информации, вместо того, чтобы пытаться соблюдать драконовские правила комментариев как вы пишете код. Функции моделирования кода/комментария Eclipse предназначены для «времени написания кода». Если вы используете отражение для «разбора» объектов, а затем добавляете комментарии к базовым файлам классов, это также случай, когда функции шаблона комментариев Eclipse не помогут. – geneSummons

+0

Вы правы, это именно то, что я пытаюсь сделать. К сожалению, Eclipse не обладает этой функциональностью. Я отредактирую свое сообщение, чтобы запросить решения, отличные от Eclipse, потому что правила комментариев действительно драконны. :) – camden

Смежные вопросы