# Zebra-printer-webServices

**Repository Path**: chencdashi/zebra-printer-web-services

## Basic Information

- **Project Name**: Zebra-printer-webServices
- **Description**: Zebra打印机webservice方案
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-02-10
- **Last Updated**: 2026-03-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Zebra Print API - 轻量级版本

基于 Spring Boot 的轻量级 Zebra 打印机 RESTful API，无需 Tomcat，单个 jar 文件即可运行。

## 特点

- ✅ 轻量级：单个 jar 文件，内嵌服务器
- ✅ 简单部署：`java -jar` 即可运行
- ✅ 快速启动：几秒钟即可启动完成
- ✅ 易于配置：通过 `application.properties` 配置
- ✅ 无需 Web 界面：纯 RESTful API

## 快速开始

### 一键启动（推荐）

```bash
./start.sh
```

这个命令会自动完成：
1. 停止旧服务（如果存在）
2. 编译构建项目
3. 启动新服务

### 停止服务

```bash
./stop.sh
```

### 手动构建（可选）

如果只想构建不启动：
```bash
./build.sh
```

## API 接口

### 打印标签

**接口地址：** `POST /zebra/api/print`

**请求参数：**

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| productModel | String | 是 | 产品型号 |
| snCode | String | 是 | 生产序列号 |

**响应示例：**

```json
{
  "success": true,
  "message": "打印任务已发送",
  "data": {
    "productModel": "MCCX D800 X2L",
    "productionDate": "2026-03-02",
    "snCode": "210235A57X5261C000CC"
  }
}
```

## 使用示例

### cURL

```bash
curl -X POST "http://localhost:8080/zebra/api/print" \
  -d "productModel=MCCX D800 X2L" \
  -d "snCode=210235A57X5261C000CC"
```

### Python

```python
import requests

url = 'http://localhost:8080/zebra/api/print'
data = {
    'productModel': 'MCCX D800 X2L',
    'snCode': '210235A57X5261C000CC'
}

response = requests.post(url, data=data)
print(response.json())
```

## 配置

编辑 `src/main/resources/application.properties`：

```properties
# 服务器端口
server.port=8080

# 打印机 IP 地址
printer.ip=172.16.10.182

# 打印机端口
printer.port=9100
```

## 查看日志

```bash
tail -f logs/app.log
```

## 系统要求

- Java 17 或更高版本
- Maven 3.6 或更高版本

## 与 Tomcat 版本对比

| 特性 | Tomcat 版本 | Spring Boot 版本 |
|------|------------|-----------------|
| 部署方式 | WAR 包 + Tomcat | 单个 jar 文件 |
| 启动时间 | ~10 秒 | ~3 秒 |
| 内存占用 | ~200MB | ~150MB |
| 配置复杂度 | 高 | 低 |
| 适用场景 | 需要 Web 界面 | 纯 API 服务 |