UniHttp 中 Xml 与 JavaBean 序列化的多种实现方式

手动调用服务并进行转换：

package com.yelang.project.unihttp;
import java.io.StringReader;
import javax.xml.bind.JAXBContext;
import javax.xml.bind.JAXBException;
import javax.xml.bind.Unmarshaller;
import org.junit.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;
import com.burukeyou.uniapi.annotation.UniAPIScan;
import com.burukeyou.uniapi.http.core.response.HttpResponse;
import com.google.gson.Gson;
import com.yelang.project.education.domain.tdt.TdtResult;
import com.yelang.project.thridinterface.TdtOptionService;

@SpringBootTest
@RunWith(SpringRunner.class)
@UniAPIScan("com.yelang.project.thridinterface")
public class TdtUniHttpCase {
    private static final String TDT_SERVER_KEY = "tdt_key";
    @Autowired
    private TdtOptionService tdtOptService;

    @Test
    public void xml2JavaBean() throws JAXBException {
        String origInfo = "113.216171,28.190967";
        String destInfo = "112.957124,28.198626";
        String postStr = "%7B'orig':'" + origInfo + "','dest':'" + destInfo + "','style':'2'%7D";
        
        HttpResponse<String> resp = tdtOptService.drivePlan(postStr, "search", TDT_SERVER_KEY);
        
        JAXBContext context = JAXBContext.newInstance(TdtResult.class);
        Unmarshaller unmarshaller = context.createUnmarshaller();
        TdtResult result = (TdtResult) unmarshaller.unmarshal(new StringReader(resp.getBodyResult()));
        
        System.out.println("距离：" + result.getDistance());
        System.out.println("时长：" + result.getDuration());
        System.out.println("起始点：" + result.getParameters().getOrig());
        
        Gson gson = new Gson();
        System.out.println(gson.toJson(result));
    }
}

这种方式虽然功能可行，但代码侵入性较强，每次调用都需要手动处理 Context 和 Unmarshaller。

二、利用 UniHttp 内置转换器

为了减少样板代码，UniHttp 提供了 XmlSerializeConverter 接口及默认实现。我们只需配置 @HttpApi 注解即可自动完成转换。

1. XmlSerializeConverter 接口

该接口定义了核心方法：

public interface XmlSerializeConverter extends SerializeConverter {
    String serialize(Object object);
    Object deserialize(String xml, Type type);
}

2. JaxbXmlSerializeConverter 具体实现

在 HttpApi 注解中，默认已配置了 JaxbXmlSerializeConverter.class。

3. 实现方法

声明接口时直接指定转换器，并将返回类型改为 JavaBean：

package com.yelang.project.thridinterface;
import com.burukeyou.uniapi.http.annotation.HttpApi;
import com.burukeyou.uniapi.http.annotation.param.QueryPar;
import com.burukeyou.uniapi.http.annotation.request.GetHttpInterface;
import com.burukeyou.uniapi.http.core.serialize.xml.JaxbXmlSerializeConverter;
import com.yelang.project.education.domain.tdt.TdtResult;

@HttpApi(url = "http://api.tianditu.gov.cn/", xmlConverter = JaxbXmlSerializeConverter.class)
public interface TdtDriveService {
    @GetHttpInterface("drive")
    public TdtResult drivePlan(@QueryPar("postStr") String postStr,
                               @QueryPar("type") String type,
                               @QueryPar("tk") String tk);
}

调用逻辑变得非常简洁：

@Test
public void testByJaxbXmlSerializeConverter() throws Exception {
    String origInfo = "113.216171,28.190967";
    String destInfo = "112.957124,28.198626";
    String postStr = "%7B'orig':'" + origInfo + "','dest':'" + destInfo + "','style':'2'%7D";
    
    // 直接返回 TdtResult 对象，无需手动解析
    TdtResult result = tdtDriveService.drivePlan(postStr, "search", TDT_SERVER_KEY);
    
    System.out.println("距离：" + result.getDistance());
    System.out.println("时长：" + result.getDuration());
    System.out.println("起始点：" + result.getParameters().getOrig());
}

三、自定义转换器

如果希望完全控制序列化逻辑，或者使用第三方库（如 Jackson XML），可以实现 XmlSerializeConverter 接口并注入到注解中。

1. 实现方法

自定义转换器类：

package com.yelang.project.thridinterface.converter;
import java.lang.reflect.Type;
import com.burukeyou.uniapi.http.core.serialize.xml.XmlSerializeConverter;

public class DiyXMLSerializeConverter implements XmlSerializeConverter {
    @Override
    public String serialize(Object object) {
        // 自定义序列化逻辑
        return null;
    }

    @Override
    public Object deserialize(String xml, Type type) {
        // 自定义反序列化逻辑
        return null;
    }
}

然后在接口注解中绑定：

@HttpApi(xmlConverter = DiyXMLSerializeConverter.class)
interface UserAPI { }

其它参数传递和设置与前述内容基本一致。通过这种方式，开发者可以根据项目需求灵活选择最合适的序列化策略，平衡开发效率与系统性能。