# JPrint

**Repository Path**: miaoding/java-print

## Basic Information

- **Project Name**: JPrint
- **Description**: 使用java实现的打印控件，供web调用实现静默(无预览)打印的效果
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 7
- **Created**: 2024-08-23
- **Last Updated**: 2025-05-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

@[TOC]()

# 一、项目介绍

使用java实现的一个静默打印控件。可<font color=red>安装在客户机上或者服务器上</font>进行使用。支持ws协议和http协议。更多 版本请前往 <a href='https://gitee.com/BuYaoPenXiangShui/java-print/releases'>releases</a>下载。

<font size=4 color=green>🍉此文档内容针对当前版本进行说明并非适用于所有版本。</font>可前往<a href='https://gitee.com/BuYaoPenXiangShui/java-print/releases'>releases</a>查看版本对应说明。



# 二、API说明

<font color=red>所有的响应信息通过ws协议传递</font>，如无特殊说明，接口通过ws协议调用。

| 端口号 | 2024 |
| :----: | :--: |

## 入参说明

### 1.paperSize

​	缺省时，按客户端打印机设置

|  参数值   |       说明       |
| :-------: | :--------------: |
|     A     |     A 尺寸。     |
|     B     |     B 尺寸。     |
|     C     |     C 尺寸。     |
|     D     |     D 尺寸。     |
|     E     |     E 尺寸。     |
| EXECUTIVE | executive 尺寸。 |
|   FOLIO   |   folio 尺寸。   |
|  INVOICE  |  invoice 尺寸。  |
|  ISO_A0   |    A0 尺寸。     |
|  ISO_A1   |    A1 尺寸。     |
|  ISO_A10  |    A10 尺寸。    |
|  ISO_A2   |    A2 尺寸。     |
|  ISO_A3   |    A3 尺寸。     |
|  ISO_A4   |    A4 尺寸。     |
|  ISO_A5   |    A5 尺寸。     |
|  ISO_A6   |    A6 尺寸。     |
|  ISO_A7   |    A7 尺寸。     |
|  ISO_A8   |    A8 尺寸。     |
|  ISO_A9   |    A9 尺寸。     |

### 2.type

| 参数值 |    说明    |
| :----: | :--------: |
|  PDF   |  PDF打印   |
|  IMG   |  图片打印  |
|  TEXT  | 纯文本打印 |
|  HTML  |  html打印  |

### 3.source

| 参数值 |     说明     |
| :----: | :----------: |
|  text  |    纯文本    |
|  path  | 本地文件地址 |
|  url   |   网络地址   |
|  blob  |    文件流    |

### 4.direction

​	缺省时，按客户端打印机设置

| 参数值            | 说明                                          |
| ----------------- | --------------------------------------------- |
| PORTRAIT          | 默认，不做任何处理                            |
| LANDSCAPE         | 将要描绘的打印流页旋转 +90 度（即逆时针方向） |
| REVERSE_LANDSCAPE | 将要描绘的打印流页旋转 -90 度（即顺时针方向） |
| REVERSE_PORTRAIT  | 将要描绘的打印流页旋转 180 度                 |



## 1.服务连接

<table >
<tr align="left" >
<td bgcolor=#E6E6FA  colspan=2 >
ws://127.0.0.1:2024/print </td>
</tr>
</table> </td>

🍎返回信息

```json
{"code":0,"msg":"操作成功","data":"0"}
```

data为sessionId，用于后面进行数据通信。

## 2.打印

### 1.打印单个文件

| POST | /print/single |
| ---- | ------------- |

🍎参数说明：

| 参数      | 类型    | 必填                      |                       说明                        | 示例     |
| :-------- | ------- | ------------------------- | :-----------------------------------------------: | -------- |
| sessionId | String  | 否                        |          sessionId，用于打印状态消息通信          | 0        |
| copies    | Integer | 否                        |                打印份数。缺省时为1                | 1        |
| paperSize | String  | 否                        |        纸张尺寸，缺省时,为客户机打印机设置        | ISO_A4   |
| type      | String  | <font color=red>是</font> |                     打印类型                      | PDF      |
| source    | String  | <font color=red>是</font> |                   打印文档来源                    | blob     |
| content   | String  | 否                        | 当source非blob时，此值<font color=red>必填</font> |          |
| file      | blob    | 否                        | 当source为blob时，此值<font color=red>必填</font> |          |
| direction | String  | 否                        |         打印方向,缺省时为客户机打印机设置         | PORTRAIT |

🍏示例数据:

```json
{
    "sessionId": "0",
    "copies": 1,
    "paperSize": "ISO_A4",
    "type": "PDF",
    "source": "url",
    "content": "http://127.0.0.1/print.pdf",
    "direction": "PORTRAIT" 
}
```

### 2.取消打印作业(<font color=red>v3已移除</font>)

如果没有正在进行的打印作业，则此调用不执行任何操作。

| GET  | /print/cancel |
| ---- | ------------- |



# 三、其它

## 1.开机自启

支持一键开机自启功能。失败的话会有提示信息

![image-20240514163812433](C:\Users\admin\AppData\Roaming\Typora\typora-user-images\image-20240514163812433.png)

一般把安全管家或者杀毒软件关了即可开启成功。

(ps:`感兴趣的可自行修改代码绕过安全权限检测`)

🍉手动设置：

1.Win+R .输入regedit，打开注册表

![image-20240514164437106](C:\Users\admin\AppData\Roaming\Typora\typora-user-images\image-20240514164437106.png)

2.打开

```
\HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run
```

然后设置相应值即可。