快捷導(dǎo)航

SpringBoot接收與響應(yīng)xml報(bào)文請(qǐng)求的實(shí)現(xiàn)

更新時(shí)間：2023年06月25日 10:41:29 作者：誰(shuí)是誰(shuí)的小確幸

我們?cè)谶M(jìn)行接口對(duì)接時(shí),會(huì)出現(xiàn)報(bào)文形式的信息傳遞,這篇文章主要給大家介紹了關(guān)于SpringBoot接收與響應(yīng)xml報(bào)文請(qǐng)求的相關(guān)資料,需要的朋友可以參考下

背景

平時(shí)開(kāi)發(fā)的接口，基本是使用 json 格式的請(qǐng)求報(bào)文。然而，有時(shí)候也避免不了有 xml 報(bào)文請(qǐng)求的場(chǎng)景，最近就遇到了這種情況，在此記錄下。另外，工程中使用的是 controller-service……這種結(jié)構(gòu)。

xml請(qǐng)求報(bào)文：

<?xml?version="1.0"?encoding="UTF-8"??>
<req>
??<tel>15556905765</tel>
??<activityid></activityid>
??<timestamp>1603383430</timestamp>
</req>

xml響應(yīng)報(bào)文：

<?xml?version="1.0"?encoding="UTF-8"??>
<resp>
????<code>200</code>
????<msg></msg>
????<activeflag></activeflag>
</resp>

實(shí)現(xiàn)步驟

第一步，引入必需依賴(lài)

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.16.10</version>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-xml</artifactId>
    <version>2.14.1</version>
</dependency>

在 jackson-dataformat-xml 包里提供了一系列的 json 與 xml 互轉(zhuǎn)的 API。當(dāng)定義請(qǐng)求或響應(yīng)類(lèi)時(shí)，使用 @JacksonXml 開(kāi)頭的注解，可以實(shí)現(xiàn) xml 標(biāo)簽字段與 javabean 字段之間的映射。

第二步，自定義請(qǐng)求類(lèi)和響應(yīng)類(lèi)

自定義請(qǐng)求類(lèi)：

@Data
@JacksonXmlRootElement(localName = "req")
public class TestRequest {
    //手機(jī)號(hào)
    @JacksonXmlProperty(localName = "tel")
    private String tel;
 
    //活動(dòng)商品ID
    @JacksonXmlProperty(localName = "activityId")
    private String productId;
 
    @JacksonXmlProperty(localName = "timestamp")
    private Long timestamp;
}

自定義響應(yīng)類(lèi)：

@Data
@JacksonXmlRootElement(localName = "resp")
public class TestResponse {
    //返回碼
    @JacksonXmlProperty(localName = "code")
    private String code;
    //返回碼信息描述
    @JacksonXmlProperty(localName = "msg")
    private String msg;
    //可參與活動(dòng)標(biāo)志 ：1-可參與 2-不可參與
    @JacksonXmlProperty(localName = "activeflag")
    private String activeFlag;
}

注意，當(dāng)xml與實(shí)體類(lèi)的一些字段名稱(chēng)相同時(shí)，這些字段可以不使用@JacksonXmlProperty注解。

第三步，編寫(xiě)控制器類(lèi)和業(yè)務(wù)邏輯

TestController：

@RestController
public class TestController {
    @Resource
    private TestService testService;
 
    @PostMapping(value = "/test"
            , produces = MediaType.APPLICATION_XML_VALUE)
    public String test(@RequestBody TestRequest request)
    {
        return testService.service(request);
    }
}

TestService：

@Slf4j
@Service
public class TestService {
    public String service(TestRequest request){
 
        //request入?yún)⑿ｒ?yàn) .... 省略
 
        //正常情況
        TestResponse response = new TestResponse();
        response.setCode("200");
        response.setMsg("allow sub");
        response.setActiveFlag("1");
        return javaBeanToXml(response);
    }
}

第四步，編寫(xiě) javabean 轉(zhuǎn) xml 方法

//XML文件頭
private static final String XML_HEAD = "<?xml version=\"1.0\" encoding=\"UTF-8\" ?>\n";
public static String javaBeanToXml(Object obj)
{
    String xml = "";
    if (Objects.isNull(obj))
    {
        return xml;
    }
    try
    {
        XmlMapper xmlMapper = new XmlMapper();
        xml = xmlMapper.writeValueAsString(obj);
    } catch (Exception e)
    {
        log.error("javaBeanToXml error, obj={}, xml={}", obj, xml, e);
        return "";
    }
    // 添加xml文件頭
    return XML_HEAD + xml;
}

自測(cè)

這里，使用 postman 工具測(cè)試（Body->raw->XML）

效果如下：

特此記錄下，就這樣~

總結(jié)

到此這篇關(guān)于SpringBoot接收與響應(yīng)xml報(bào)文請(qǐng)求的文章就介紹到這了,更多相關(guān)SpringBoot接收響應(yīng)xml報(bào)文請(qǐng)求內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: