JAVA开发规范

前言

《杭州师范大学网络与信息安全实验室 JAVA 开发手册》是杭州师范大学信息安全实验室 Java 开发团队的经验总结，参考《阿里巴巴 JAVA 开发手册》泰山版的规约规范，以一位 学生 Java 开发者的视角，给予网络与信息安全实验室的 Java 开发者们一些建议。

引用《阿里巴巴 JAVA 开发手册》中的一句话:“适当的规范和标准绝不是消灭代码内容 的创造性、优雅性，而是限制过度个性化，以一种普遍认可的统一方式一起做事，提升协作效率，降低沟通成本。”因此，建议方向在 Java 开发的同学在阅读本手册的同时，搭配阿里巴巴 Java 开发规约 IDE 插件，在码代码的同时码出高效、码出质量。

前端方向(新人快看,有人在爬数!)

新人指南

工具

• Visual Studio Code 编辑器
• Google Chrome/Firefox 浏览器
  • Developer Tools 调试（F12）
• Git 分布式版本控制系统，GitHub， Git Flow（要求掌握）
• Postman http请求调试工具

前后端接口规范

随着前后端分离越来越普遍, 后端接口规范也就越来越重要了. 一套良好的接口规范可以提升工作效率, 减少沟通障碍.

通常我们都会采用 REST 方式来提供接口, 使用 JSON 来传输数据.

Markdown(轻量级标记语言)

必要的设计和说明文档能使开发过程中更加有效率，Markdown作为一种轻量级标记语言致力于使阅读和创作文档变得容易。

• 官网: https://www.markdownguide.org/
• 中文文档: https://markdown-zh.readthedocs.io

SVG Sprite

缘起

以前 vue 项目中使用 svg-sprite-loader 来处理 svg 文件使用非常方便，加载 svg 文件，配置完定义全局组件就好了，最近在写 react 项目，如法炮制，把 vue 中使用 svg 的思路带到 react 中来，实现的效果同样是只要把 svg 文件放到指定文件夹下使用文件名称结合 react 组件就可以使用。
使用步骤如下：

自定义音乐播放器

本站所用的音乐播放器是由DIYgod所制作的APlayer，其详细资料可参见这里。

next < 8.0 版本， 8版本next使用nunjcks进行模版布局，方式上会有所不同，但原理是一样的

升级 Hexo 和 NexT 主题

缘起

​之前用的是next的5版本， 没想到next团队换了仓库， 6以后的版本要到新仓库重新克隆升级，为了以后的升级可维护只好郁闷的重新配置

优化 Hexo 站点

注意：由于博客项目存在yarn.lock文件（可以直接删除但不推荐 ），若使用npm i 安装新包后(yarn add不需要)需要yarn install 重置依赖，否则无法锁定添加的依赖项，travis-cli会报yarn –frozen-lockfile的错误, 终止集成更新

过程

为区别 Hexo 目录下的文件和 NexT 主题下的文件，下文分别使用 hexo/<文件路径> 和 next/<文件路径> 以示区别。

缘起

继续折腾 Hexo，这次尝试启用文章的留言系统。NexT 主题预置了 Disqus、畅言、Valine、LiveRe、Gitalk 这几家，比较下来感觉 Valine 最契合 NexT 的主题风格，就是它了。