首次接口实现RSS订阅

公司数据对接国内某知名股票机构，需要提供接口按Rss方式返回结果，开始首次尝试实现。

RSS是什么

Really Simple Syndication 简易信息聚合（也叫聚合内容）是一种基于XML的标准。简单来说就是网站提供按Rss方式返回结果的接口，方便RSS订阅器订阅；将一些自己关注的信息整合在一起【个人理解】

环境

SpringBoot 2.1.2.RELEASE
JDK 1.8
Maven 3.5.0

参考博客

Spring boot 入门 使用rome实现RSS 订阅
SpringMVC返回RSS格式的XML数据

版本问题遇到的坑

因版本问题，依赖不完整造成报错，具体依赖下文会讲。

正文

• Maven依赖

	<!--ROAM依赖  RSS 订阅-->
	  <dependency>
		<groupId>com.rometools</groupId>
		<artifactId>rome</artifactId>
		<version>1.15.0</version>
	  </dependency>

		<!-- https://mvnrepository.com/artifact/com.rometools/rome-utils -->
		<dependency>
			<groupId>com.rometools</groupId>
			<artifactId>rome-utils</artifactId>
			<version>1.15.0</version>
		</dependency>

		<dependency>
		<groupId>org.jdom</groupId>
		<artifactId>jdom2</artifactId>
		<version>2.0.6</version>
	  	</dependency>

第一篇大神文章中只引入rome包。我参考尝试的时候，会报ClassNotFoundException错误。
在Item类中使用的Dates，Lists是在utils包中。所以需要引入rome-utils这个包。（建议与rome包版本一致）

同样也需要引入jdom2解析包。

• 接口实现
  注意：produces = “application/xml;charset=UTF-8”

import io.swagger.annotations.ApiImplicitParam;
import io.swagger.annotations.ApiImplicitParams;
import org.springframework.web.bind.annotation.*;
import com.fang.cloud.api.sn.ApiSn;

import io.swagger.annotations.ApiOperation;

/**
 * @author: guochao.bj
 * @create: 2021-05-08 13:12:33
 */
public interface FeedControllerApi {
    

    @ApiSn("55da7417-c310-4fcf-918a-c6857999b279")
    @GetMapping(value = "/getRankDescriptionRss/{dataSourceType}/{dataDate}", produces = "application/xml;charset=UTF-8")
    @ApiOperation(value = "获取top10排名文字说明【RSS 订阅】", notes = "[email protected]", httpMethod = "GET",
            produces = "application/xml;charset=UTF-8")
    @ApiImplicitParams({
    
            @ApiImplicitParam(name = "dataSourceType", value = "数据来源类型(1(土地)，2（销售）)",required = true, dataType = "int"),
            @ApiImplicitParam(name = "dataDate", value = "数据时间(yyyy-mm)", required = true,dataType = "String")
    })
    @ResponseBody
    String  getRankDescriptionRss(@PathVariable("dataSourceType") Integer dataSourceType, @PathVariable("dataDate") String dataDate);


}

• 具体实现

import com.fang.industry.dto.bizpr.description.RankDescriptionDto;
import com.fang.industry.service.bizpr.http.controllerapi.FeedControllerApi;
import com.fang.industry.serviceiface.bizpr.IRankDescriptionService;
import com.rometools.rome.feed.rss.*;
import com.rometools.rome.io.FeedException;
import com.rometools.rome.io.WireFeedOutput;
import io.swagger.annotations.Api;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.ArrayList;
import java.util.Date;
import java.util.List;

/**
 * @author: [email protected]
 * @createDate: 2021/5/8 13:17
 */
@RestController
@RequestMapping("/feed")
@Api(description = "获取top10排名文字说明【RSS 订阅】")
public class FeedController implements FeedControllerApi {
    

    @Autowired
    IRankDescriptionService rankDescriptionService;

    @Override
    public String getRankDescriptionRss(@PathVariable("dataSourceType") Integer dataSourceType, @PathVariable("dataDate") String dataDate) {
    
        Date date = new Date();
        Channel channel = new Channel("rss_2.0");
        channel.setTitle("CIH-Top10");
        String title=null;
        if (dataSourceType==1){
    
            channel.setDescription("CIH-Top10 拿地榜文字说明");
            title="拿地榜";
        }else if (dataSourceType==2){
    
            channel.setDescription("CIH-Top10 销售榜文字说明");
            title="销售榜";
        }

        channel.setLink("https://www.fang.com");
        channel.setGenerator("CIH");
        channel.setEncoding("Utf-8");
        channel.setPubDate(date);

        List items = new ArrayList();

        List<RankDescriptionDto> rankDescription = rankDescriptionService.getRankDescription(dataDate, dataSourceType);
        for (RankDescriptionDto rankDescriptionDto : rankDescription) {
    
            Item item = new Item();
            item.setAuthor("CIH");
            item.setTitle(title);
            Description desc = new Description();
            desc.setValue(rankDescriptionDto.getSummaryDescriptionText());
            item.setDescription(desc);
            items.add(item);
        }
        channel.setItems(items);

        WireFeedOutput out = new WireFeedOutput();
        String str = "";
        try {
    
            str = out.outputString(channel);
        } catch (FeedException ex) {
    
            return "返回失败，联系管理员";
        }
        return str;
    }

实现结果

首次实现，理解不深，请多指教