用Spring Boot编写RESTful API 学习笔记

RESTful API 介绍

• REST 是 Representational State Transfer 的缩写
• 所有的东西都是资源，所有操作都通过对资源的增删改查 (CRUD) 实现
• 对资源的增删改查对应对 URL 的操作 (POST, DELETE, PUT, GET)
• 无状态的

URL 中都应该是名词，不应该出现动词

关于 RESTful API 更详细可参考阮一峰老师的 RESTful API 最佳实践

RestController

源码：spring-boot-2-restful

《中国人应该这样用药》笔记 (四)

异常信息

io.netty.util.IllegalReferenceCountException: refCnt: 0, decrement: 1

原因

handler 继承了 SimpleChannelInboundHandler，SimpleChannelInboundHandler 中 channelRead 代码如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

public void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception {
    boolean release = true;

    try {
        if (this.acceptInboundMessage(msg)) {
            this.messageReceived(ctx, msg);
        } else {
            release = false;
            ctx.fireChannelRead(msg);
        }
    } finally {
        if (this.autoRelease && release) {
            ReferenceCountUtil.release(msg);
        }

    }

}

在 finally 代码块中释放了 msg

解决方案

handler 改继承 ChannelHandlerAdapter

参考：netty 中遇到的一个坑 SimpleInboundHandler，记录一下

《中国人应该这样用药》笔记 (三)

《中国人应该这样用药》笔记 (二)

《中国人应该这样用药》笔记 (一)

Linux软件安装管理 学习笔记

软件包简介

软件包分类：

• 源码包 ：脚本安装包
• 二进制包(RPM 包、系统默认包)

源码包的优点：

• 开源，如果有足够的能力，可以修改源代码
• 可以自由选择所需的功能
• 软件是编译安装，所以更适合自己的系统，更加稳定，也效率更高
• 卸载方便

源码包的缺点：

• 安装过程步骤较多，尤其安装较大的软件集合时(如 LAMP)，容易出现拼写错误
• 便宜过程时间较长，安装比二进制安装时间长
• 因为是编译安装，安装过程中一旦报错新手很难解决

二进制包的优点：

• 包管理系统简单，只通过几个命令就可以实现包的安装、升级、查询和卸载
• 安装速度比源码包安装快的多

二进制包的缺点：

• 经过编译，不再可以看到源代码
• 功能选择不如源代码灵活
• 依赖性

脚本安装包：把复杂的软件包安装过程写成了程序脚本，初学者可以执行程序脚本实现一键安装。但实际安装的还是源码包和二进制包。

• 优点：安装简单、快捷
• 缺点：完全丧失了自定义性

rpm 命令管理

rpm 包的来源 ：在系统光盘中(/mnt/cdrom/Packages)

rpm 包命名规则 ：httpd-2.2.15-15.el6.centos.1.i686.rpm

• httpd ：软件包名
• 2.2.15 ：软件版本
• 15 ：软件发布的次数
• el6.centos ：适合的 Linux 平台
• i686 ：适合的硬件平台
• rpm ：包扩展名

rpm 包依赖性：

• 树形依赖 ：a->b->c
• 环形依赖 ：a->b->c->a
• 模块依赖 ：模块依赖查询网站 www.rpmfind.net

包全名与包名：

• 包全名：操作的包是没有安装的软件包时，使用包全名。而且要注意路径
• 包名：操作已经安装的软件包时，使用包名，是搜索 /var/lib/rpm/ 中的数据库

安装

rpm -ivh 包全名

• -i(install)：安装
• -v(verbose)：显示详细信息
• -h(hash)：显示进度
• –nodeps：不检测依赖性

升级

rmp -Uvh 包全名

• -U(upgrade) ：升级

卸载

rmp -e 包名

• -e(erase) ：卸载
• –nodeps ：不检查依赖性

rpm 包查询

rpm -q 包名 ：查询包是否安装

• -q(query) ：查询

rpm -qa ：查询所有已经安装的 rpm 包

• -a(all) ：所有

rpm -qi 包名 ：查询软件包详细信息

• -i(information) ：查询软件信息
• -p(package) ：查询未安装包信息

rpm -ql 包名 ：查询软件包安装位置

• -l(list) ：列表
• -p(package) ：查询未安装包信息

rpm 包默认安装路径：

rpm -qf 系统文件名 ：查询系统文件属于哪个 rpm 包

• -f(file) ：查询系统文件属于哪个软件包

rpm -qR 包名 ：查询软件包的依赖性

• -R(requires) ：查询软件包的依赖性
• -p(package) ：查询未安装包信息

rpm 包校验

rpm -V 已安装的包名

• -V(verify) ：校验指定 rpm 包中的文件

验证内容的8个信息：

• S ：文件大小是否改变
• M ：文件的类型或文件的权限(rwx)是否被改变
• 5 ：文件 MD5 校验是否改变(可以看成文件内容是否改变)
• D ：设备的主从代码是否改变
• L ：文件路径是否改变
• U ：文件的属主(所有者)是否改变
• G ：文件的属组是否改变
• T ：文件的修改时间是否改变

文件类型：

• c ：配置文件(config file)
• d ：普通文档(documentation)
• g ：ghost file，很少见，就是该文件不应该被这个 rpm 包含
• L ：授权文件(license file)
• r ：描述文件(read me)

rpm2cpio 包全名 | cpio -idv .文件绝对路径 ：rpm 包中文件提取

• rpm2cpio ：将 rpm 包转换成 cpio 格式的命令
• cpio ：是一个标准工具，它用于创建软件档案文件和从档案文件中提取文件

cpio 选项 < [文件|设备]

• -i ：copy-in 模式，还原
• -d ：还原时自动新建目录
• -v ：显示还原过程

yum 在线安装

将所有软件包放到官方服务器上，当进行 yum 在线安装时，可以自动解决依赖性问题

redhat 的 yum 在线安装需要付费

yum 源文件

/etc/yum.repos.d/CentOS-Base.repo

• [base] ：容器名称，一定要放在[]中
• name ：容器说明，可以自己随便写
• mirrorlist ：镜像站点，这个可以注释掉
• baseurl ：yum 源服务器地址。默认是 CentOS 官方的 yum 源服务器，是可以使用的，如果觉得慢可以改成其他 yum 源地址
• enabled ：此容器是否生效，如果不写或写成 enabled = 1 都是生效，写成 enabled = 0 就是不生效
• gpgcheck ：如果 1 是指 RPM 的数字证书生效，如果是 0 则不生效
• gpgkey ：数字证书的公钥文件保存位置，不用修改

光盘搭建 yum 源

1. 挂载光盘
2. 使网络 yum 源失效
   • cd /etc/yum.repos.d/ #进入 yum源目录
   • mv CentOS-Base.repo CentOS-Base.repo.bak #修改 yum 源文件后缀名，使其失效
3. 使光盘 yum 源生效
   • baseurl= #地址为光盘挂载地址
   • enalbled=1

yum 命令

查询

yum list ：查询所有可用软件包列表

yum search 关键字 ：搜索服务器上所有和关键字相关的包

安装

yum -y install 包名

• -install ：安装
• -y ：自动回答 yes

升级

yum -y update 包名

• update ：升级
• -y ：自动回答 yes

卸载

yum -y remove 包名

• remove ：卸载
• -y ：自动回答 yes

服务器使用最小化安装，用什么软件安装什么，尽量不卸载

yum 软件组管理命令

yum grouplist ：列出所有可用的软件组列表

yum groupinstall 软件组名 ：安装指定软件组，组名可以由 grouplist 查询出来

yum groupmove 软件组名 ：卸载指定软件组

注：软件组名必须为英文

源码包管理

源码包和 rpm 包的区别：

• 安装之前的区别：概念上的区别
• 安装之后的区别：安装位置不同
  • rpm 包是安装在默认位置中
  • 源码包安装在指定位置当中，一般是 /usr/local/软件名/ (源码包没有卸载命令)

安装位置不同带来的影响：

• rpm 包安装的服务可以使用系统服务管理命令(service)来管理，例如 rpm 包安装的 apache 的启动方法是：
  • /ect/rc.d/init.d/httpd start
  • service httpd start
• 源码包安装的服务不能被服务管理命令管理，因为没有安装到默认路径中。所以只能使用绝对路径进行服务的管理，如：
  • /usr/local/apache2/bin/apachectl start

源码包安装

安装准备：安装 C 语言编译器

注：windows 向 Linux 上传文件使用 WinSCP

安装注意事项：

1. 源代码保存位置：/usr/local/src/
2. 软件安装位置：/usr/local/
3. 如何确定安装过程报错：
   • 安装过程停止
   • 并出现 error, warning 或 no 的提示

源码包安装过程：

1. 下载源码包
2. 解压缩下载的源码包
3. 进入解压缩目录
4. ./configure 软件配置与检查
   • 定义需要的功能选项
   • 检测系统环境是否符合安装要求
   • 把定义好的功能选项和检测系统环境的信息都写入 Makefile 文件，用于后续的编辑
5. make #编译(如果报错执行 make clean, 重新执行 make)
6. make install #编译安装

脚本安装包

lnmp.org

Linux网络管理 学习笔记

配置 IP 地址

ifconfig 命令临时配置 IP 地址

ifconfig eth0 192.168.0.200 netmask 255.255.255.0 #临时设置 eth0 网卡的 IP 地址与子网掩码

setup 工具永久配置 IP 地址

修改网络配置文件

1. 网卡信息文件：/etc/sysconfig/network-scripts/ifcfg-eth0

DEVICE=eth0 #网卡设备名

BOOTPROTO=none #是否自动获取 IP(none, static, dhcp)

HWADDR=00:0c:29:17:c4:09 #MAC 地址

NM_CONTROLLED=yes #是否可以由 Network Manager 图形管理工具托管

ONBOOT=yes #是否随网络服务启动，eth0 生效

TYPE=Ethernet #类型为以太网

UUID=”…” #唯一识别码

IPADDR=192.168.0.252 # IP 地址

NETMASK=255.255.255.0 #子网掩码

GATEWAY=192.168.0.1 #网管

DNS1=202.106.0.20 #DNS

IPV5INT=no #IPv6 没有启用

USERCTL=no #不允许非 root 用户控制此网卡

2. 主机名文件：/etc/sysconfig/network

NETWORKING=yes

HOSTNAME=localhost.localdomain

hostname [主机名] ：查看与临时设置主机名

3. DNS 配置文件：/etc/resolv.conf

nameserver 202.106.0.20

search localhost

图形界面配置 IP 地址

虚拟机网络配置

1. 配置 IP 地址
2. 启动网卡
   1. ONBOOT=yes
   2. 重启网络服务：service network restat
3. 修改 UUID
   1. /etc/sysconfig/network-scripts/ifcfg-eth0 #删除 MAC 地址行
   2. rm -rf /etc/udev/rules.d/70-persistent-net.rules #删除网卡和 MAC 地址绑定文件
   3. 重启系统
4. 设置虚拟机网络连接方式
   1. 桥接
   2. NAT
   3. Host-only
5. 修改桥接网卡

Linux网络管理 学习笔记

ISO/OSI 七层模型

ISO ：国际标准化组织

OSI ：开放系统互联模型

应用层、表示层、会话层服务于用户

传输层、网络层、数据链路层、物理层服务于实际数据传输

帧包含计算机的 MAC 地址，报文包含计算机的 IP 地址。MAC 地址负责局域网通信，IP 地址负责外网通信。

• TPDU：传输协议数据单元
• SPDU：会话协议数据单元
• PPDU：表示层协议数据单元
• APDU：应用协议数据单元

TCP/IP 四层模型

TCP/IP 模型与 OSI 模型的比较：

• 共同点：
  1. 都采用了层次结构的概念
  2. 都能够提供面向连接和无连接两种通信服务机制
• 不同点：
  1. 前者是七层模型，后者是四层结构
  2. 对可靠性要求不同(后者更高)
  3. OSI 模型是在协议开发前设计的，具有通用性；TCP/IP 是先有协议集然后建立模型，不适合用于非 TCP/IP 网络
  4. 实际市场应用不同(OSI 模型只是理论上的模型，并没有成熟的产品，而 TCP/IP 已经成为“实际上的国际标准”)

IP 地址

IP 地址分类：

A 类第一位数代表网段，B 类前两位数代表网段，C 类前三位数代表网段

子网掩码

IP 和子网掩码不能单独使用，必须同时使用

• | - | - | - | - | - | -
  —|—|—|—|—|—|—
  A 类: | | | B 类 | | C 类
  IP 地址 | 10. | 1.1.200 | 172.16. | 1.200 | 192.168.1. | 200
  子网掩码 | 255. | 0.0.0 | 255.255. | 0.0 | 255.255.255. | 0
  网络地址 | 10. | 0.0.0 | 172.16. | 0.0 | 192.168.1. | 0

子网掩码用来确定 IP 地址当中哪一位数字代表同一网段，哪一位数代表同一网段中的不同主机

端口

常见端口号：

• FTP(文件传输协议)：20、21
• SSH(安全shell协议)：22
• telnet(远程登陆协议)：23
• DNS(域名系统)：53
• http(超文本传输协议)：80
• SMTP(简单邮件传输协议)：25
• POP3(邮局协议3代)：110

netstat -an ：查看本机启用的端口

• -a ：查看所有连接和监听端口
• -n ：显示 IP 地址和端口号，而不是显示域名和服务名

DNS

hosts 是做静态 IP 和域名对应，hosts 文件的优先级高于 DNS 解析

• 早期 Hosts 文件解析域名：
  • 名称解析效能下降
  • 主机维护困难
• DNS 服务
  • 层次性
  • 分布式

DNS 查询类型：

• 从查询方式上分：

  • 递归查询：要么做出查询成功响应，要么做出查询失败的响应。一般客户机和服务器之间属递归查询，即当客户机向 DNS 服务器发出请求后，若 DNS 服务器本身不能解析，则会向另外的 DNS 服务器发出查询请求，得到结果后转交给客户机
  • 迭代查询：服务器收到一次迭代查询回复一次结果，这个结果不一定是目标 IP 与域名的映射关系，也可以是其他 DNS 服务器的地址

• 从查询内容上分：

  • 正向查询：由域名查找 IP 地址
  • 反向查询：由 IP 地址查找域名

网关

1. 网关(Gateway)又称网间连接器、协议转换器
2. 网关在网络层以上实现网络互联，是最复杂的网络互联设备，仅用于两个高层协议不同的网络互联
3. 网关既可以用于广域网互联，也可以用于局域网互联
4. 网关是一种充当转换重任的服务器或路由器

Linux达人养成计划 I 学习笔记

Shell 是什么：

• Shell 是一个命令解释器
• Shell 还是一个功能相当强大的编程语言，易编写，易调试，灵活性较强

Shell 的分类：

• Bourne Shell：主要包括 sh, ksh, Bash(Linux 标准 Shell，与 sh 兼容), psh, zsh
• C Shell：主要包括 csh, tcsh

注：系统支持的Shell类型可以在 /etc/shells 文件查询

脚本执行方式

echo [选项] [输出内容]

• -e：支持反斜线控制的字符转换

echo -e “\e[1;颜色代号 输出内容 \e[0m”

• 30m 黑色
• 31m 红色
• 32m 绿色
• 33m 黄色
• 34m 蓝色
• 35m 洋红
• 36m 青色
• 37m 白色

脚本

• #!/bin/bash ：脚本第一句，不能省略

脚本执行：

• 赋予执行权限，直接运行
  • chmod 755 hello.sh
  • ./hello.sh
• 通过 Bash 调用执行脚本
  • bash hello.sh

Bash 的基本功能

命令的别名与快捷键

alias ：查看系统中所有的命令别名

alias 别名= ‘原命令’ ：设定命令别名(临时生效)

vi ~/.bashrc ：写入变量配置文件(永久生效，需重新登陆或者执行 source ~/.bashrc 命令)

unalias ：删除别名(临时生效)

命令生效顺序：

• 第一顺位执行用绝对路径或者相对路径执行的命令
• 第二顺位执行别名
• 第三顺位执行 Bash 的内部命令
• 第四顺位执行按照 $PATH 环境变量定义的目录查找顺序找到的第一个命令

常用快捷键：

• ctrl+c ：强制终止当前命令
• ctrl+l ：清屏，等于 clear 命令
• ctrl+a ：光标移动到命令行首
• ctrl+e ：光标移动到命令行尾
• ctrl+u ：从光标所在位置删除到行首
• ctrl+z ：把命令放入后台
• ctrl+r ：在历史命令中搜索

历史命令

history [选项] [历史命令保存文件]

• -c：清空历史命令
• -w：把缓存中的历史命令写入历史命令保存文件 ~/.bash_history

历史命令默认会保存1000条，可以在环境变量配置文件 /etc/profile 中进行修改

历史命令的调用：

• 使用上、下箭头调用以前的历史命令
• 使用 “!n” 重复执行第 n 条历史命令
• 使用 “!!”” 重复执行上一条命令
• 使用 “!字符串” 重复执行最后一条以该字符串开通的命令

在 Bash 中，按 “Tab” 键就会自动进行补全

输出重定向

标准输入输出：

输出重定向：

• | 命令 >> 文件 | 以追加的方式，把命令的正确输出输出到指定的文件或设备当中
  标准错误输出重定向 | 错误命令 2> 文件 | 以覆盖的方式，把命令的错误输出输出到指定的文件或设备当中
• | 错误命令 2>> 文件 | 以追加的方式，把命令的错误输出输出到指定的文件或设备当中
  正确输出和错误输出同时保存 | 命令 > 文件 2>&1 | 以覆盖的方式，把正确输出和错误的输出都保存到同一个文件中
• | 命令 >> 文件 2>&1 | 以追加的方式，把正确输出和错误的输出都保存到同一个文件中
• | 命令 &> 文件 | 以覆盖的方式，把正确输出和错误的输出都保存到同一个文件中
• | 命令 &>> 文件 | 以追加的方式，把正确输出和错误的输出都保存到同一个文件中
• | 命令 >> 文件1 2>> 文件2 | 把正确的输出追加到文件1中，把错误的输出追加到文件2中

注：把命令结果输出到 /dev/null 相当于丢弃输出结果

输入重定向

wc [选项] [文件名]

• -c ：统计字节数
• -w ：统计单词数
• -l ：统计行数
• ctrl + d ：得到统计结果

管道符

多命令顺序执行：

命令1 | 命令2 ：命令1的正确输出作为命令2的操作对象

通配符

• | 匹配0个或任意多个任意字符，也就是可以匹配任何容
  [] | 匹配中括号中任意一个字符
  [-] | 匹配中括号中任意一个字符，-代表一个范围
  [^] | 匹配不是中括号内的一个字符

其他特殊符号：

| #开头的行代表注释

$ | 用来调用变量的值
\ | 转义符，跟在\之后的特殊符号将失去特殊含义，变为普通字符