專案演示

後端

管理前端

微信小程式

vue+uniapp商城實戰 | 第一篇：【有來小店】微信小程式快速開發接入Spring Cloud OAuth2認證中心完成授權登入

一. 程式碼規範

1. Service/DAO 層方法命名規約

1）獲取單個物件的方法用 get 做字首。

2）獲取多個物件的方法用 list 做字首，複數結尾，如：listObjects。

3）獲取統計值的方法用 count 做字首。

4）插入的方法用 save/insert 做字首。

5）刪除的方法用 remove/delete 做字首。

2. SQL語句規範

1）SQL 語句中表的別名前加 as，並且以 t1、t2、t3、...的順序依次命名。

select t1.name from table_first as t1, table_second as t2 where t1.id=t2.id;

摘自:

Java開發手冊【泰山版】

二. 介面規範

專案介面是基於REST構建的API也就是RESTful架構風格設計。

在RESTful架構中，每個URL代表一種資源，所以不能有動詞，只能有名詞，而且所用的名詞往往與資料庫的表格名對應。一般來說，資料庫中的表都是同種記錄的"集合"，所以API中的名詞也應該使用複數。

最佳案例

https://youlai.store/users GET 獲取所有使用者資訊
https://youlai.store/users/1 GET 獲取標識為1使用者資訊
https://youlai.store/users/1 DELETE 刪除標識為1使用者資訊
https://youlai.store/users/1 Patch 更新標識為1使用者部分資訊,包含在body中
https://youlai.store/users POST 新增新的使用者
https://youlai.store/users/me GET 獲取當前使用者資訊

如果記錄數量很多，伺服器不可能都將它們返回給使用者。API應該提供引數，過濾返回結果。

?limit=10：指定返回記錄的數量
?offset=10：指定返回記錄的開始位置。
?page=2&per_page=100：指定第幾頁，以及每頁的記錄數。
?sortby=name&order=asc：指定返回結果按照哪個屬性排序，以及排序順序。
?animal_type_id=1：指定篩選條件

參考:

RESTful API 設計指南

三. Git規範

1. Commit message的格式規範

Commit message 包括三個欄位：type（必需）、scope（可選）和subject（必需）。

<type>(<scope>): <subject>

1).type

type用於說明 commit 的類別，規範使用以下標識。

feat：新功能（feature）
fix：修補bug
docs：文件（documentation）
style：格式（不影響程式碼執行的變動）
refactor：重構（即不是新增功能，也不是修改bug的程式碼變動）
test：增加測試
chore：構建過程或輔助工具的變動
revert：回滾到上一個版本
merge：程式碼合併
sync：同步主線或分支的Bug

2).scope

scope用於說明 commit 影響的範圍，比如資料層、控制層、檢視層等等，視專案不同而不同。

3). subject

subject是 commit 目的的簡短描述，不超過50個字元。

最佳案例

 git commit -m docs(README.md):分支修改專案說明文件

格式化Commit message的好處

1). 快速預覽歷史

git log <last tag> HEAD --pretty=format:%s

2). 快速過濾查詢

git log <last release> HEAD --grep feature

3). commit生成Change log

Change Log 是釋出新版本時，用來說明與上一個版本差異的文。

參考:

Commit message 和 Change log 編寫指南

2. 分支開發主幹釋出模式

禁止在主幹直接修改程式碼，需在開發分支開發並在測試環境測試通過之後由相關人員同步到主幹

最佳案例

[master] > git checkout dev

[dev] > git add .
[dev] > git commit -m docs(README.md):分支修改專案說明文件
[dev] > git push origin dev
[dev] > git checkout master

[master] > git merge dev
[master] > git add .
[master] > git commit -m sync:主幹同步分支
[master] > git push origin master