怎样编写 OpenAPI

OpenAPI

OpenAPI 是一种与语言无关的文档,用来描述 web 服务。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
openapi: 3.0.3
info:
title: hi
version: 0.0.1

paths:
/hi:
get:
responses:
'200':
description: OK
content:
text/plain:
schema:
type: string
enum: ["hello"]

比如以上文档就描述了这样一个服务, 当你用 GET 方法访问 /hi 接口时

1
GET /hi

就会得到一个 body 为 hello 的响应

1
2
3
4
HTTP/1.0 200 OK
Content-Type: text/plain

hello

接下来我们介绍如何在 OpenAPI 中描述一个接口, 详细文档请移步: 编写 OpenAPI

设计原则概览

单一职责原则

每个模块只做一件事 (类根绝业务切分可大可小,并不是说越细越好)

开闭原则

对扩展开放,对修改关闭。修改程序时,不需要修改类内部代码就可以扩展类的功能

里式替换原则

任何基类出现的地方,都可以用派生类替换

依赖倒置原则

针对接口(纯虚函数)编程,而非针对实现编程

接口分离原则

接口功能的粒度应该尽可能小

共同封装原则

一同变更的类应该合在一起

共同复用原则

不能一起被复用的类不能被分到一组

ubuntu下构建deb包

本文讲解如何构建一个deb包

dpgk

首先介绍下dpkg,dpkg是debian系统下软件包管理工具,用dpkg可以很方便的安装管理我们的deb包,为什么呢,因为deb包都是用dpkg构建的。类似于rethat系列的软件用rpm一样,rethat用rpm管理软件,用rpmbuild构建软件。

Ubuntu18.04安装搜狗输入法

虽然说大多数程序的安装,按找官方文档一步一步往下执行就好了,但是还是有一些软件官方文档支持的不好,比如搜狗Linux下的输入法,按官方文档安装完之后,输入法还是不能用。记录下ubuntu下搜狗输入法的安装步骤。