升级 Spring MVC 3.2.x 到 4.x 注意事项
把 Spring 版本从 3.2.x 升级到了4.x ，这里记录一下。
新特性
Java 8 Support， 从 4.0 开始支持 Java 8，可以使用 lambda 表达式，等等 Java 8 的特性
Groovy DSL
新增 @RestController 注解，这样就不需要每个方法都使用 @ResponseBody 了。
更多内容可以查看: https://docs.spring.io/spring/docs/4.3.x/spring-framework-reference/htmlsingle/#spring-whats-new
注意事项
添加依赖
加入spring-context-support，以前3的版本不用加，但是4要加上，否则就会报ClassNotFoundException,
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context-support</artifactId>
<version>4.3.12.RELEASE</version>
</dependency>
替换 Spring MVC jackson 依赖
更换Spring jackson依赖，Spring MVC返回 json 的时候需要依赖jackson的jar包，以前是codehaus.jackson，现在换成了fasterxml.jackson 同时修改配置文件
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-core</artifactId>
<version>2.7.0</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.7.0</version>
</dependency>
同时还要修改Spring的配置文件
<bean
class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter">
<property name="messageConverters">
<list>
<ref bean="stringHttpMessageConverter" />
<bean
class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
</bean>
</list>
</property>
</bean>
<bean id="stringHttpMessageConverter"
class="org.springframework.http.converter.StringHttpMessageConverter">
<property name="supportedMediaTypes">
<list>
<value>text/plain;charset=UTF-8</value>
</list>
</property>
</bean>
xsd 文件版本
更换springxsd文件的版本，直接从 3.0 升级到 4.0 即可
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc" xmlns:aop="http://www.springframework.org/schema/aop"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.0.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop.xsd">
修改 quarz 版本
修改quarz版本，用2以上的版本，maven依赖如下
<dependency>
<groupId>org.quartz-scheduler</groupId>
<artifactId>quartz</artifactId>
<version>2.2.2</version>
</dependency>
Linux 安装 nodejs
nodejs 安装其实非常简单，大部分情况下 Debian/Ubuntu 下只要使用包管理直接安装
sudo apt-get install nodejs
sudo apt-get install npm
即可。
脚本安装
可是今天网络环境太差，不是 npm package not found 就是 update 半天不动。
官网 提供的安装方式
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt-get install -y nodejs
也是网络环境无法安装
二进制安装
所以使用 二进制 安装
在官网 https://nodejs.org/en/download/ 找到编译好的二进制文件
然后解压到 /usr/local 目录下
然后配置 vim ~/.zshrc
export NODE_HOME=/usr/local/node-v6.11.4-linux-x64/
export PATH=$NODE_HOME/bin:$PATH
使用命令检查
node -v
npm -v
输出即可。
使用mutt在Bash中发送邮件及附件
在编写定时备份脚本时遇到一个需求，就是在 Bash 脚本中发送带附件的邮件。于是找到了 mutt。
Mutt 是一个命令行的邮件客户端，Mutt 能够轻松地在命令行发送和读取邮件。 Mutt 支持 POP 和 IMAP 协议。 尽管 Mutt 是基于命令的，但也同样有一个友好的界面。
如果不使用界面，使用 Mutt 命令发邮件也非常方便，只需要一条命令即可发送或者批量发送邮件。
功能说明
E-mail管理程序。
语法
mutt [-hnpRvxz][-a<文件>][-b<地址>][-c<地址>][-f<邮件文件>][-F<配置文件>][-H<邮件草稿>][-i<文件>][-m<类型>][-s<主题>][邮件地址]
补充说明：mutt 是一个文字模式的邮件管理程序，提供了全屏幕的操作界面。
参数：
-a<文件> 在邮件中加上附加文件。-b<地址> 指定密件副本的收信人地址。-c<地址> 指定副本的收信人地址。-f<邮件文件> 指定要载入的邮件文件。-F<配置文件> 指定mutt程序的设置文件，而不读取预设的.muttrc文件。-h显示帮助。-H<邮件草稿> 将指定的邮件草稿送出。-i<文件> 将指定文件插入邮件内文中。-m<类型> 指定预设的邮件信箱类型。-n不要去读取程序培植文件(/etc/Muttrc)。-p在mutt中编辑完邮件后，而不想将邮件立即送出，可将该邮件暂缓寄出。-R以只读的方式开启邮件文件。-s<主题> 指定邮件的主题。-v显示mutt的版本信息以及当初编译此文件时所给予的参数。-x模拟mailx的编辑方式。-z与-f参数一并使用时，若邮件文件中没有邮件即不启动mutt。
安装方法
Debian/Ubuntu/Linux Mint 安装
sudo apt-get install -y mutt
使用方法
发送一封简单的邮件(可能会被主流邮箱认为垃圾邮件，垃圾箱查看一下)
echo "Email body" | mutt -s "Email Title" root@einverne.info
进入命令行交互界面之后使用如下快捷键操作
- 使用
t改变接受者邮件地址 - 使用
c改变 Cc 地址 - 使用
a来增加附件 - 使用
q退出 - 使用
y来发送邮件
发送带附件的邮件
echo "body" | mutt -s "mysql backup" root@einverne.info -a /mysql.tar.gz
读取文本中的信息作为内容
mutt -s "Test" xxxx@qq.com
添加多个附件
echo "body" | mutt -s "web backup" root@einverne.info -a /mysql.tar.gz -a /web.tar.gz
抄送和密送
echo "body" | mutt -s "title" -c cc@gmail.com -b bcc@gmail.com root@einverne.info
- 使用
-c来抄送 - 使用
-b来添加密送 - 使用
-s来添加标题 - 使用
-a来添加附件
设置发件人
编辑配置文件
vi /etc/Muttrc
添加如下内容,防止被作为垃圾邮件
set from="mutt@einverne.info"
set use_from=yes
set envelope_from="yes"
set realname="Ein Verne"
mutt@einverne.info 为发信地址
mutt 发送邮件略慢，需要等待一分钟或者更长才能发送成功，作为备份工具好好利用。
reference
在 Spring Boot 中使用 Swagger
在使用 Spring Boot 构建一套 RESTful 接口的时候经常需要手工维护一份接口文档以提供给不同的客户端使用，有的时候手工维护成本太高，今天发现了一套自动化生成 RESTful 接口文档的工具 Swagger 。
Swagger 能根据 Spring Controller 接口自动生成一个文档页面，在代码中使用注解将接口文档注释，非常方便。 Swagger 整合到 Spring boot 项目中也非常方便。
添加依赖
在 pom.xml 中添加
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.7.0</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.7.0</version>
</dependency>
最新的版本可以在 mvnrepository 上查到，或者上官网或者 github。
添加配置类
@Configuration
@EnableSwagger2
public class SwaggerConfig {
@Bean
public Docket helloApi() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.select()
.apis(RequestHandlerSelectors.basePackage("info.einverne.springboot.demo"))
.paths(PathSelectors.any())
.build();
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
// 文档标题
.title("API 文档")
// 文档描述
.description("https://github.com/einverne/thrift-swift-demo/tree/master/spring-boot-demo")
.termsOfServiceUrl("https://github.com/einverne/thrift-swift-demo/tree/master/spring-boot-demo")
.version("v1")
.build();
}
}
通过@Configuration注解，让Spring来加载该类配置。再通过@EnableSwagger2注解来启用Swagger2。
apiInfo()用来创建 API 的基本信息，展现在文档页面中。select()函数返回一个ApiSelectorBuilder实例用来控制哪些接口暴露给 Swagger ，这里使用定义扫描包路径来定义， Swagger 会扫描包下所有 Controller 的定义并产生文档内容，除了被@ApiIgnore注解的接口。
添加接口注释
@ApiOperation注解来给API增加说明、通过@ApiImplicitParams、@ApiImplicitParam注解来给参数增加说明。
一个简单的注释
@ApiOperation(value = "创建用户", notes = "根据User对象创建用户")
@ApiImplicitParam(name = "user", value = "用户详细实体user", required = true, dataType = "User")
@RequestMapping(value = "", method = RequestMethod.POST)
public String postUser(@RequestBody User user) {
users.put(user.getId(), user);
return "success";
}
详细的例子可以参考源代码 https://github.com/einverne/thrift-swift-demo
再添加注释后启动 Spring boot, 访问 http://localhost:8080/swagger-ui.html 即可看到API文档
Api 注解
@Api 注解用于类上，说明类作用
- value url
- description
- tags 设置该值，value 会被覆盖
- basePath 基本路劲不可配置
- position
- produces “application/json”
- consumes “application/json”
- protocols http, https, wss
- authorizations 认证
- hidden 是否在文档隐藏
ApiOperation 注解
标记在方法上，对一个操作或HTTP方法进行描述。具有相同路径的不同操作会被归组为同一个操作对象。不同的HTTP请求方法及路径组合构成一个唯一操作。此注解的属性有：
- value 对操作的简单说明，长度为120个字母，60个汉字。
- notes 对操作的详细说明。
- httpMethod HTTP请求的动作名，可选值有：”GET”, “HEAD”, “POST”, “PUT”, “DELETE”, “OPTIONS” and “PATCH”。
- code 默认为200，有效值必须符合标准的 HTTP Status Code Definitions
ApiImplicitParams
注解ApiImplicitParam的容器类，以数组方式存储。
ApiImplicitParam
对API的单一参数进行注解。虽然注解@ApiParam同JAX-RS参数相绑定，但这个@ApiImplicitParam注解可以以统一的方式定义参数列表，也是在Servelet及非JAX-RS环境下，唯一的方式参数定义方式。注意这个注解@ApiImplicitParam必须被包含在注解@ApiImplicitParams之内。可以设置以下重要参数属性：
- name 参数名称
- value 参数的简短描述
- required 是否为必传参数
- dataType 参数类型，可以为类名，也可以为基本类型（String，int、boolean等）
- paramType 参数的传入（请求）类型，可选的值有path, query, body, header or form。
@RequestBody这样的场景请求参数无法使用@ApiImplicitParam注解进行描述
ApiParam
增加对参数的元信息说明。这个注解只能被使用在JAX-RS 1.x/2.x的综合环境下。其主要的属性有：
- required 是否为必传参数
- value 参数简短说明
ApiModel
提供对Swagger model额外信息的描述。在标注@ApiOperation注解的操作内，所有的类将自动被内省（introspected），但利用这个注解可以做一些更加详细的model结构说明。主要属性有：
- value model的别名，默认为类名
- description model的详细描述
ApiModelProperty
对model属性的注解，主要的属性值有：
- value 属性简短描述
- example 属性的示例值
- required 是否为必须值
- hidden 隐藏该属性
ApiResponse
响应配置
- code http状态码
- message 描述
ApiResponses
多个 Response
验证机制
考虑到安全的问题，每次请求API需要对用户进行验证与授权。目前主流的验证方式采用请求头部（request header）传递token，即用户登录之后获取一个token，然后每次都使用这个token去请求API。如果想利用 swagger-UI 进行API测试，必须显式为每个需要验证的API指定token参数。这时可以为每个操作添加一个注解 @ApiImplicitParams，具体代码如下：
@ApiImplicitParams({@ApiImplicitParam(name = "TOKEN", value = "Authorization token", required = true, dataType = "string", paramType = "header")})
根据环境选择开启 Swagger
Swagger 提供了 enable 方法，可以通过设置该方法来选择开启 Swagger 来在线上环境禁用 Swagger。
@Bean
public Docket customImplementation(){
return new Docket(SWAGGER_2)
.apiInfo(apiInfo())
.enable(environmentSpeficicBooleanFlag) //<--- Flag to enable or disable possibly loaded using a property file
.includePatterns(".*pet.*");
}
如果使用 Spring @Profile 也可以
@Bean
@Profile("production")
public Docket customImplementation(){
return new Docket(SWAGGER_2)
.apiInfo(apiInfo())
.enable(false) //<--- Flag set to false in the production profile
.includePatterns(".*pet.*");
}
From: https://stackoverflow.com/a/27976261/1820217
reference
每天学习一个命令： Linux 查看磁盘信息命令 di
平时在 Linux 上查看磁盘信息都使用 df -lh , -l 显示本地文件系统， -h 来表示 human readable 。虽然 df 在一定程度上能够满足查询磁盘剩余空间的需求，但是这里要介绍一款强大于 df 的命令 —- di 。
使用如下命令安装
sudo apt install di
di 命令是 disk information 的缩写，直接运行 di 会有如下结果
di
Filesystem Mount Size Used Avail %Used fs Type
/dev/sda1 / 901.2G 188.3G 667.1G 26% ext4
tmpfs /dev/shm 7.8G 0.1G 7.6G 2% tmpfs
tmpfs /run 1.6G 0.1G 1.5G 4% tmpfs
cgmfs /run/cgmanager/ 0.1M 0.0M 0.1M 0% tmpfs
tmpfs /run/lock 5.0M 0.0M 5.0M 0% tmpfs
tmpfs /run/user/0 1.6G 0.0G 1.6G 0% tmpfs
tmpfs /run/user/1000 1.6G 0.0G 1.6G 0% tmpfs
tmpfs /sys/fs/cgroup 7.8G 0.0G 7.8G 0% tmpfs
/dev/sda1 /var/lib/docker 901.2G 188.3G 667.1G 26% ext4
di 默认的输出就是比较人性化的了。
看 di 的使用介绍 man di 就会发现 di 是这么介绍自己的
> di Displays usage information on mounted filesystems. Block values are reported in a human readable format. If the user or group has a disk quota, the values reported are adjusted according the quotas that apply to the user.
一些简单的使用
A 选项打印所有挂载设备
di -A
Mount fs Type Filesystem
Options
Size Used Free %Used %Free
Size Used Avail %Used %Free
Size Used Avail %Used
Inodes IUsed IFree %IUsed
/ ext4 /dev/sda1
rw,relatime,errors=remount-ro,data=ordered
901.2G 188.3G 712.9G 21% 79%
901.2G 234.1G 667.1G 26% 74%
855.4G 188.3G 667.1G 22%
60014592 1372538 58642054 2%
/dev/shm tmpfs tmpfs
rw,nosuid,nodev
7.8G 0.1G 7.6G 2% 98%
7.8G 0.1G 7.6G 2% 98%
7.8G 0.1G 7.6G 2%
2036725 741 2035984 0%
/run tmpfs tmpfs
rw,nosuid,noexec,relatime,size=1629380k,mode=755
1.6G 0.1G 1.5G 4% 96%
1.6G 0.1G 1.5G 4% 96%
1.6G 0.1G 1.5G 4%
2036725 777 2035948 0%
/run/cgmanager/fs tmpfs cgmfs
rw,relatime,size=100k,mode=755
0.1M 0.0M 0.1M 0% 100%
0.1M 0.0M 0.1M 0% 100%
0.1M 0.0M 0.1M 0%
2036725 14 2036711 0%
/run/lock tmpfs tmpfs
rw,nosuid,nodev,noexec,relatime,size=5120k
5.0M 0.0M 5.0M 0% 100%
5.0M 0.0M 5.0M 0% 100%
5.0M 0.0M 5.0M 0%
2036725 4 2036721 0%
/run/user/0 tmpfs tmpfs
rw,nosuid,nodev,relatime,size=1629380k,mode=700
1.6G 0.0G 1.6G 0% 100%
1.6G 0.0G 1.6G 0% 100%
1.6G 0.0G 1.6G 0%
2036725 4 2036721 0%
/run/user/1000 tmpfs tmpfs
rw,nosuid,nodev,relatime,size=1629380k,mode=700,uid=1000,gid=1000
1.6G 0.0G 1.6G 0% 100%
1.6G 0.0G 1.6G 0% 100%
1.6G 0.0G 1.6G 0%
2036725 36 2036689 0%
/sys/fs/cgroup tmpfs tmpfs
rw,mode=755
7.8G 0.0G 7.8G 0% 100%
7.8G 0.0G 7.8G 0% 100%
7.8G 0.0G 7.8G 0%
2036725 18 2036707 0%
/var/lib/docker/aufs ext4 /dev/sda1
rw,relatime,errors=remount-ro,data=ordered
901.2G 188.3G 712.9G 21% 79%
901.2G 234.1G 667.1G 26% 74%
855.4G 188.3G 667.1G 22%
60014592 1372538 58642054 2%
c 选项逗号分割
使用 -c 选项分割输出
di -c
s,m,b,u,v,p,T
"/dev/sda1","/","901.2G","188.3G","667.1G",26%,"ext4"
"tmpfs","/dev/shm","7.8G","0.1G","7.6G",2%,"tmpfs"
"tmpfs","/run","1.6G","0.1G","1.5G",4%,"tmpfs"
"cgmfs","/run/cgmanager/fs","0.1M","0.0M","0.1M",0%,"tmpfs"
"tmpfs","/run/lock","5.0M","0.0M","5.0M",0%,"tmpfs"
"tmpfs","/run/user/0","1.6G","0.0G","1.6G",0%,"tmpfs"
"tmpfs","/run/user/1000","1.6G","0.0G","1.6G",0%,"tmpfs"
"tmpfs","/sys/fs/cgroup","7.8G","0.0G","7.8G",0%,"tmpfs"
"/dev/sda1","/var/lib/docker/aufs","901.2G","188.3G","667.1G",26%,"ext4"
c 是 --csv-output 的缩写，为了便于程序解析
t 参数增加统计行
-t 参数在最后增加统计行
di -t
Filesystem Mount Size Used Avail %Used fs Type
/dev/sda1 / 901.2G 188.4G 667.0G 26% ext4
tmpfs /dev/shm 7.8G 0.1G 7.6G 2% tmpfs
tmpfs /run 1.6G 0.1G 1.5G 4% tmpfs
cgmfs /run/cgmanager/ 0.1M 0.0M 0.1M 0% tmpfs
tmpfs /run/lock 5.0M 0.0M 5.0M 0% tmpfs
tmpfs /run/user/0 1.6G 0.0G 1.6G 0% tmpfs
tmpfs /run/user/1000 1.6G 0.0G 1.6G 0% tmpfs
tmpfs /sys/fs/cgroup 7.8G 0.0G 7.8G 0% tmpfs
/dev/sda1 /var/lib/docker 901.2G 188.4G 667.0G 26% ext4
Total 1.8T 0.4T 1.3T 26%
s 参数对结果排序
di -s 默认更具 mount point 输出
di -sm默认 mount pontdi -sn不排序，按照挂载表 /etc/fstab 中顺序di -ss按照特殊设备di -st根据 filesystem typedi -sr逆序输出
排序方式可以组合使用，如：di –stsrm ：按照类型、设备、挂载点逆序排序。
di –strsrm ：按照类型、设备逆序、挂载点逆序排序。
f 选项自定义格式
di -fM
Mount
/
/dev/shm
/run
/run/cgmanager/fs
/run/lock
/run/user/0
/run/user/1000
/sys/fs/cgroup
/var/lib/docker/aufs
只打印 mount point
更多的 f 的选项可以直接参看 man di
总结
虽然 di 提供了比 df 更多更强大的功能，但是也有其缺点，大部分的 Linux 发行版默认是没有预装的。
Maven 介绍
Maven 是一个项目管理工具，主要用于项目构建，依赖管理，项目信息管理。自动化构建过程，从清理、编译、测试和生成报告、再到打包和部署。Maven 通过一小段描述信息来管理项目。
Maven 安装
安装之前先把 JDK 环境配置好。
Debian/Ubuntu/Linux Mint 下
sudo apt install maven
如果要手动安装则按照下面步骤
- 下载Maven最新安装包，地址 http://Maven.apache.org/download.cgi 比如 apache-Maven-3.3.9-bin.tar.gz
tar -zxvf apache-Maven-3.3.9-bin.tar.gz- 将 apache-Maven-3.3.9 目录移动到 /usr/local 目录 命令：
sudo mv apache-maven-3.3.9/ /usr/local/ -
root身份修改配置命令
sudo vi ~/.bashrc在文件最后添加：#set Maven environment M2_HOME=/usr/local/apache-maven-3.3.9 export Maven_OPTS="-Xms256m -Xmx512m" export PATH=$M2_HOME/bin:$PATH保存并关闭。
- 使配置生效必须重启机器或者在命令行输入： source ~/.bashrc
- 查看Maven是否安装成功：
mvn -version
如果进行了上面步骤在任意目录中mvn命令不能使用，可以在 /etc/profile 文件后面加入下面三行 sudo vim ~/.bashrc
然后输入以下内容
Maven_HOME=/usr/local/apache-maven-3.3.9
export Maven_HOME
export PATH=${PATH}:${Maven_HOME}/bin
设置好Maven的路径之后，需要运行下面的命令 source ~/.bashrc 使刚刚的配置生效
Maven 作用
Maven 最熟悉的一个概念就是 POM，Maven 项目会有一个 pom.xml 文件， 在这个文件里面添加相应配置，Maven 就会自动帮你下载相应 jar 包
<dependency>
<groupId>com.google.firebase</groupId> 项目名
<artifactId>firebase-admin</artifactId> 项目模块
<version>5.3.1</version> 项目版本
</dependency>
项目名-项目模块-项目版本 三个坐标定义了项目在 Maven 世界中的基本坐标，任何 jar，pom， war 都是基于这些坐标进行区分的。
-
groupId定义了项目组，组和项目所在组织或公司，或者开源项目名称，一般为公司域名反写，比如 com.google.firebase 等等 -
artifactId定义了 Maven 项目的名称，在组中的唯一 ID，在同一个项目中可能有不同的子项目，可以定义不同的 artifactId。 artifactId 也是构建完成项目后生成的 jar 包或者 war 包的文件名的一部分。 -
version顾名思义，就是项目的版本号，如果项目维发布，一般在开发中的版本号习惯性加上SNAPSHOT， 比如 1.0-SNAPSHOT
根据上面的例子，比如上面定义的Maven坐标，可以在对应的中央仓库中 https://repo1.maven.org/maven2/com/google/firebase/firebase-admin/5.3.1/ 目录下找到对应的文件。
scope定义了依赖范围，如果依赖范围为 test ，那么该依赖只对测试有效，也就是说在测试代码中引入 junit 有效，在主代码中用 junit 会造成编译错误。如果不声明依赖范围则默认为 compile ，表示该依赖对主代码和测试代码都有效。
Maven 有以下几种依赖范围：
- compile 编译依赖，在编译、测试、运行时都有效
- test 测试依赖，只对于测试 classpath 有效， JUnit 典型
- provided 已提供依赖，只在编译和测试有效，运行时无效， servlet-api 编译和测试项目时需要该依赖，但是在运行项目时，由于容器已经提供，不需要 Maven 重复引入
- runtime 运行时依赖，对于测试和运行有效，编译主代码无效， JDBC驱动实现，项目主代码编译只需要JDK提供的JDBC接口，只有执行测试或者运行项目才需要实现上述接口的具体JDBC驱动
- system 系统依赖范围，和 provided 范围依赖一致，但是使用 system 范围的依赖时必须通过 systemPath 元素显示地指定依赖文件的路径。
- import 导入依赖，一般不用
依赖范围和classpath 的关系
| 依赖范围 Scope | 编译classpath有效 | 测试classpath有效 | 运行classpath有效 | 例子 |
|---|---|---|---|---|
| compile | Y | Y | Y | spring-core |
| test | - | Y | - | junit |
| provided | Y | Y | - | servlet-api |
| runtime | - | - | Y | JDBC 驱动 |
| system | Y | Y | - | 本地的， Maven 仓库之外的类库 |
Maven 依赖调解 Dependency Mediation ，第一原则：路径最近者优先；第二原则：第一声明者优先。
SNAPSHOT 快照版本只应该在组织内部的项目或者模块之间的依赖使用，组织对于这些快照版本的依赖具有完全的理解和控制权。项目不应该依赖于任何组织外部的快照版本，由于快照的不稳定性，依赖会产生潜在的危险，即使项目构建今天是成功的，由于外部快照版本可能变化，而导致未来构建失败。
Maven 核心概念 仓库
在上面介绍 Maven 的作用的时候提到了Maven 的两个核心概念：坐标和依赖，这也是 Maven 首要解决的问题。这里要引入 Maven 另外一个核心概念：仓库。 Maven 时间中通过坐标来定位依赖，Maven 通过仓库来统一管理这些依赖。
Maven 项目的每一个构件对应着仓库的路径为： groupId/artifactId/version/artifactId-version.packageing
Maven 的仓库分为远程仓库和本地仓库，当第一次运行 Maven 命令时，需要网络连接，从远程仓库下载可用的依赖和插件。而当以后在运行 Maven 命令的时候，Maven 会自动先检查本地 ~/.m2/repository 目录下的依赖，如果本地有缓存优先从本地获取，在找不到的情况下去远程仓库寻找。
常用的在线依赖查看网站
- https://mvnrepository.com/
- http://repository.sonatype.org
- http://www.jarvana.com/jarvana
- http://www.mvnbrowser.com
Maven 核心概念 生命周期和插件
Maven 的生命周期是抽象的，实际行为都有插件完成。
clean 生命周期
清理项目，包含三个阶段
pre-clean执行清理前需要完成的工作- clean 清理上一次构建生成的文件
- post-clean 执行一次清理后需要完成的工作
default 生命周期
定义了真正构建时所需要执行的步骤
- validate 验证工程是否正确，所有需要的资源是否可用。
- initialize
- generate-sources
- process-sources 主要资源文件
- generate-resources
- process-resources
- compile 编译主源码
- process-classed
- generate-test-sources
- process-test-sources 测试资源
- generate-test-resources
- process-test-resources
- test-compile 编译项目测试代码
- process-test-classes 已发布的格式，如jar，将已编译的源代码打包
- prepare-package
- pre-integration-test 在集成测试可以运行的环境中处理和发布包
- post-integration-test
- verify 运行任何检查，验证包是否有效且达到质量标准。
- install 将包安装到 Maven 本地仓库，供本地 Maven 项目使用
- deploy 复制到远程仓库，供其他人使用
site 生命周期
建立和发布项目站点
- pre-site 生成项目站点之前需要完成的工作
- site 生成站点文档
- post-site 生成之后
- site-deploy 生成的站点发布到服务器上
具体的流程可以参考下图
Maven 项目文件结构
下面是一个标准的 Maven 工程
src/main/java - 存放项目.java文件；
src/main/resources - 存放项目资源文件；
src/test/java - 存放测试类.java文件；
src/test/resources - 存放测试资源文件；
target - 项目输出目录；
pom.xml - Maven核心文件（Project Object Model）；
Maven 常用命令
mvn archetype：create 创建Maven项目
mvn compile 编译源代码
mvn deploy 发布项目
mvn test-compile 编译测试源代码
mvn test 运行应用程序中的单元测试
mvn site 生成项目相关信息的网站
mvn clean 清除项目目录中的生成结果
mvn package 根据项目生成的jar
mvn install 在本地Repository中安装jar
mvn eclipse:eclipse 生成eclipse项目文件
mvn jetty:run 启动jetty服务
mvn tomcat:run 启动tomcat服务
mvn clean package -DMaven.test.skip=true 清除以前的包后重新打包，跳过测试类
mvn clean package 清除以前的包后重新打包
reference
IntelliJ IDEA 中使用 Resin 调试
平时开发环境使用的是 jetty，而 Java Web 有一个更好更快的服务器 Resin，这篇文章就来说一下什么是 Resin，以及在 Debug 中如何使用。
什么是 Resin
Resin是一个提供高性能的，支持 Java/PHP 的应用服务器。目前有两个版本：一个是GPL下的开源版本，提供给一些爱好者、开发人员和低流量网站使用；一种是收费的专业版本，增加了一些更加适用于生产环境的特性。
Resin也可以和许多其他的web服务器一起工作，比如Apache Server和IIS等。Resin支持Servlets 2.3标准和JSP 1.2标准。熟悉ASP和PHP的用户可以发现用Resin来进行JSP编程是件很容易的事情。Resin支持负载平衡，可以增加WEB站点的可靠性。方法是增加服务器的数量。比如一台Server的错误率是1%的话，那么支持负载平衡的两个Resin服务器就可以使错误率降到0.01%。到目前为止，Resin对WEB应用的支持已经远远超过Tomcat等各种大型的Server。
Resin 安装
在 Resin 的官方 quick start 教程中有各大平台详细的安装指导。我在使用 apt 安装时没有成功，这里就记录下手工安装的过程。
在 http://caucho.com/download 网址下载， Resin 有两个版本， Pro 版和GPL开源版，个人使用开源基础版本已经足够。安装过程如下：
- 安装JDK 6 或者以上版本，将 java 可执行程序配置到环境变量
JAVA_HOME中 tar -vzxf resin-4.0.x.tar.gz根据下载的最新版本解压cd resin-./configure更多参数参考 configure optionsmakesudo make install- 执行
sudo resinctl start, 或者运行java -jar lib/resin.jar start - 浏览
http://localhost:8080
可以使用 sudo resinctl stop 来停止运行，更多内容可以参考官方指南 。
IntelliJ IEDA 中使用 Resin 调试
第一步，添加 Resin Local 选项，在 IDEA 中 Run/Debug Configuration 中添加 Resin Local 选项
点击configure按钮，在弹出窗Application Servers中选择部分一中安装的Resin目录路径和目录下Resin的配置文件路径。
Run/Debug Configurations 中Server页面配置，基本都是默认。
Run/Debug Configurations 中Deployment页面配置,注意红色方框部分选择。选择resin.xml而不是JMX否则项目的index路径是localhost:8080/appname/ 而不是localhost:8080/
在Resin的服务器配置下 Depolyment中 Depolyment method：有 JMX 和resin.xml 两种选择, JMX 是把项目打包的文件放在resin 服务器下webapp下 只有在服务器启动时 才把项目给拷贝过去 无法在intellij中实时更新; resin.xml 是在C盘Temp 目录下 copy了一份resin.xml的配置文件 然后把服务器目录空间指向了你的项目工作空间 可以实现IntelliJ 修改实时更新。IntelliJ 默认的选择是JMX 所以我们要选中resin.xml模式。同时当项目 Artifacts 指向的目录是 ROOT 时 上图中的Use default context name(always true if depolyment method is JMX)取消勾选
执行build，得到war文件。执行resin run/debug，会自动在你选择的浏览器中打开项目index页面。也可以在IDEA下方的Application Servers面板中进行Resin的启动，停止等操作。Resin启动的打印信息也在此窗口显示。
每天学习一个命令：jstack 打印Java进程堆栈信息
Jstack 用于打印出给定的 java 进程 ID 或 core file 或远程调试服务的 Java 堆栈信息.
Prints Java thread stack traces for a Java process, core file, or remote debug server. This command is experimental and unsupported.
如果 java 程序崩溃生成 core 文件，jstack 工具可以用来获得 core 文件的 java stack 和 native stack 的信息，从而可以轻松地知道 java 程序是如何崩溃和在程序何处发生问题。另外，jstack 工具还可以附属到正在运行的 java 程序中，看到当时运行的 java 程序的 java stack 和native stack 的信息, 如果运行的 java 程序呈现 hung 的状态，jstack 是非常有用的。
thread dump 就是将当前时刻正在运行的 JVM 的线程拷贝一份，可以用来分析程序执行情况。
用法
打印某个进程的堆栈信息
jstack [PID]
jstack -l [PID]
jstack -m [PID]
关于如何找到PID，有很多方法，使用 jps -v 或者 ps -aux 或者 htop 等等方法都可以。
分析
在执行 jstack -l [PID] > /tmp/output.txt 之后可以对 /tmp/output.txt 进行分析
开头交代当前 dump 的时间和 JVM 基本信息
2018-05-24 14:41:06
Full thread dump Java HotSpot(TM) 64-Bit Server VM (25.101-b13 mixed mode):
接下来就是程序的线程信息
"resin-8015" #8015 daemon prio=5 os_prio=0 tid=0x00007f991820a800 nid=0x25e65 waiting on condition [0x00007f96b1b39000]
java.lang.Thread.State: WAITING (parking)
at sun.misc.Unsafe.park(Native Method)
at java.util.concurrent.locks.LockSupport.park(LockSupport.java:304)
at com.caucho.env.thread2.ResinThread2.park(ResinThread2.java:196)
at com.caucho.env.thread2.ResinThread2.runTasks(ResinThread2.java:147)
at com.caucho.env.thread2.ResinThread2.run(ResinThread2.java:118)
Locked ownable synchronizers:
- None
线程的状态 Thread Life States
- alive 通常运行时状态
- not started 线程已经被
java.lang.Thread.start()请求运行，但是实际上操作系统还没有开始 - terminated 线程已经结束
run()并且通知其他线程 joining
线程运行状态 Thread Run States
- blocked 该线程尝试进入一个被其他线程占用的 synchronized 块，当前线程直到锁被释放之前一直都是 blocked 状态
- blocked (on thin lock) 和
blocked相同的状态，但是锁需要是 thin lock - waiting 当前线程调用了对象的
Object.wait()，当前线程会保持该状态直到其他线程发送通知到该对象 - sleeping 当前线程调用了
java.lang.Thread.sleep() - parked 当前线程调用了
java.util.concurrent.locks.LockSupport.park() - suspended 当前线程的执行被
java.lang.Thread.suspend()暂停，或者有 JVMTI/JVMPI agent 调用
以上内容来自 Oracle
通过 jstack 信息可以分析线程死锁，或者系统瓶颈，但是这篇文章比较粗浅，只介绍了大概，等以后熟悉了补上。
reference
使用 antigen 来管理 zsh 插件
antigen 是 zsh 的插件管理工具，在他 GitHub 主页上的一句话非常形象的解释了他的功能。
Antigen is to zsh, what Vundle is to vim.
安装
curl -L git.io/antigen > antigen.zsh
或者
apt-get install zsh-antigen
配置
如果使用过 Vim 的 Vundle 对 antigen 的配置应该不陌生。
source /path-to-antigen-clone/antigen.zsh
# Load the oh-my-zsh's library.
antigen use oh-my-zsh
# Bundles from the default repo (robbyrussell's oh-my-zsh).
antigen bundle git
antigen bundle heroku
antigen bundle pip
antigen bundle lein
antigen bundle command-not-found
# Syntax highlighting bundle.
antigen bundle zsh-users/zsh-syntax-highlighting
# Load the theme.
antigen theme robbyrussell
# Tell antigen that you're done.
antigen apply
使配置生效 source ~/.zshrc
可以从这个页面 查看更多的插件。
reference
使用Shell命令来对 Unix 时间戳和日期进行转换 date 命令
在程序中经常要使用到 Unix timestamp 和日期的转换，通常情况下都是Google一个时间戳转换的网页在进行转换，其实 Linux 命令中就有能够快速实现转换的命令。主要都是集中在 date 这个命令。date 命令主要用于显示或设定系统时间和日期。
修改系统的时区
Linux 用来修正系统的时区
sudo dpkg-reconfigure tzdata
选择 Asia > Shanghai
date 常用命令
获取当前的 unix timestamp
date +%s # 返回 11 位时间戳，%s 表示从 1970-01-01 0点(epoch开始的秒数
date +%s%3N # 返回 14 位时间戳，毫秒
date +%s%N # 返回 11 + 9 位纳秒
将时间戳转换成日期
$ date +%s
1504516338
$ date -d @1504516338
Mon Sep 4 17:12:18 CST 2017
将 string 日期转成日期
使用 -d 参数可以用来将输入 String 转成特定格式日期，如果不指定具体时间，date会使用 00:00:00
$ date -d "06/04/1989"
Sun Jun 4 00:00:00 CDT 1989
$ date -d "04 June 1989"
Sun Jun 4 00:00:00 CDT 1989
$ date -d "June 04 1989"
Sun Jun 4 00:00:00 CDT 1989
$ date -d "June 04 1989 12:01:01"
Sun Jun 4 12:01:01 CDT 1989
-d 选项也有一些其他很强大的功能，比如
$ date -d '5 minutes ago' # 5 分钟前的时间
Mon Sep 4 17:22:58 CST 2017
$ date -d '100 days' # 100 天以后的日期
Wed Dec 13 17:29:14 CST 2017
$ date -d '-100 days' # 100 天以前的日子
Sat May 27 17:30:01 CST 2017
$ date -d '100 days ago' # 同上
Sat May 27 17:31:10 CST 2017
$ date -d 'next monday'
Mon Sep 11 00:00:00 CST 2017
格式化参数
可以使用+来输出不同格式
date +%<format options>
比如
$ date '+%Y-%m-%d %H:%M:%S'
2017-09-04 17:38:46
| Format options | Purpose of Option | Output |
| date +%a | 缩略方式显示星期 (like Mon, Tue, Wed) | Thu |
| date +%A | 全称显示星期(like Monday, Tuesday) | Thursday |
| date +%b | Displays Month name in short (like Jan, Feb, Mar ) | Feb |
| date +%B | Displays Month name in full short (like January, February) | February |
| date +%d | Displays Day of month (e.g., 01) | 07 |
| date +%D | Displays Current Date; shown in MM/DD/YY | 02/07/13 |
| date +%F | Displays Date; shown in YYYY-MM-DD | 2013-02-07 |
| date +%H | Displays hour in (00..23) format | 23 |
| date +%I | Displays hour (01..12) format | 11 |
| date +%j | Displays day of year (001..366) | 038 |
| date +%m | Displays month (01..12) | 02 |
| date +%M | Displays minute (00..59) | 44 |
| date +%S | Displays second (00..60) | 17 |
| date +%N | Displays nanoseconds (000000000..999999999) | 573587606 |
| date +%T | Displays time; shown as HH:MM:SS Note: Hours in 24 Format | 23:44:17 |
| date +%u | Displays day of week (1..7); 1 is Monday | 4 |
| date +%U | Displays week number of year, with Sunday as first day of week (00..53) | 05 |
| date +%Y | Displays full year i.e. YYYY | 2013 |
| date +%Z | alphabetic time zone abbreviation (e.g., EDT) | IS |
reference
Google+
文章分类
最近文章
- 威联通折腾篇五：安装 Transmission 下载 BT 这一篇讲在威联通上安装和使用下载工具 – Transmission。
- 威联通折腾篇六：文件同步 文件同步应该算是 NAS 最最基本的一个服务了，但是为什么直到篇六才提到他呢，是因为威联通自带的 QSync ，嗯，虽然能用，但是，没有 Linux 客户端，虽然其他平台客户端 OK，但是作为我主力工作的平台没有同步客户端，只能 smb 挂载。而之前搞 zerotier 同局域网速度不佳，其他 frp 内网穿透 也最多拉一些小文件，完全做不到 Dropbox 那样无缝，无痛。
- 威联通折腾篇四：Container Station 运行 Docker 容器 威联通上有一个 Container Station 的应用，可以直接用官方的 App Center 中下载安装，这其实就是一个 Docker 本地环境，如果熟悉 Docker 使用，那么其实都直接可以 ssh 登录 NAS 然后完全使用命令行来操作。
- 威联通折腾篇一：使用命令行安装威联通 QNAP 的 qpkg 安装包 如果想要给威联通安装一个 qpkg 的安装包时，最直观界面方式就是在 App Center 中，右上角，将本地的 .qpkg 文件上传到 NAS 并安装。
- 威联通折腾篇二：使用 frp 内网穿透 这是 QNAP NAS 折腾第二篇，使用 frp 来从外网访问 NAS。威联通自带的 qlink.to 实在是太慢几乎到了无法使用的地步，用 Zerotier 也依然很慢，所以无奈还是用回了 frp.