REST 规则表述(第一部分)。

本文介绍了URI设计的基本原则,包括格式规范、资源类型定义及路径和查询的设计。强调了使用正斜杠表示层级、避免URI结尾出现斜杠等细节,并对文档、集合、存储和控制器资源进行了区分说明。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

[b]URI格式[/b]
第一:正斜杠(/)必须用来表示层级关系。

第二:正斜杠(/)不能出现在URI的结尾处。
例如:
错误的表示方式是:
http://xxxx.yyyy.com/shapes/
正确的表示方式是:
http://xxxx.yyyy.com/shapes

第三:连字符(-)是用来改善URI的可读性的
例如:http://xxxx.yyyy.com/this-is-my-first-post

第四:不要在URI中使用下划线(_)

第五:URI中应当全部使用小写字母(不包括查询参数)

第六:不要在URI中描述文件的格式
例如:
错误的表示方式是:
http://xxxx.yyyy.com/data/user.json
正确的表示方式是:
http://xxxx.yyyy.com/data/user


[b]URI资源原型 Resource Archetypes[/b]

Document
文档资源是一个独特的概念,类似于一个对象实体,或数据库记录。以下的每个URI都标记了一个文档资源:
http://api.soccer.restapi.org/leagues/seattle
http://api.soccer.restapi.org/leagues/seattle/teams/trebuchet
http://api.soccer.restapi.org/leagues/seattle/teams/trebuchet/players/mike


Store
存储是一个客户端管理的资源库。客户可以放入、取出、删除它们,例如:
PUT /users/1234/favorites/alonso

Collection
集合资源是服务器端管理的目录,客户可能会提出一个新的资源被放入到集合中。以下的每个URI都标记了一个资源集合:
http://api.soccer.restapi.org/leagues
http://api.soccer.restapi.org/leagues/seattle/teams
http://api.soccer.restapi.org/leagues/seattle/teams/trebuchet/players


Controller
资源模型的控制器是一个程序概念。Controller就像执行某种方法函数。例如常见的CRUD操作。以下URI描述了请求后台Controller的写法:

GET /read/245743/remark -->读取245743的描述信息
GET /read/245743/body -->读取245743的主要文字


[b]URI 路径设计[/b]

第一:文档名称必须使用单数名词

第二:集合必须是复数名词

第三:Store的名字必须是复数名词。

第四:Controller的名称必须是一个动词或动词短语

第五:可变路径的值,应该使用基于身份认证的值(例如ID)

第六:CRUD 函数名不能出现在URI中
例如:
错误的表示方法:
GET /deleteUser?id=1234
GET /deleteUser/1234
DELETE /deleteUser/1234
POST /users/1234/delete
以上都是错误的表示方法,而正确的表示方法如下:
DELETE /users/1234

[b]URI的查询设计[/b]

第一:一个URL应当可以过滤集合(或存储(store))
例如:
GET /users -->查询所有用户
GET /users?role=admin -->根据条件过滤用户

第二:分页查询应当单独列出来
例如:
GET /users?pageSize=25&pageStartIndex=50
POST /users/search
资源下载链接为: https://pan.quark.cn/s/22ca96b7bd39 在 IT 领域,文档格式转换是常见需求,尤其在处理多种文件类型时。本文将聚焦于利用 Java 技术栈,尤其是 Apache POI 和 iTextPDF 库,实现 doc、xls(涵盖 Excel 2003 及 Excel 2007+)以及 txt、图片等格式文件向 PDF 的转换,并实现在线浏览功能。 先从 Apache POI 说起,它是一个强大的 Java 库,专注于处理 Microsoft Office 格式文件,比如 doc 和 xls。Apache POI 提供了 HSSF 和 XSSF 两个 API,其中 HSSF 用于读写老版本的 BIFF8 格式(Excel 97-2003),XSSF 则针对新的 XML 格式(Excel 2007+)。这两个 API 均具备读取和写入工作表、单元格、公式、样式等功能。读取 Excel 文件时,可通过创建 HSSFWorkbook 或 XSSFWorkbook 对象来打开相应格式的文件,进而遍历工作簿中的每个 Sheet,获取行和列数据。写入 Excel 文件时,创建新的 Workbook 对象,添加 Sheet、Row 和 Cell,即可构建新 Excel 文件。 再看 iTextPDF,它是一个用于生成和修改 PDF 文档的 Java 库,拥有丰富的 API。创建 PDF 文档时,借助 Document 对象,可定义页面尺寸、边距等属性来定制 PDF 外观。添加内容方面,可使用 Paragraph、List、Table 等元素将文本、列表和表格加入 PDF,图片可通过 Image 类加载插入。iTextPDF 支持多种字体和样式,可设置文本颜色、大小、样式等。此外,iTextPDF 的 TextRenderer 类能将 HTML、
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值