根据REST APIs的成熟度模型 ,此规范关注的是Level 2的APIs.  1 设计指南 HTTP APIs主要由四部分组成:HTTP,URL,资源,资源的表述(JSON).资源的表述格式通常都采用JSON,故而后面就使用JSON代指资源的表述.根据这些组成部分,按照以下3个步骤设计APIs: 基于资源设计APIs. 基于URL标识资源. 基于JSON和HTTP操作URL标识的资源. 1.1 基于资源设计API 设计HTTP APIs的首要任务是识别出业务领域中存在的资源.资源是对服务端提

最近在使用sea.js.大家知道sea.js遵循CMD规范.该规范的英文说明很简洁,我试着翻译了一下,旨在交流. Common Module Definition 通用模块定义规范 This specification addresses how modules should be written in order to be interoperable in browser-based environment. By implication, this specification define

在 Sea.js 中,所有 JavaScript 模块都遵循 CMD(Common Module Definition) 模块定义规范.该规范明确了模块的基本书写格式和基本交互规则. 在 CMD 规范中,一个模块就是一个文件.代码的书写格式如下: define(factory); define Function define 是一个全局函数,用来定义模块. define define(factory) define 接受 factory 参数,factory 可以是一个函数,也可以是一个对象或字

CMD 模块定义规范 在 Sea.js 中,所有 JavaScript 模块都遵循 CMD(Common Module Definition) 模块定义规范.该规范明确了模块的基本书写格式和基本交互规则. 在 CMD 规范中,一个模块就是一个文件.代码的书写格式如下: define(factory); define Function define 是一个全局函数,用来定义模块. define define(factory) define 接受 factory 参数,factory 可以是一个函数

转自http://www.cnblogs.com/hongchenok/p/3685677.html   CMD 模块定义规范 在 Sea.js 中,所有 JavaScript 模块都遵循 CMD(Common Module Definition) 模块定义规范.该规范明确了模块的基本书写格式和基本交互规则. 在 CMD 规范中,一个模块就是一个文件.代码的书写格式如下: define(factory); define Function define 是一个全局函数,用来定义模块. define

在 Sea.js 中,所有 JavaScript 模块都遵循 CMD(Common Module Definition) 模块定义规范.该规范明确了模块的基本书写格式和基本交互规则. 在 CMD 规范中,一个模块就是一个文件.代码的书写格式如下: define(factory); define Function define 是一个全局函数,用来定义模块. define define(factory) define 接受 factory 参数,factory 可以是一个函数,也可以是一个对象或字

在 Sea.js 中,所有 JavaScript 模块都遵循 CMD(Common Module Definition) 模块定义规范.该规范明确了模块的基本书写格式和基本交互规则. 在 CMD 规范中,一个模块就是一个文件.代码的书写格式如下: define(factory); define Function define 是一个全局函数,用来定义模块. define define(factory) define 接受 factory 参数,factory 可以是一个函数,也可以是一个对象或字

/// @file main.cpp /// @brief 不包含SDK头文件, 补全API定义 #ifdef __cplusplus extern "C" { #endif /* __cplusplus */ #define DECLARE_HANDLE(name) struct name##__ { int unused; }; typedef struct name##__* name DECLARE_HANDLE(HWND); DECLARE_HANDLE(HINSTANCE)

本节主要介绍Repository Bean中方法定义规范. 1.方法不是随便声明,需要符合一定的规范. 2.按照Spring Data的规范,查询方法以find|read|get开头,涉及条件查询时,条件的属性用条件关键字连接,要注意的是:条件属性需要首字母大写. 3.Spring Data支持的关键字如下: 4.支持属性的级联查询,若当前类有符合条件的属性,则优先使用,而不使用级联属性.若想使用级联属性,则属性之间用"_"连接. package com.ntjr.springdata

第一个Python程序 可以打开notepad或者其他文本编辑器,输入:print("Hello Python!"),将文件保存到任意盘符下,后缀名是  .py 两种python程序执行方式 1. 在终端里执行代码: 执行命令:Python  文件保存的路径\文件名.py   (图中红色) 之所以能这样直接执行,是因为配置了环境变量,否则会报错,告诉你找不到解释器 python:表示指定执行程序的解释器 2. 进入交互模式输入并实时获取执行结果 (图中蓝色) 解释器路径 #!/usr/

RESTful API 编写规范 在一个RESTful系统里,客户端向服务端发起索取资源的操作只能通过HTTP协议语义来进行交互.最常用的HTTP协议语义有以下5个: GET GET:发送一条或者多条GET请求都不会改变服务器里面的资源,同一个request发一遍和发两遍都将获得相同结果.这个交互行为是幂等的. GET:从服务器取出资源(一项或多项) @ApiOperation(value="获取用户列表", notes="") @RequestMapping(va

前两篇文章分别介绍了本系列文章的背景以及根据业务职能对商城系统做了服务的拆分,其中每个服务又可分为如下三类: api服务 - BFF层,对外提供HTTP接口 rpc服务 - 内部依赖的微服务,实现单一的业务功能 rmq服务 - 负责流式任务的处理,如消费kafka等等 admin服务 - 对内部管理后台提供HTTP接口,通常数据操作权限比较高 如果没看过前两篇文章可通过如下传送门查看 go-zero 微服务实战系列(一.开篇) go-zero微服务实战系列(二.服务拆分) 前两篇文章比较偏理论,

目录 1       前言 1.1         编写目的 1.2        预期读者 1.3         关于API设计开发 2       API公共说明 3       文档API索引 4       单个API说明 4.1         API基本信息 4.2        API输入参数 4.2.1          参数分类 4.2.2          参数类型 4.2.3         参数说明表格 4.3         API响应结果 4.3.1       

一.引子 既然出现了分布式场景(DTP模型), 大java也及时制定出一套规范来给各大应用服务器.数据库/mq等厂商使用,以方便管理互通--->JTA闪亮登场.JTA(Java Transaction API),即Java事务API规范.JTA规范指定了事务管理器(TM)与分布式事务系统中涉及的各方(应用程序AP.资源管理器RM.应用服务器AS)之间的高级接口.JTA规范包含第一节讲的XA规范,包含的那部分就是XA规范的java版本的实现. oracle官方JTA规范:http://downlo

AMD 即Asynchronous Module Definition,中文名是“异步模块定义”的意思.它是一个在浏览器端模块化开发的规范,服务器端的规范是CommonJS.   模块将被异步加载,模块加载不影响后面语句的运行.所有依赖某些模块的语句均放置在回调函数中.   AMD 是 RequireJS 在推广过程中对模块定义的规范化的产出.   define() 函数 AMD规范只定义了一个函数 define,它是全局变量.函数的描述为: define(id?, dependencies?,

[从零开始学习Spirng Boot-常见异常汇总] 事情的起因:有人问过我们这个这个问题:为什么我利用Spring data jpa写的方法没有按照我想要的情况进行执行呢?我记得当时只是告诉他你你先看看Spring Data的命名规则吧.所以在这一小节把Spring Data方法定义的规则简单说明下. (1)简单条件查询 简单条件查询:查询某一个实体类或者集合. 按照Spring Data的规范的规范,查询方法以find | read | get 开头,涉及查询条件时,条件的属性用条件关键字连

Spring Data Jpa方法定义的规则: (1)简单条件查询 简单条件查询:查询某一个实体类或者集合. 按照Spring Data的规范的规定,查询方法以find | read | get开头,涉及查询条件时,条件的属性用条件关键字连接,要注意的是:条件属性以首字母大写. 例如:定义一个Entity实体类: classPeople{ private String firstName; private String lastName; } 以上使用and条件查询时,应这样写:findByLa

Node.js 除了用来编写 WEB 应用之外,还可以用来编写 API 服务,我们在本文中会介绍编写 Node.js Rest API 的最佳实践,包括如何命名路由.进行认证和测试等话题,内容摘要如下: 正确使用 HTTP Method 和路由 正确的使用 HTTP 状态码 使用 HTTP Header 来发送元数据 为 REST API 挑选合适的框架 要对 API 进行黑盒测试 使用基于 JWT 的无状态的认证机制 学会使用条件请求机制 拥抱接口调用频率限制(Rate-Limiting) 编

Restful API 目前比较成熟的一套互联网应用程序的API设计理论 一.协议 API与用户的通信协议,总是使用HTTPs协议. 二.域名 应该尽量将API部署在专用域名之下. https://api.xxxxxx.cn/ https://xxxxxx.cn/api/ 三.版本(Versioning) 应该将API的版本号放入URL. https://xxxxxx.cn/api/v1/ 另一种做法是,将版本号放在HTTP头信息中,但不如放入URL方便和直观. 四.路径(Endpoint) 在

变量定义的规则: 变量名只能是 字母.数字或下划线的任意组合 变量名的第一个字符不能是数字 以下关键字不能声明为变量名['and', 'as', 'assert', 'break', 'class', 'continue', 'def', 'del', 'elif', 'else', 'except', 'exec', 'finally', 'for', 'from', 'global', 'if', 'import', 'in', 'is', 'lambda', 'not', 'or', 'p

背景 在数据库中NULL值是指UNKNOWN的值,不存储任何值,在排序时,它排在有值的行前面还是后面通过语法来指定. 例如 -- 表示null排在有值行的前面 select * from tbl order by id nulls first; -- 表示null排在有值行的后面 select * from tbl order by id nulls last; 同时对于有值行,可以指定顺序排还是倒序排. -- 表示按ID列顺序排 select * from tbl order by id [a