Java POS 小票打印：从零到精通的实战指南80

在现代商业环境中，无论是街角的咖啡店、大型连锁超市，还是线上线下一体化的零售门店，小票（或收据）都是交易流程中不可或缺的一环。它不仅是消费者购物的凭证，也承载着商家品牌信息、促销内容乃至法规要求的重要载体。随着POS（Point of Sale）系统的普及，使用Java语言开发稳定、高效、功能丰富的POS小票打印模块，成为了众多开发者面临的常见需求。

本文将作为一份详尽的指南，带领读者深入探讨如何使用Java实现POS小票的打印。我们将从基础的数据模型设计开始，逐步深入到不同的打印技术，包括基于Java原生打印服务的通用打印，以及针对热敏打印机更常见的ESC/POS指令打印。文章还将涵盖字符编码、排版布局、条码/二维码生成等高级主题，并提供实际的代码示例，帮助您构建健壮的Java小票打印解决方案。

第一章：小票的构成与数据模型设计

要打印小票，首先需要理解小票上通常包含哪些信息，并将其转化为程序中的数据结构。一张标准的小票通常包括以下几个部分：
店铺信息：店铺名称、地址、电话、税号等。
交易信息：交易流水号、日期时间、收银员ID等。
商品清单：商品名称、单价、数量、小计等。
结算信息：商品总金额、折扣、税费、实付金额、找零、支付方式等。
页脚信息：感谢语、退换货须知、广告语、二维码等。

基于以上分析，我们可以设计出以下核心Java类来承载这些数据：
// - 商品信息类
public class Item {
private String name; // 商品名称
private int quantity; // 数量
private double price; // 单价
public Item(String name, int quantity, double price) {
= name;
= quantity;
= price;
}
// 计算商品总价
public double getTotal() {
return quantity * price;
}
// Getter方法
public String getName() { return name; }
public int getQuantity() { return quantity; }
public double getPrice() { return price; }
}
// - 小票数据模型
import ;
import ;
import ;
import ;
public class Receipt {
private String storeName;
private String storeAddress;
private String storePhone;
private String transactionId;
private LocalDateTime transactionTime;
private String cashierId;
private List<Item> items;
private double discountAmount;
private double taxRate; // 税率，例如 0.06 (6%)
private double amountPaid; // 顾客支付金额
public Receipt(String storeName, String storeAddress, String storePhone,
String transactionId, String cashierId) {
= storeName;
= storeAddress;
= storePhone;
= transactionId;
= ();
= cashierId;
= new ArrayList();
= 0.0;
= 0.0; // 默认无税
}
public void addItem(Item item) {
(item);
}
// 计算商品总金额（未打折、未含税）
public double getSubtotal() {
return ().mapToDouble(Item::getTotal).sum();
}
// 计算折扣后金额
public double getAmountAfterDiscount() {
return getSubtotal() - discountAmount;
}
// 计算税金
public double getTaxAmount() {
return getAmountAfterDiscount() * taxRate;
}
// 计算最终应付金额
public double getTotalAmount() {
return getAmountAfterDiscount() + getTaxAmount();
}
// 计算找零
public double getChange() {
return amountPaid - getTotalAmount();
}
// Setter for discount and tax rate
public void setDiscountAmount(double discountAmount) { = discountAmount; }
public void setTaxRate(double taxRate) { = taxRate; }
public void setAmountPaid(double amountPaid) { = amountPaid; }
// Getters for all fields
public String getStoreName() { return storeName; }
public String getStoreAddress() { return storeAddress; }
public String getStorePhone() { return storePhone; }
public String getTransactionId() { return transactionId; }
public LocalDateTime getTransactionTime() { return transactionTime; }
public String getCashierId() { return cashierId; }
public List<Item> getItems() { return items; }
public double getDiscountAmount() { return discountAmount; }
public double getTaxRate() { return taxRate; }
public double getAmountPaid() { return amountPaid; }
}

第二章：基础小票排版与控制台输出

在进行实际打印之前，我们通常会先在控制台模拟输出，以验证数据和排版逻辑。这有助于我们理解小票的字符宽度、对齐方式等基本概念。热敏打印机通常是定宽的，例如常见的58mm打印机，每行大约能显示32个半角字符；80mm打印机则能显示42-48个半角字符。中文通常占两个半角字符的宽度。

为了实现简单的对齐，我们可以使用字符串格式化方法，如()。
public class ConsoleReceiptPrinter {
// 假设小票宽度为32个半角字符
private static final int RECEIPT_WIDTH = 32;
public void printToConsole(Receipt receipt) {
("=".repeat(RECEIPT_WIDTH));
// 店铺信息
printCentered(());
printCentered(());
printCentered("电话: " + ());
("-".repeat(RECEIPT_WIDTH));
// 交易信息
printLeftRight("交易单号:", ());
printLeftRight("交易时间:", ().format(("yyyy-MM-dd HH:mm:ss")));
printLeftRight("收银员:", ());
("-".repeat(RECEIPT_WIDTH));
// 商品表头
(("%-14s %-4s %8s %4s", "商品名称", "数量", "单价", "小计"));
("-".repeat(RECEIPT_WIDTH));
// 商品列表
for (Item item : ()) {
// 简单处理商品名称过长，实际应进行截断或换行
String itemName = ().length() > 14 ? ().substring(0, 12) + ".." : ();
(("%-14s %-4d %8.2f %4.2f",
itemName, (), (), ()));
}
("-".repeat(RECEIPT_WIDTH));
// 结算信息
printLeftRight("总计:", ("%.2f", ()));
if (() > 0) {
printLeftRight("折扣:", ("-%.2f", ()));
}
if (() > 0) {
printLeftRight("税金:", ("%.2f", ()));
}
printLeftRight("应付金额:", ("%.2f", ()));
printLeftRight("实付金额:", ("%.2f", ()));
printLeftRight("找零:", ("%.2f", ()));
("=".repeat(RECEIPT_WIDTH));
// 页脚信息
printCentered("谢谢惠顾，欢迎下次光临！");
(""); // 留白，模拟切纸前的间距
}
// 居中打印
private void printCentered(String text) {
int padding = (RECEIPT_WIDTH - calculateDisplayLength(text)) / 2;
(" ".repeat((0, padding)) + text);
}
// 左右对齐打印
private void printLeftRight(String left, String right) {
int leftLen = calculateDisplayLength(left);
int rightLen = calculateDisplayLength(right);
int spaces = RECEIPT_WIDTH - leftLen - rightLen;
(left + " ".repeat((0, spaces)) + right);
}
// 计算字符串在小票上的显示长度（中文算2个字符，英文数字算1个）
private int calculateDisplayLength(String text) {
int length = 0;
for (char c : ()) {
if (c >= 0x4E00 && c = 0x4E00 && c 0) {
return NO_SUCH_PAGE;
}
Graphics2D g2d = (Graphics2D) graphics;
((), ());
// 设置字体，通常小票打印机字体较小
Font font = new Font("Monospaced", , 10);
(font);
int y = 0; // 当前Y坐标
// 打印店铺信息
y += 15; ((), (int) (() / 2 - ().stringWidth(()) / 2), y);
y += 12; ((), (int) (() / 2 - ().stringWidth(()) / 2), y);
y += 12; ("电话: " + (), (int) (() / 2 - ().stringWidth("电话: " + ()) / 2), y);
y += 15; ("---------------------------------", 0, y); // 分隔线
// 打印交易信息
y += 15; ("交易单号: " + (), 0, y);
y += 12; ("交易时间: " + ().format(("yyyy-MM-dd HH:mm:ss")), 0, y);
y += 12; ("收银员: " + (), 0, y);
y += 15; ("---------------------------------", 0, y);
// 打印商品表头
y += 15; (("%-14s %-4s %8s %4s", "商品名称", "数量", "单价", "小计"), 0, y);
y += 12; ("---------------------------------", 0, y);
// 打印商品列表
for (Item item : ()) {
y += 15;
String itemName = ().length() > 14 ? ().substring(0, 12) + ".." : ();
(("%-14s %-4d %8.2f %4.2f",
itemName, (), (), ()), 0, y);
}
y += 12; ("---------------------------------", 0, y);
// 打印结算信息
y += 15; (("总计: %23.2f", ()), 0, y);
if (() > 0) {
y += 12; (("折扣: %23.2f", -()), 0, y);
}
if (() > 0) {
y += 12; (("税金: %23.2f", ()), 0, y);
}
y += 12; (("应付金额: %21.2f", ()), 0, y);
y += 12; (("实付金额: %21.2f", ()), 0, y);
y += 12; (("找零: %25.2f", ()), 0, y);
y += 15; ("=================================", 0, y);
// 打印页脚信息
y += 15; ("谢谢惠顾，欢迎下次光临！", (int) (() / 2 - ().stringWidth("谢谢惠顾，欢迎下次光临！") / 2), y);
y += 30; // 留白

// 模拟切纸
// JPS通常通过打印机驱动自动处理，这里只是预留一些空白
return PAGE_EXISTS;
}
});

();
("使用JPS图形模式打印成功！");
}
public static void main(String[] args) {
Receipt receipt = new Receipt("XX连锁超市", "上海市浦东新区张江高科XX路", "021-88889999",
"202310270001", "cashier001");
(new Item("牛奶", 2, 12.50));
(new Item("面包", 1, 8.00));
(new Item("水果沙拉（大份）", 1, 25.00));
(5.00);
(0.06);
(100.00);
JpsReceiptPrinter printer = new JpsReceiptPrinter();
try {
// 请将 "Your Thermal Printer Name" 替换为您的热敏打印机在系统中的名称
// 例如："EPSON TM-T88V Receipt" 或 "POS-80"
(receipt, "POS-80");
} catch (PrinterException e) {
();
}
}
}

3.2 使用ESC/POS指令打印 (热敏打印机专用)

ESC/POS (Epson Standard Code for Point Of Sale) 是Epson公司制定的一套用于控制热敏打印机的标准指令集，几乎所有市面上的热敏小票打印机都兼容这一指令集。通过直接发送这些字节序列，我们可以精确控制打印机的行为，如字体大小、加粗、对齐、切纸、打印条码/二维码、开钱箱等。

优点：精确控制打印机，速度快，支持热敏打印机的所有高级功能，无需安装驱动程序（对于网络打印机）。

缺点：需要了解ESC/POS指令，处理字符编码（尤其是中文）较为复杂。

连接方式：
网络打印机：通过Socket连接到打印机的IP地址和端口（通常是9100）。
USB打印机：通过文件输出流连接到虚拟串口或USB设备文件（如Windows下的LPT1、COM1，或Linux下的/dev/usb/lp0）。需要确保USB驱动将打印机映射为可写入的文件或端口。
串口打印机：通过Java Comm API或其他串口库（如RXTX）连接。

以下是一个通过Socket连接网络热敏打印机并发送ESC/POS指令的示例：
import ;
import ;
import ;
import ;
import ;
public class EscPosPrinterService {
private String printerIp;
private int printerPort;
private OutputStream outputStream;
// 常用ESC/POS指令常量
public static final byte[] INIT = {0x1B, 0x40}; // 初始化打印机
public static final byte[] FEED_LINE = {0x0A}; // 换行
public static final byte[] CUT_PAPER = {0x1D, 0x56, 0x00}; // 全切
public static final byte[] SET_FONT_A = {0x1B, 0x4D, 0x00}; // 设置为字体A
public static final byte[] SET_FONT_B = {0x1B, 0x4D, 0x01}; // 设置为字体B
public static final byte[] BOLD_ON = {0x1B, 0x45, 0x01}; // 开启粗体
public static final byte[] BOLD_OFF = {0x1B, 0x45, 0x00}; // 关闭粗体
public static final byte[] ALIGN_LEFT = {0x1B, 0x61, 0x00}; // 左对齐
public static final byte[] ALIGN_CENTER = {0x1B, 0x61, 0x01}; // 居中对齐
public static final byte[] ALIGN_RIGHT = {0x1B, 0x61, 0x02}; // 右对齐
public static final byte[] TEXT_SIZE_NORMAL = {0x1D, 0x21, 0x00}; // 正常大小
public static final byte[] TEXT_SIZE_2H = {0x1D, 0x21, 0x01}; // 倍高
public static final byte[] TEXT_SIZE_2W = {0x1D, 0x21, 0x10}; // 倍宽
public static final byte[] TEXT_SIZE_2X = {0x1D, 0x21, 0x11}; // 倍宽高
public static final byte[] OPEN_CASH_DRAWER = {0x1B, 0x70, 0x00, 0x32, 0x32}; // 开钱箱
// 字符编码，热敏打印机常使用GBK或CP936支持中文，或UTF-8
// 根据打印机型号和配置选择
private Charset charset = ("GBK"); // 假设打印机使用GBK编码
// private Charset charset = StandardCharsets.UTF_8; // 如果打印机支持UTF-8
private static final int RECEIPT_WIDTH = 32; // 假设58mm打印机，每行32字符
public EscPosPrinterService(String printerIp, int printerPort) {
= printerIp;
= printerPort;
}
public void connect() throws IOException {
Socket socket = new Socket(printerIp, printerPort);
outputStream = ();
("成功连接到打印机: " + printerIp + ":" + printerPort);
}
public void close() throws IOException {
if (outputStream != null) {
();
("打印机连接已关闭。");
}
}
// 发送字节数组
private void sendCommand(byte[] command) throws IOException {
if (outputStream != null) {
(command);
} else {
throw new IOException("打印机未连接。");
}
}
// 打印文本并换行
public void printText(String text) throws IOException {
sendCommand((charset));
sendCommand(FEED_LINE);
}
// 打印并居中对齐
public void printCentered(String text) throws IOException {
sendCommand(ALIGN_CENTER);
printText(text);
sendCommand(ALIGN_LEFT); // 恢复左对齐
}

// 打印左右对齐文本
public void printLeftRight(String left, String right) throws IOException {
int leftLen = calculateDisplayLength(left);
int rightLen = calculateDisplayLength(right);
int spaces = RECEIPT_WIDTH - leftLen - rightLen;
String formatted = left + " ".repeat((0, spaces)) + right;
printText(formatted);
}
// 计算字符串在小票上的显示长度
private int calculateDisplayLength(String text) {
int length = 0;
for (char c : ()) {
if (c >= 0x4E00 && c > 8);
sendCommand(new byte[]{0x1D, 0x28, 0x6B, pL, pH, 0x31, 0x50, 0x30}); // Store data
sendCommand(dataBytes);
// 打印QR码 (GS ( k )
sendCommand(new byte[]{0x1D, 0x28, 0x6B, 0x03, 0x00, 0x31, 0x51, 0x30}); // Print stored QR code
sendCommand(FEED_LINE); // QR码后换行
}
// 打印小票主方法
public void printReceipt(Receipt receipt) throws IOException {
sendCommand(INIT); // 初始化打印机
sendCommand(ALIGN_CENTER); // 居中
sendCommand(TEXT_SIZE_2W); // 倍宽
printText(());
sendCommand(TEXT_SIZE_NORMAL); // 恢复正常大小
printText(());
printText("电话: " + ());

sendCommand(ALIGN_LEFT); // 左对齐
printDivider('-');
printLeftRight("交易单号:", ());
printLeftRight("交易时间:", ().format(("yyyy-MM-dd HH:mm:ss")));
printLeftRight("收银员:", ());
printDivider('-');
// 商品表头
String header = ("%-14s %-4s %8s %4s", "商品名称", "数量", "单价", "小计");
printText(header);
printDivider('-');
// 商品列表
for (Item item : ()) {
String itemName = ().length() > 14 ? ().substring(0, 12) + ".." : ();
String itemLine = ("%-14s %-4d %8.2f %4.2f",
itemName, (), (), ());
printText(itemLine);
}
printDivider('-');
// 结算信息
printLeftRight("总计:", ("%.2f", ()));
if (() > 0) {
printLeftRight("折扣:", ("-%.2f", ()));
}
if (() > 0) {
printLeftRight("税金:", ("%.2f", ()));
}
sendCommand(BOLD_ON); // 加粗应付金额
printLeftRight("应付金额:", ("%.2f", ()));
sendCommand(BOLD_OFF);
printLeftRight("实付金额:", ("%.2f", ()));
printLeftRight("找零:", ("%.2f", ()));
printDivider('=');
// 页脚信息
sendCommand(ALIGN_CENTER);
printText("谢谢惠顾，欢迎下次光临！");
printQRCode("/feedback?id=" + ()); // 打印二维码
sendCommand(FEED_LINE);
sendCommand(FEED_LINE);
sendCommand(FEED_LINE);
sendCommand(CUT_PAPER); // 切纸
}

public static void main(String[] args) {
Receipt receipt = new Receipt("XX连锁超市", "上海市浦东新区张江高科XX路", "021-88889999",
"202310270001", "cashier001");
(new Item("牛奶", 2, 12.50));
(new Item("面包", 1, 8.00));
(new Item("水果沙拉（大份）", 1, 25.00));
(5.00);
(0.06);
(100.00);
// 请替换为您的热敏打印机IP和端口
String printerIp = "192.168.1.100";
int printerPort = 9100; // 默认端口通常为9100
EscPosPrinterService printer = new EscPosPrinterService(printerIp, printerPort);
try {
();
(receipt);
();
} catch (IOException e) {
("打印机操作失败: " + ());
();
}
}
}

第四章：高级特性与考量

4.1 字符编码与国际化

处理中文是小票打印中的一个常见挑战。热敏打印机通常支持GBK（或CP936）或UTF-8编码。如果打印机固件默认是GBK，而您发送UTF-8编码的中文，可能会出现乱码。务必根据打印机型号和配置，在EscPosPrinterService中设置正确的Charset。

对于国际化，您可能需要为不同语言准备不同的模板，或者使用资源束（Resource Bundle）来动态加载文本内容。

4.2 条码与二维码

ESC/POS指令集包含了打印一维条码（如EAN-13, CODE39）和二维码（如QR Code）的指令。但不同打印机的具体指令参数可能略有差异，需要查阅打印机厂商提供的编程手册。

如果打印机不支持直接打印图像二维码，可以考虑使用Java库（如ZXing）生成二维码图片，然后将图片转换为位图数据，再通过ESC/POS的位图打印指令发送给打印机。这会增加数据量和打印时间，且对打印机内存有一定要求。

4.3 打印队列与错误处理

在实际POS系统中，打印任务通常需要异步处理，以避免阻塞主线程。可以使用ExecutorService或消息队列来管理打印任务。同时，健壮的错误处理机制至关重要，包括：
连接失败：打印机未开机、IP地址错误、网络故障。
IO异常：打印过程中连接断开、写入失败。
打印机状态：缺纸、打印头过热、卡纸（某些高级打印机可以通过状态指令获取）。

对于无法处理的错误，应记录日志并通知用户，甚至提供重新打印或打印到备用打印机的选项。