富友支付新API如何使用?

1. 由于富友API以XML作为序列化手段，因此需要一个辅助类进行Java bean与XML之间的序列化和反序列化操作:

import java.io.StringReader;
import java.io.StringWriter;

import javax.xml.bind.JAXBContext;
import javax.xml.bind.JAXBException;
import javax.xml.bind.Marshaller;
import javax.xml.bind.Unmarshaller;

/**
 * Xml 和JavaBean转换工具类
 * 
 * @author XiaoHao
 *
 */
public class XmlBeanUtils
{
    private XmlBeanUtils()
    {
    }

    /**
     * 将bean转换成Xml，编码方式为UTF-8
     * @param bean 被转换的Bean
     * @return String
     * @throws JAXBException
     */
    public static <T> String convertBean2Xml(T bean) throws JAXBException
    {
        return convertBean2Xml(bean, "UTF-8");
    }
    /**
     * 将bean转换成指定编码方式的Xml
     * @param bean 被转换的Bean
     * @param charSet 编码方式
     * @return String
     * @throws JAXBException
     */
    public static <T> String convertBean2Xml(T bean, String charSet) throws JAXBException
    {
        JAXBContext jc = JAXBContext.newInstance(bean.getClass());
        Marshaller ms = jc.createMarshaller();
        ms.setProperty(Marshaller.JAXB_ENCODING, charSet);
        StringWriter sw = new StringWriter();
        ms.marshal(bean, sw);
        return sw.toString();
    }

    /**
     * 将Xml数据转换成bean
     * @param xml 
     * @param clazz
     * @return
     * @throws JAXBException
     */
    @SuppressWarnings ("unchecked")
    public static <T> T convertXml2Bean(String xml, Class <T> clazz) throws JAXBException
    {
        JAXBContext context = JAXBContext.newInstance(clazz);
        Unmarshaller unmarshaller = context.createUnmarshaller();
        return (T) unmarshaller.unmarshal(new StringReader(xml));
    }
}

2. java Bean与XML转换的使用方式:

(1) 导入相关的库和声明类:

import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement(name = "REQUEST")
public class FYMsgReqData

XML根节点.png

(2) 根据文档声明FY相关Bean的成员变量:

private String version;
private String mchntcd;
private String userId;
private String mchntssn;
private String tradeDate;
private String account;
private String cardNo;
private String idType;
private String idCard;
private String mobileNo;
private String sign;

成员变量参数.png

(3) 生成set/get函数，为每个set函数添加xml属性映射,大小写一定要和文档一致，例如下面的VERSION匹配上述文档中的对应名称

@XmlElement(name="VERSION")
public void setVersion(String version) {
    this.version = version;
}

(4) java bean与XML之间的互相转换:

将Java Bean转换为XML字符串

String apiFms = XmlBeanUtils.convertBean2Xml(Java XML Bean类);

将XML字符串转换为Java Bean

FYMsgRespData retData = XmlBeanUtils.convertXml2Bean(xml 字符串, FYMsgRespData.class);

3. 富友支付加密的关键点以及要注意的坑:

(1) 在XML中需要提供日期（tradeDate），但是在sign签名加密时，不要添加tradeDate

属性设置.png

(2) 在sign中进行加密时，要另外提供商户32位密钥key，我原来一直出错的原因是加密key弄错了，一定要记住，是商户32位密钥key。

签名.png

(3) 请求时需要将xml进行加密,在富友返回数据时需要解密

//将请求数据转换为xml
String apiFms = XmlBeanUtils.convertBean2Xml(data);
        
//post请求，参数为MCHNTCD和APIFMS
//其中APIFMS是XML格式，需要使用DESCoderFUIOU.desEncrypt进行加密
Map <String, String> param = new HashMap <String, String>();
param.put("MCHNTCD", MCHNTCD);
param.put("APIFMS", DESCoderFUIOU.desEncrypt(apiFms, DESCoderFUIOU.getKeyLength8(TESTMD5)));
        
//向富友服务器发送post请求
HXWebClient client = new HXWebClient();
//请求富友服务器后返回加密后的数据
String respStr = client.doPost(FYBINDMSG, param);

//解密后的富友response数据也是xml格式
respStr = DESCoderFUIOU.desDecrypt(respStr, DESCoderFUIOU.getKeyLength8(TESTMD5));

//通过XmlBeanUtils的方法，将xml数据转换为Java Bean,然后可以操作Bean来判断是否成功，以及各种信息
FYMsgRespData retData = XmlBeanUtils.convertXml2Bean(respStr, FYMsgRespData.class);