Показаны сообщения с ярлыком javadoc. Показать все сообщения
Показаны сообщения с ярлыком javadoc. Показать все сообщения

суббота, 26 октября 2013 г.

Java 7. Find yourself what's new?

During the reading of Code Complete 2e I've come across the grep example. This utility helps you to find files matching your search criteria.
If you have a javadoc and you want to find out what's new then you can use the following example:

duglas@duglas-ThinkStation /usr/share/doc/openjdk-7-doc/api $ grep -R -l --include="*.html"   "<dd>1.7</dd>" . > /home/duglas/j.txt



This command will find all files that have been changed or added to the JDK 1.7. Moreover it allows you not only to rely on the what's new file but to explore the changes to the JDK documentation by yourself.

среда, 4 июля 2012 г.

Spring web services. Java doc.

Недавно я начал разбираться с новой для себя библиотекой - Spring Web Services. Скачал версию 2.1.0.

Оказалось, что эта версия не работает со Spring 2.5. Из недостатков дистрибутива можно отметить отсутствие javadoc. Однако после поисков мне удалось найти архив с javadoc по пути: http://repo1.maven.org/maven2/org/springframework/ws/spring-ws-core/2.1.0.RELEASE/spring-ws-core-2.1.0.RELEASE-javadoc.jar.

Также к недостатку можно отнести то, что при определённых условиях spring ws зависит от http client 3.1.1. Хотя http client уже давно имеет более свежую версию. Для меня было открытием, что spring ws не имеет встроенной возможности установить таймаут на ожидание обработки запроса в веб-сервис. Именно поэтому используется http client.

Что касается написания клиента, то здесь  Spring ws  предоставляет гибкие возможности. Например, можно посылать xml запросы в виде строк напрямую в сервис, а можно заставить spring ws самому заниматься преобразованием объектов в запросы и обратно. Мне, к сожалению, пришлось выбрать вариант работы с xml через строки, так как веб-сервис, с которым приходится работать, плохо документирован и определён. Поэтому часто приходится делать доработки клиента.

Подписывание xml также происходит довольно легко и быстро. Не надо тратить время на написание кода - всё можно сделать через файл конфигурации Spring. Пример постараюсь выложить позже.

Несмотря на то, что новичкам будет непросто сходу разобраться в этой библиотеке, я бы рекомендовал потратить время на её освоение.