Автономный сервер Javadoc

Question

Поскольку не все наши машины для разработки имеют доступ к Интернету, мы хотим кэшировать документы API различных библиотек в нашей локальной сети.Я думал о веб-приложении, которое обрабатывает кэширование и перечисляет доступные Javadocs после того, как кто-то загрузит их (в формате jar).В идеале исходные файлы jar будут автоматически извлекаться из нашего репозитория maven (артефакт).

Мне не удалось найти что-то подобное в Google, поэтому я пытаюсь здесь попытаться.

РЕДАКТИРОВАТЬ

Я нашел сайт, который делает именно то, что я ищу: http://www.jarvana.com Проблема в том, что этот сайт не выполняет мое требование № 1 - доступность в автономном режиме,Поэтому я перефразирую свой вопрос: есть ли веб-приложение, которое работает как jarvana, но может быть развернуто на локальном сервере?

Answer 1

Кажется, что то, что я ищу, на самом деле не существует, поэтому я развернул свое собственное очень простое веб-приложение, которое обслуживает JavaDocs из локального репозитория maven (прозрачно извлекающего файлы jar).Это далеко от совершенства, но это работает для моих требований.Если кому-то интересно, я поделился им на github:

https://github.com/planbnet/JavaDoc-Browser

Answer 2

Почему бы просто не использовать mvn site?

Хм, я бы лучше добавил что-нибудь более полезное: -)

mvn site будет создавать и развертывать несколько отчетов сайта, включаяJavadoc (при условии, что вы настраиваете этот плагин).Каждый раз, когда ваш сервер CI собирает код из trunk / branch / tag / whereever, самые последние Javadoc будут генерироваться и сохраняться в файловой системе (доступной через HTTP)!

Есть даже классный отчет, который связывает Javadoc сисходный код.

Answer 3

Некоторое время назад я написал скрипт на python для обслуживания Javadoc из моего локального репозитория Maven:

http://blog.robotninjas.org/2013/04/17/accessing-your-cached-javadoc-offline/

python javadoc.py

Это грубо, но при нажатии http://localhost:8080/m2 будут перечислены все проекты в вашем локальном хранилище maven с загруженными документами.

Вы можете скачать все javadoc-файлы для проекта maven с помощью:

mvn dependency:resolve -Dclassifier=javadoc

Answer 4

Вы можете попробовать wwwoffle . Кэширующий прокси, который позволяет получать доступ к сайтам, пока вы не в сети.