📋 目录
一、工具类功能
判断银行卡号能不能用并给出脱敏展示串,长度 16-19 位、纯 ASCII 数字、Luhn 模 10 三项全过才算合法,也能给任意数字前缀补出唯一校验位用来造测试卡号。
二、所需环境
JDK 17或以上
三、方法与调用示例(按需调用)
🔢 方法序号:1
🎯 方法用途:
- 判一个卡号能不能用:ASCII 数字、长度 16 到 19 位、Luhn 模 10 通过,三项缺一即非法
- 绑卡提交、收银下单前的格式闸门用它,抄错一位就能拦住
🧩 方法定义:public static boolean isValid(String cardNo)
🗣️ 入参解释:public static boolean isValid(卡号字符串)
📤 返回值解释:boolean,三项条件全满足才为 true,不合法只给 false 不抛异常
💡 边界口径:
- 首尾空白先去掉再判,内部空格、横杠、字母都算非数字字符
- 只认 ASCII 十进制数字:
Character.isDigit会把阿拉伯-印度数字也认成数字,这类字符减掉基准数字后得到的是无意义数值,本类一律判非法 - 长度上下限是类内私有常量,没有配置入口,境外 12 到 15 位的短卡号要在上层另判
- 只保证卡号自身格式成立,不校验发卡行、卡种与号段是否真实存在,也不做 BIN 映射
- null、空串、纯空白都返回
false
🧪 方法示例:
isValid("6222021234567894")拿到trueisValid("6222021234567890128")19 位长卡号拿到true- 末位校验位改成 5 后拿到
false - 中间一位改成 9 后拿到
false - 补齐过 Luhn 的 15 位短号拿到
false - 补齐过 Luhn 的 20 位长号拿到
false isValid("6222 0212 3456 7890")内部带空格不算首尾空白,拿到falseisValid("6222-0212-3456-7890")带横杠拿到falseisValid(" 6222021234567894 ")首尾空白被去掉后正常通过,拿到true- 卡号里塞一个非 ASCII 的数字字符,
Character.isDigit认它是数字,本类拿到false isValid(null)拿到falseisValid("")拿到false
🔢 方法序号:2
🎯 方法用途:
- 只看长度是否落在 16 到 19 位之间,字符内容与 Luhn 一概不看
- 表单边输边给提示时用,不能当成卡号可用性的结论
🧩 方法定义:public static boolean isValidLength(String cardNo)
🗣️ 入参解释:public static boolean isValidLength(卡号字符串)
📤 返回值解释:boolean,去掉首尾空白后长度在 16 到 19 之间为 true
💡 边界口径:
- 量的是去首尾空白后的字符个数,内部空格、字母都照常计入长度
- 正因为不看内容,纯字母串也会被放行,最终判定仍要交给
isValid - null 判非法,其余任何字符串都不抛异常
🧪 方法示例:
isValidLength("6222021234567894")拿到true- 15 位的卡号拿到
false - 20 位的卡号拿到
false isValidLength("6222 0212 3456 7890")含内部空格共 19 个字符,拿到trueisValidLength("abcdefghijklmnop")字母串只看长度也会被放行,拿到true
🔢 方法序号:3
🎯 方法用途:
- 把卡号整理成前 6 位明文、中间等长星号、后 4 位明文的展示串
- 订单详情、接口回参、日志里要留卡号但不能留全号时用
🧩 方法定义:public static String formatDisplay(String cardNo)
🗣️ 入参解释:public static String formatDisplay(银行卡号)
📤 返回值解释:String,脱敏后的展示串,长度与原卡号相同
💡 边界口径:
- 星号个数等于原长度减 10,16 位遮 6 个,19 位遮 9 个
- 首尾空白先去掉,展示串里没有空格
- 只卡长度不卡字符,字母串照样能遮,稳妥做法是先
isValid再展示 - 中间几位不可反推,但发卡行号段与尾号四位仍是明文
- null、空白、长度不在 16 到 19 位之间都抛
IllegalArgumentException
🧪 方法示例:
formatDisplay("6222021234567894")拿到622202******7894- 这个 16 位产物里的星号个数拿到
6 formatDisplay("6222021234567890128")拿到622202*********0128- 这个 19 位产物里的星号个数拿到
9 - 脱敏串长度与原卡号逐位比对,拿到
true formatDisplay("abcdefghijklmnop")字母串也照遮,拿到abcdef******mnopformatDisplay(null)抛银行卡号不能为空- 入参是一串空白时抛
银行卡号不能为空 - 15 位卡号抛
银行卡号长度必须在16-19位之间,当前为15
🔢 方法序号:4
🎯 方法用途:
- 给定不含校验位的数字前缀,算出让整串通过 Luhn 校验的最后一位
- 造测试卡号、批量生成符合格式的号段时用,不用一个个数字去试
🧩 方法定义:public static char generateCheckDigit(String prefix)
🗣️ 入参解释:public static char generateCheckDigit(不含校验位的数字前缀)
📤 返回值解释:char,应追加的那一位,取值范围 0 到 9
💡 边界口径:
- 不校验前缀长度,几位的前缀都能补出校验位
- 追加之后前缀最右一位正好落在翻倍位上,按补数直接算出结果,不需要逐个试
- 补出来的位与
isValid是同一套 Luhn 口径,拼起来就能通过校验 - 前缀为 null、空串或含非 ASCII 数字字符(字母、空格都算)时抛
IllegalArgumentException - 只保证 Luhn 成立,不代表这个号段真实存在
🧪 方法示例:
generateCheckDigit("622202123456789")拿到4- 拼成
6222021234567894后交给isValid,拿到true - 把 0 到 9 十个候选挨个试一遍,能让整串通过 Luhn 的只有
1个 generateCheckDigit("62220212345678901234567890")26 位前缀也照样补,拿到6generateCheckDigit("")抛前缀不能为空generateCheckDigit(null)抛前缀不能为空generateCheckDigit("62220212345678a")抛前缀必须为纯数字- 前缀里夹一个空格也抛
前缀必须为纯数字
四、工具类源码(可直接复制)
📦 源码文件