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
(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;
(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
(2) 在sign中进行加密时,要另外提供商户32位密钥key,我原来一直出错的原因是加密key弄错了,一定要记住,是商户32位密钥key。
(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);