SaaS行业命名规范

    很多企业在启动软件开发的时候,完成没有命名规范,导致代码的可读性极差。而业界对于命名,却没有一个统一的命名规范,比如说,获取客户列表,Java类的方法是用get***List还是list****?这些完全的统一的规范 。

    这里给出SaaS行业额命名规范,参考了阿里编码规范,加上我十几年来对业务的理解而写成的,可以作为一个开发人员形成一个统一的规范,建议一个项目在启动之前,采用该规范。

    该规范并不是行业规范,是基于作者我十年内的经验写成的,可以说具备非常高的可信度,如果开发人员没有这个方面的命名规范,建议采纳。

  1. JAVA类主要后缀命名规范

类型

后缀

例子

说明

DAO类

Dao

UserDao

 

扫描二维码关注公众号,回复: 2630072 查看本文章

Service接口类

Service

UserService

 

Service实现类

ServiceImpl

UserServiceImpl

 

Controller类

Controller

UserController

实现HTTP访问

数据对象

无后缀

User

数据对象,类名即为数据表名

数据传送对象

DTO

UserDTO

前面为业务领域相关的名称

展示对象

VO

UserVO

展示对象,前面一般为网页名称

Spring Boot入库程序

Application

OaApplication

 

JUnit测试类

Test

UserTest

 

异常类

Exception

CrmException

 

工具类

Utils

MailUtils

 

枚举类

Enum

MessageTypeEnum

 

常量类

Constants

NsqConstants

 

属性类

Properties

ImProperties

这个类用来保持从统一配置台或者配置文件获取的配置数据

工厂类

Factory

EncoderFactory

工厂类用来构造各种实现类

连接池类

Pool

IoSessionPool

 

NSQ消费者处理类

Handler

CustomerTrajectoryHandler

 

2.类方法主要前缀命名规范

类型

前缀

例子

说明

获取单个对象

get

getCrmDetail

 

获取多个对象

list

listUserInfo

 

获取统计值

count

countUser

 

插入

save/insert

insertCustomerRelation

 

删除

remove/delete

removeOneUser

 

更新

Update

updateCrmDetail

 

 

3.业务常用术语命名规范

3.1 通用术语

中文名称

含义

英文名称

缩写

客户

指企业员工的客户,联系人

Crm

Crm

用户/员工

 

User

User

帐号

 

Account

Account

操作员/操作

指后台企业管理配置的操作人,是具有操作权限的用户,如新增员工

Operator/Operate

Operator/Oper

管理者

 

Administrator

Admin

访客

 

Visitor

Visitor

公司

指公司客户

Company

Comp

企业

 

Corporation

Corp

代理商

 

Agent

Agent

密码

 

Password

Pass

权限认证

 

Authority

Auth

设置/配置

资料设置,密码设置等

Configuration

Config

创建时间

创建时间,创建人,更新时间,更新人这四个字段一般用在表上面,前两个记录表数据的创建信息,后两个记录表数据的更新时间

Create time

Create time

创建人

 

Create by

Create by

更新时间

 

Update time

Update time

更新人

 

Update by

Update by

开始时间

开始时间和结束时间,一般用在查询中

Start time

Start time

结束时间

 

End time

End time

通知

指系统发出的消息,如通知用户系统升级

Notice

Notice

消息

指用户发送的消息

Message

Msg

字数限制

 

Word limit

limit

通讯录

如:通讯录导入

Address book

Address book

模板

如:导入模板

Template

Template

安全

 

Security

Security

昵称/别名

 

Alias

Alias

第三方

 

Third party

3party

应用

 

Application

App

状态

 

Status

Status

域名

 

Domain

Domain

备注

 

Remark

Remark

附件

 

Attachment

Attach

批量

 

Batch

Batch

任务

 

Task

Task

升级

 

Upgrade

Upgrade

设备

泛指手机、电脑等

Device

Device

目录

 

Dir

Dir

过期

 

Expire

Expire

地址

 

Address

Addr

迁移

数据迁移等

Migration/migrate

Migrate

金额

指钱相关的数额

Amount of money

Amount

数额

客户总数,在线个数等

Numbers

Nums

统计

 

Statistics

statis

收入

收入和支出是类型,而金额没有分类型。比如说,收入表里面有个字段表示金额

Revenue

Revenue

支出

 

Expenditure

Expend

冲突

 

Conflict

Conflict

成功

 

Success

Success

失败

 

Failure[黄育源1] 

Fail

 

 

3.2 IM相关业务术语

中文名称

含义

英文名称

缩写

在线

 

Online

Online

离线

 

Offline

Offline

个性签名

 

Signature

Sign

聊天

 

Chat

Chat

聊天记录

 

Chat Record

Chat Record

自动回复

 

Auto reply

Auto reply

在线客服

 

Web chat

WebChat

3.3 企业管理服务业务术语

中文名称

含义

英文名称

缩写

组织架构/部门

 

Organization

Orga

职位

员工的职位

Position

Position

价格

 

Price

Price

合同

 

Contract

Contract

订单

 

Order

Order

发票

 

Invoice

Invoice

产品

 

Product

Product

账单

 

Bill

Bill

 

猜你喜欢

转载自blog.csdn.net/sunlen/article/details/81514916