# 1. 解析手机号码格式
## 1.1 接口描述
接口名：I18nServiceHelper.parseTelephone(String telephone)
解析国际手机号码中的区号与号码。
## 1.2 输入参数
| 字段 | 必填 | 类型 | 示例 | 说明 |
| --------- | ---- | ------ | --------------- | ------------------ |
| telephone | 是 | String | "+86-17299999999" | 按格式拼接：区号+"-"+号码 |
## 1.3 输出参数
| 字段 | 类型 | 示例 | 说明 |
| ----------- | ------------ | -------------------- | ------------------------ |
| success | boolean | true | 是否成功 |
| errorMsg | String | "手机号码无法解析。" | 提示信息 |
| telephone | String | "17299999999" | 号码 |
| areaCode | String | “+86” | 区号 |
| countryList | List<String> | ["001","002"] | 匹配的国家或地区编码集合 |
## 1.4 代码示例
~~~java
// 调用示例
TelephoneParseResult result = I18nServiceHelper.parseTelephone("+86-17299999999");
~~~
# 2. 校验手机号码格式
## 2.1 接口描述
接口名：I18nServiceHelper.verifyTelephoneNumberFormat(String telephoneNumber, String... countryNumber)
校验国际手机号码格式。
## 2.2 输入参数
| 字段 | 必填 | 类型 | 示例 | 说明 |
| --------------- | ---- | ------ | ------------- | ------------------ |
| telephoneNumber | 是 | String | "17299999999" | 手机号码(不带区号) |
| countryNumber | 是 | String | "001" | 国家地区编码 |
## 2.3 输出参数
| 字段 | 类型 | 示例 | 说明 |
| ------- | ------- | -------------- | -------- |
| code | Boolean | true | 是否成功 |
| message | String | "位数不正确。" | 提示消息 |
## 2.4 代码示例
~~~java
// 调用示例
Map<String, String> map = I18nServiceHelper.verifyTelephoneNumberFormat(String telephoneNumber, String... countryNumber);
~~~
# 3. 批量解析并校验手机号码
## 3.1 接口描述
接口名：I18nServiceHelper.batchVerifyTelephoneNumber(List<String> telephoneNumberVerifyList)
批量解析并校验国际手机号码是否正确。
## 3.2 输入参数
| 字段 | 必填 | 类型 | 示例 | 说明 |
| --------------- | ---- | ------ | ------------- | ------------------ |
| telephone列表| 是 | String | "+86-17299999999" |按格式拼接：区号+"-"+号码|
## 3.3 输出参数
返回的是List<TelephoneVerifyResult>，即手机号码校验结果列表。
TelephoneVerifyResult字段说明：
| 字段 | 类型 | 示例 | 说明 |
| ------- | ------- | -------------- | -------- |
| parseSuccess| boolean | true |解析是否成功 |
| verifySuccess| boolean|true | 校验是否通过 |
| parseErrorMsg| String | "手机号码无法解析。" | 如果解析失败，失败描述 |
| verifyResult| Map<String,String>| {"code":"true","message":"成功。"}| 返回校验结果同接口2输出参数一致 |
## 3.4 代码示例
~~~java
// 调用示例
List<String> telephoneNumberVerifyList = new ArrayList();
telephoneNumberVerifyList.add("+86-17299999999");
List<TelephoneVerifyResult> resultList = I18nServiceHelper.batchVerifyTelephoneNumber(telephoneNumberVerifyList);
for(TelephoneVerifyResult result : resultList) {
// 解析手机号码
if(result.isParseSuccess()) {
// 校验手机号码
if(result.isVerifySuccess()) {
Map<String,String> resultMap = result.getVerifyResult();
} else {
Map<String,String> resultFailedMap = result.getVerifyResult();
}
} else {
System.out.println(result.getParseErrorMsg());
}
}
~~~
