RSS Injection (Часть 1)

26-12-2007 Ни для кого не секрет, что в последнее время RSS каналы стали не только популярным средством продвижения новостных лент, но и эффективным способом обмена информационными потоками между сайтами. В данной статье речь пойдет о том, как реализовать потребность в RSS, используя один из самых популярных фреймворков – Spring.

По умолчанию в API Spring Web MVC framework входит целый набор представлений (View), реализующих рендеринг модели в различные форматы, включая PDF и Excel. Классы, предоставляющие такую возможность, находятся в пакетах org.springframework.web.servlet.view.*. Однако готового класса, позволяющего выполнять рендеринг модели в RSS или Atom, Spring пока не предоставляет.

Одной из очень удачных библиотек, позволяющих работать с синдикат-каналами, является ROME [2], разработанная инженерами из Sun. Основным ее достоинством является то, что она предоставляет API, полностью абстрогированный от конкретных реализаций RSS и Atom форматов (RSS 0.90, RSS 0.91 Netscape, RSS 0.91 Userland, RSS 0.92, RSS 0.93, RSS 0.94, RSS 1.0, RSS 2.0, Atom 0.3, and Atom 1.0).

Как уже было сказано выше, интеграция ROME и Spring по умолчанию в данный момент отсутствует - именно решением этой задачи мы и займемся в следующих строках.

В качестве примера мы разработаем небольшое приложение (rssinj), которое по запросу к url: /rssinj/newsrss.rss будет генерировать RSS feed для виртуальной новостной системы.

Мы начнем подготовку к разработке с объявления entry-point нашего приложения в web.xml:

<servlet>
        <servlet-name>rssinj</servlet-name>
        <servlet-class>
            org.springframework.web.servlet.DispatcherServlet
        </servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>rssinj</servlet-name>
        <url-pattern>*.rss</url-pattern>
    </servlet-mapping>

Далее, следуя "Convention over configuration" [1], создадим rssinj-servlet.xml в котором произведем внедрение бина, позволяющего автоматически ассоциировать адрес /newsrss.rss с соответствующим контроллером:

<bean
        class="org.springframework.web.servlet.mvc.support.ControllerClassNameHandlerMapping">
    </bean>

также внедряем сам контроллер:

<bean id="newsController"
        class="com.webtair.articles.rssinj.mvc.NewsRssController" >
        <property name="commandClass" value="java.lang.Object" />
        <property name="newsDao">
            <ref bean="newsDao" />
        </property>
    </bean>

Как видно из кода приведенного выше, наш контроллер предполагает наличие в контексте приложения DAO-сущности, позволяющей обращаться к репозиторию и извлекать из него список новостей, к которому мы предполагаем предоставить доступ через rss-канал. Мы не будем подробно останавливаться на разработке этого слоя, и для простоты изложения, объявим список новостей непосредственно в rssinj-servlet.xml ( подробнее см. [4] ):

<bean id="newsDao" class="com.webtair.articles.rssinj.dao.NewsDao">
        <property name="newsList">
            <list>
                <ref bean="news1"/>
                <ref bean="news2"/>
                <ref bean="news3"/>
            </list>
        </property>
    </bean>
    <bean id="news1" class="com.webtair.articles.rssinj.domain.NewsBean">
        <property name="title" value="Adobe unveils Flash video control" />
        <property name="link" value="http://news.bbc.co.uk/2/hi/business/6558979.stm" />
        <property name="publishedDate" value="2007-04-16" />
        <property name="description" value="Adobe unveils a..." />
    </bean>
    <bean id="news2" class="com.webtair.articles.rssinj.domain.NewsBean">
        ...
    </bean>
    <bean id="news3" class="com.webtair.articles.rssinj.domain.NewsBean">
       ...
    </bean>

Таким образом, после выполненных действий в контексте приложения появится три экземпляра класса NewsBean, содержащие title, link, publishedDate и description. Непосредственно в контроллере доступ к списку новостей осуществляется с помощью следующего вызова:

List<NewsBean> newsList = newsDao.getNewsList();

Так же следует обратить внимание читателя на то, что именно строка

<bean id="newsController" class="com.webtair.articles.rssinj.mvc.NewsRssController" >

приводит к тому, что при обработке адреса /newsrss.rss управление передается непосредственно на newsController (подробнее см. [1], 13.11.1 ). На этом подготовка среды закончена и мы можем смело приступить к разработке представления (View), позволяющего нам сформировать rss канал.

В качестве библиотеки, позволяющей формировать RSS и Atom в соответсвии со стандартами, мы остановлись на ROME ([2]), соответствующий rome-*.jar которой необходимо расположить в /lib нашего проекта. ROME использует также jDom ([3]), jar которого также понадобится в /lib (подробнее см. [4] /lib/readme.txt).

В Spring определен базовый абстрактный класс (org.springframework.web.servlet.view.AbstractView) для разработки представлений, от которого мы унаследуемся и создадим свою абстракцию (com.webtair.articles.rssinj.view.RssAbstractView) для дальнейшей работы с rss:

Ключевым, в нашем абстрактном классе является метод:

protected void renderMergedOutputModel(Map model, HttpServletRequest request, HttpServletResponse response) throws Exception {
       
        SyndFeed feed = new SyndFeedImpl();
        buildRssDocument(model, feed, request, response);

        response.setContentType("application/xml; charset=UTF-8");

        SyndFeedOutput out = new SyndFeedOutput();
        out.output(feed, response.getWriter());
    }

Данный метод создает экземляр SyndFeed - базовый класс в ROME, используемый для создания нового канала и затем передает управление в метод buildRssDocument(), который выполнит наполнение объекта feed, конкретными данными. Естественно, что эту функцию будет выполнять уже конкретная реализация - в нашим примере - это com.webtair.articles.rssinj.view.NewsRssView, к рассмотрению которого мы и переходим. Переопределенный метод buildRssDocument как раз и предназанчен для того, чтобы сформировать из полученной модели полноценный feed : 

1. spring.jar ( v.2.0.2 from $SPRING_HOME/dist/ )
2. rome.jar ( v.0.9 from https://rome.dev.java.net/ )
3. jdom.jar ( v.1.0 from http://www.jdom.org/dist/binary/ )
4. commons-logging.jar ( $SPRING_HOME/dist/jakarta-commons/ )

Vyacheslav Yakovenko, Dmitry Rudenko

RSS Injection (Часть 2)

Введите код