Установка

JAR-файл можно получить из прикрепленных файлов или с сайта http://git.oschina.net/dingnate/code-parser/releases.

1. Разместите JAR-файл в директории plugins корневой папки Eclipse, затем перезапустите Eclipse.
2. В меню Help выберите Install New Software... -> Add -> Archive -> Next... -> Accept -> Finish, после чего перезапустите Eclipse.

Примечание: JAR-файлы, поддерживающие экспорт в Excel, имеют большой размер. Для мини-версии скачайте файлы code.parser.code_xx.jar и code.parser.ui_xx.jar, которые поддерживают преобразование Java-интерфейсов и JSON.

Использование

Выберите Java-файл в проекте, чтобы открыть контекстное меню Generate Java Json. После успешного выполнения команды будет создан файл interfaceName.json, содержащий информацию о Java-интерфейсе.

Выберите Java-файл в проекте, чтобы открыть контекстное меню Generate Java Excel. После успешного выполнения команды будет создан файл code.parser.result.xls, содержащий информацию о Java-интерфейсе.

Выберите созданный JSON-файл, чтобы открыть контекстное меню Generate Java Code. После успешного выполнения команды будет создан файл interfaceName.java, содержащий исходный код Java-интерфейса.

Настройка

Изменение значения параметра javadoc.tags в файле config.properties внутри JAR-файла code.parser.core_xx.jar позволяет собирать информацию по различным меткам. Названия нескольких меток разделены запятой, пробелы недопустимы.### Цели использования Этот проект представляет собой плагин для Eclipse. Если вы не знакомы с ним, воспользуйтесь поиском в браузере или посетите сайт http://www.eclipse.org/

Как использовать:

Просто поместите JAR-файл в директорию plugins корневой папки Eclipse, затем перезапустите Eclipse.

Сценарии использования:

Основное применение — это использование Eclipse для разработки Java-сервисов:

1. Предоставление данных JSON для сервисных интерфейсов переднего плана (включает описание интерфейсов, входящие и исходящие сообщения и т.д.). Этот инструмент позволяет автоматически конвертировать Java-интерфейсы в данные JSON, предоставляемые переднему плану.
2. Создание документов Excel для описаний интерфейсов для последующей разработки. Этот инструмент позволяет автоматически конвертировать Java-интерфейсы в документы Excel.
3. При использовании RPC или микросервисных архитектур, этот инструмент позволяет массово обновлять зарегистрированные сервисы на основе экспортированных данных JSON.
4. При использовании RPC или микросервисных архитектур, этот инструмент позволяет обратно генерировать код интерфейсов на основе данных JSON, что экономит время на программирование.### Решаемые проблемы
5. Ошибка при записи файла interfaceName.json: java.lang.NullPointerException
   org.apache.velocity.exception.VelocityException: Указанный класс для ResourceManager (org.apache.velocity.runtime.resource.ResourceManagerImpl) не реализует org.apache.velocity.runtime.resource.ResourceManager; Velocity не инициализируется правильно.