AcpService (mutils-union-pay 0.3.3 API)

java.lang.Object
- org.mutils.union.pay.util.AcpService

```
public class AcpService
extends Object
```

构造器概要

构造器
构造器和说明

AcpService()

构造器
构造器和说明
`AcpService()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static String`	`base64Decode(String base64Str, String encoding)` 对base64的字符串解base64
`static String`	`base64Encode(String rawStr, String encoding)` 对字符串做base64
`static String`	`createAutoFormHtml(String reqUrl, Map<String,String> hiddens)` 功能：前台交易构造HTTP POST自动提交表单
`static String`	`deCodeFileContent(Map<String,String> resData, String fileDirectory, String encoding)` 功能：解析交易返回的fileContent字符串并落地（解base64，解DEFLATE压缩并落地）适用到的交易：对账文件下载，批量交易状态查询
`static String`	`decryptData(String base64EncryptedInfo, String encoding)` 敏感信息解密
`static String`	`enCodeFileContent(String filePath, String encoding)` 功能：将批量文件内容使用DEFLATE压缩算法压缩，Base64编码生成字符串并返回适用到的交易：批量代付，批量代收，批量退货
`static String`	`encryptData(String data, String encoding)` 敏感信息加密并做base64(卡号，手机号，cvn2,有效期）
`static String`	`encryptPin(String accNo, String pwd, String encoding)` 密码加密并做base64
`static String`	`encryptTrack(String trackData, String encoding)` 加密磁道信息，使用公钥文件
`static String`	`encryptTrack(String trackData, String encoding, String modulus, String exponent)` 加密磁道信息，使用模和指数
`static String`	`get(String reqUrl, String encoding)` 功能：http Get方法便民缴费产品中使用
`static String`	`getCustomerInfo(Map<String,String> customerInfoMap, String accNo, String encoding)` 持卡人信息域customerInfo构造说明：不勾选对敏感信息加密权限使用旧的构造customerInfo域方式，不对敏感信息进行加密（对 phoneNo，cvn2， expired不加密），但如果送pin的话则加密
`static String`	`getCustomerInfoWithEncrypt(Map<String,String> customerInfoMap, String accNo, String encoding)` 持卡人信息域customerInfo构造，勾选对敏感信息加密权限适用新加密规范，对pin和phoneNo，cvn2，expired加密适用到的交易：
`static String`	`getEncryptCertId()` 获取敏感信息加密证书的物理序列号
`static String`	`getFileContent(String fileContent, String encoding)` 将结果文件内容转换成明文字符串：解base64,解压缩适用到的交易：批量交易状态查询
`static Map<String,String>`	`parseCustomerInfo(String customerInfo, String encoding)` 解析返回报文（后台通知）中的customerInfo域：解base64,如果带敏感信息加密 encryptedInfo 则将其解密并将 encryptedInfo中的域放到customerInfoMap返回
`static Map<String,String>`	`post(Map<String,String> reqData, String reqUrl, String encoding)` 功能：后台交易提交请求报文并接收同步应答报文
`static Map<String,String>`	`sign(Map<String,String> reqData)` 请求报文签名(使用配置文件中配置的私钥证书加密) 功能：对请求报文进行签名,并计算赋值certid,signature字段并返回
`static Map<String,String>`	`sign(Map<String,String> reqData, String certPath, String certPwd, String encoding)` 多证书签名(通过传入私钥证书路径和密码加密）功能：如果有多个商户号接入银联,每个商户号对应不同的证书可以使用此方法:传入私钥证书和密码(并且在acp_sdk.properties中配置 acpsdk.singleMode=false)
`static boolean`	`validate(Map<String,String> rspData, String encoding)` 验证签名(SHA-1摘要算法)
`static boolean`	`validateAppResponse(String jsonData, String encoding)` 对控件支付成功返回的结果信息中data域进行验签（控件端获取的应答信息）

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - AcpService
```
public AcpService()
```
- 方法详细资料
  - sign
```
public static Map<String,String> sign(Map<String,String> reqData)
```
    请求报文签名(使用配置文件中配置的私钥证书加密)
    功能：对请求报文进行签名,并计算赋值certid,signature字段并返回
    
    参数:
    
    reqData - 请求报文map
    
    encoding - 上送请求报文域encoding字段的值
    
    返回:
    
    签名后的map对象
  - sign
```
public static Map<String,String> sign(Map<String,String> reqData,
                                      String certPath,
                                      String certPwd,
                                      String encoding)
```
    多证书签名(通过传入私钥证书路径和密码加密）
    功能：如果有多个商户号接入银联,每个商户号对应不同的证书可以使用此方法:传入私钥证书和密码(并且在acp_sdk.properties中配置 acpsdk.singleMode=false)
    
    参数:
    
    reqData - 请求报文map
    
    certPath - 签名私钥文件（带路径）
    
    certPwd - 签名私钥密码
    
    encoding - 上送请求报文域encoding字段的值
    
    返回:
    
    签名后的map对象
  - validate
```
public static boolean validate(Map<String,String> rspData,
                               String encoding)
```
    验证签名(SHA-1摘要算法)
    
    参数:
    
    resData - 返回报文数据
    
    encoding - 上送请求报文域encoding字段的值
    
    返回:
    
    true 通过 false 未通过
  - validateAppResponse
```
public static boolean validateAppResponse(String jsonData,
                                          String encoding)
```
    对控件支付成功返回的结果信息中data域进行验签（控件端获取的应答信息）
    
    参数:
    
    jsonData - json格式数据，例如：{"sign" : "J6rPLClQ64szrdXCOtV1ccOMzUmpiOKllp9cseBuRqJ71pBKPPkZ1FallzW18gyP7CvKh1RxfNNJ66AyXNMFJi1OSOsteAAFjF5GZp0Xsfm3LeHaN3j/N7p86k3B1GrSPvSnSw1LqnYuIBmebBkC1OD0Qi7qaYUJosyA1E8Ld8oGRZT5RR2gLGBoiAVraDiz9sci5zwQcLtmfpT5KFk/eTy4+W9SsC0M/2sVj43R9ePENlEvF8UpmZBqakyg5FO8+JMBz3kZ4fwnutI5pWPdYIWdVrloBpOa+N4pzhVRKD4eWJ0CoiD+joMS7+C0aPIEymYFLBNYQCjM0KV7N726LA==", "data" : "pay_result=success&tn=201602141008032671528&cert_id=68759585097"}
    
    返回:
    
    是否成功
  - post
```
public static Map<String,String> post(Map<String,String> reqData,
                                      String reqUrl,
                                      String encoding)
```
    功能：后台交易提交请求报文并接收同步应答报文
    
    参数:
    
    reqData - 请求报文
    
    rspData - 应答报文
    
    reqUrl - 请求地址
    
    encoding -
    
    返回:
    
    应答http 200返回true ,其他false
  - get
```
public static String get(String reqUrl,
                         String encoding)
```
    功能：http Get方法便民缴费产品中使用
    
    参数:
    
    reqUrl -
    
    encoding -
    
    返回:
  - createAutoFormHtml
```
public static String createAutoFormHtml(String reqUrl,
                                        Map<String,String> hiddens)
```
    功能：前台交易构造HTTP POST自动提交表单
    
    参数:
    
    action - 表单提交地址
    
    hiddens - 以MAP形式存储的表单键值
    
    encoding - 上送请求报文域encoding字段的值
    
    返回:
    
    构造好的HTTP POST交易表单
  - enCodeFileContent
```
public static String enCodeFileContent(String filePath,
                                       String encoding)
```
    功能：将批量文件内容使用DEFLATE压缩算法压缩，Base64编码生成字符串并返回
    适用到的交易：批量代付，批量代收，批量退货
    
    参数:
    
    filePath - 批量文件-全路径文件名
    
    返回:
  - deCodeFileContent
```
public static String deCodeFileContent(Map<String,String> resData,
                                       String fileDirectory,
                                       String encoding)
```
    功能：解析交易返回的fileContent字符串并落地（解base64，解DEFLATE压缩并落地）
    适用到的交易：对账文件下载，批量交易状态查询
    
    参数:
    
    resData - 返回报文map
    
    fileDirectory - 落地的文件目录（绝对路径）
    
    encoding - 上送请求报文域encoding字段的值
  - getFileContent
```
public static String getFileContent(String fileContent,
                                    String encoding)
```
    将结果文件内容转换成明文字符串：解base64,解压缩
    适用到的交易：批量交易状态查询
    
    参数:
    
    fileContent - 批量交易状态查询返回的文件内容
    
    返回:
    
    内容明文
  - getCustomerInfo
```
public static String getCustomerInfo(Map<String,String> customerInfoMap,
                                     String accNo,
                                     String encoding)
```
    持卡人信息域customerInfo构造
    说明：不勾选对敏感信息加密权限使用旧的构造customerInfo域方式，不对敏感信息进行加密（对 phoneNo，cvn2， expired不加密），但如果送pin的话则加密
    
    参数:
    
    customerInfoMap - 信息域请求参数 key送域名value送值,必送
    例如：customerInfoMap.put("certifTp", "01"); //证件类型
    customerInfoMap.put("certifId", "341126197709218366"); //证件号码
    customerInfoMap.put("customerNm", "互联网"); //姓名
    customerInfoMap.put("phoneNo", "13552535506"); //手机号
    customerInfoMap.put("smsCode", "123456"); //短信验证码
    customerInfoMap.put("pin", "111111"); //密码（加密）
    customerInfoMap.put("cvn2", "123"); //卡背面的cvn2三位数字（不加密）
    customerInfoMap.put("expired", "1711"); //有效期年在前月在后（不加密)
    
    accNo - customerInfoMap送了密码那么卡号必送,如果customerInfoMap未送密码pin，此字段可以不送
    
    encoding - 上送请求报文域encoding字段的值
    
    返回:
    
    base64后的持卡人信息域字段
  - getCustomerInfoWithEncrypt
```
public static String getCustomerInfoWithEncrypt(Map<String,String> customerInfoMap,
                                                String accNo,
                                                String encoding)
```
    持卡人信息域customerInfo构造，勾选对敏感信息加密权限适用新加密规范，对pin和phoneNo，cvn2，expired加密
    适用到的交易：
    
    参数:
    
    customerInfoMap - 信息域请求参数 key送域名value送值,必送
    例如：customerInfoMap.put("certifTp", "01"); //证件类型
    customerInfoMap.put("certifId", "341126197709218366"); //证件号码
    customerInfoMap.put("customerNm", "互联网"); //姓名
    customerInfoMap.put("smsCode", "123456"); //短信验证码
    customerInfoMap.put("pin", "111111"); //密码（加密）
    customerInfoMap.put("phoneNo", "13552535506"); //手机号（加密）
    customerInfoMap.put("cvn2", "123"); //卡背面的cvn2三位数字（加密）
    customerInfoMap.put("expired", "1711"); //有效期年在前月在后（加密）
    
    accNo - customerInfoMap送了密码那么卡号必送,如果customerInfoMap未送密码PIN，此字段可以不送
    
    encoding - 上送请求报文域encoding字段的值
    
    返回:
    
    base64后的持卡人信息域字段
  - parseCustomerInfo
```
public static Map<String,String> parseCustomerInfo(String customerInfo,
                                                   String encoding)
```
    解析返回报文（后台通知）中的customerInfo域：解base64,如果带敏感信息加密 encryptedInfo 则将其解密并将 encryptedInfo中的域放到customerInfoMap返回
    
    参数:
    
    customerInfo -
    
    encoding -
    
    返回:
  - encryptPin
```
public static String encryptPin(String accNo,
                                String pwd,
                                String encoding)
```
    密码加密并做base64
    
    参数:
    
    accNo - 卡号
    
    pwd - 密码
    
    encoding -
    
    返回:
    
    加密的内容
  - encryptData
```
public static String encryptData(String data,
                                 String encoding)
```
    敏感信息加密并做base64(卡号，手机号，cvn2,有效期）
    
    参数:
    
    data - 送 phoneNo,cvn2,有效期
    
    encoding -
    
    返回:
    
    加密的密文
  - decryptData
```
public static String decryptData(String base64EncryptedInfo,
                                 String encoding)
```
    敏感信息解密
    
    参数:
    
    base64EncryptedInfo -
    
    encoding -
    
    返回:
    
    解密后的明文
  - encryptTrack
```
public static String encryptTrack(String trackData,
                                  String encoding)
```
    加密磁道信息，使用公钥文件
    
    参数:
    
    trackData - 待加密磁道数据
    
    encoding - 编码格式
    
    返回:
    
    加密的密文
  - encryptTrack
```
public static String encryptTrack(String trackData,
                                  String encoding,
                                  String modulus,
                                  String exponent)
```
    加密磁道信息，使用模和指数
    
    参数:
    
    trackData - 待加密磁道数据
    
    encoding - 编码格式
    
    modulus - 模
    
    exponent - 指数
    
    返回:
    
    加密的密文
  - getEncryptCertId
```
public static String getEncryptCertId()
```
    获取敏感信息加密证书的物理序列号
    
    返回:
  - base64Encode
```
public static String base64Encode(String rawStr,
                                  String encoding)
                           throws IOException
```
    对字符串做base64
    
    参数:
    
    rawStr -
    
    encoding -
    
    返回:
    
    抛出:
    
    IOException
  - base64Decode
```
public static String base64Decode(String base64Str,
                                  String encoding)
                           throws IOException
```
    对base64的字符串解base64
    
    参数:
    
    base64Str -
    
    encoding -
    
    返回:
    
    抛出:
    
    IOException

类 AcpService

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

AcpService

方法详细资料

sign

sign

validate

validateAppResponse

post

get

createAutoFormHtml

enCodeFileContent

deCodeFileContent

getFileContent

getCustomerInfo

getCustomerInfoWithEncrypt

parseCustomerInfo

encryptPin

encryptData

decryptData

encryptTrack

encryptTrack

getEncryptCertId

base64Encode

base64Decode