在各种 IDE 特别繁多的今天，我为什么还要使用编辑器。写这篇文章完全无意去争辩哪个编辑器是最好的，适合自己的，才是最好的。

初识 emacs

在第一次接触到 emacs 的时候，其实并没有被这个其貌不扬的货给打动。甚至一度觉得快捷 键实在是太复杂，差点就弃用了。但是在我 ‘M-x help’ 之后，我发现了一个不同的世界。

这个编辑器就是计算机史上的艺术，在经过差不多与计算机历史相同的时间之后，依然拥有着强大的生命力。emacs 本身由 lisp 编写，整个软件的设计的思想在今天依然不落伍。当然，软件的好坏不能使用存在时间的长短来衡量，更重要的是，它好用。

重度使用

首先，编辑器轻量级，相比于 IDE，编辑器所需要的系统的资源实在是少的很，可以快速的打开，然后开始码字，没有丝毫的负担。电脑也就不会不断的轰鸣，终于可以安安静静的敲键盘了。

• 编码
  其次呢，现在大部分编辑器都有着丰富的插件，在合理的安装了插件之后，整个编辑器的功能就已经与 IDE 的功能不相上下了，比如自动补全，项目文件搜索，项目结构树，搜索，替换等，在这些插件的帮助下，我们就可以完成编码过程中所需的绝大部分的操作。

• 少既是多
  再者，在使用 IDE 的过程中，每换一种编程语言，都得换成另外一个 IDE,这样得花时间去学习不同的 IDE,还得在电脑上装上一堆的 IDE，怎么说都不是一件很愉快的事情。但是在编辑器上就不一样了，绝大部分的代码都可以直接编写，而不用去为不同的语言做切换。只需要装几个不同的插件就可以了。同时呢，在编码的同时，也可以使用编辑器直接将文档也编写了。甚至展示用的 PPT 也可以直接使用编辑器来完成（reveal.js）。

• 万能的 org-mode
  对于我来说呢，使用 emacs 的一个很重要的原因就是 org-mode，现在，基本我所有的文档都是使用 org-mode 来编写了，编辑完的文档可以轻松的导出为 Markdown 和 pdf， tex 以及网页等其他格式的文档。基本上可以做到一次编写，处处使用了。而且 org-mode 还可以用来做 todo，日程安排，表格统计等。基本上可以完成日常工作中的所有的功能了。

当然，说了这么多，并不是来说明编辑器是全能的，在某些情况下，使用 IDE 才能帮助我们更高效的完成工作。比如说一些移动端的开发，在不同的工作环境下，我们应当使用更合适的工具来完成工作。

简介

JSON API 是一个客户端应该如何如何请求或者修改资源，以及服务器端如何对这些请求作出回应。

JSON API 是为了最小化客户端以及服务器端的请求数量以及大量的数据交换。在不牺牲可读性和灵活性的前提下来提升效率。

JSON API 需要使用 application/vnd.api+json 协议来传输数据。

约定

文中的这些关键字 “MUST”,”MUST NOT”, “REQUIRED”, “SHALL”, “SHOULD”,”SHOULD NOT”, “RECOMMENDED”,”NAY” 以及
“OPTINAL” 都可以在 RFC 2119 标准中可以找到解释。

内容限定

客户端职责

客户端必须(MUST)在 JSON API 请求的时候都要在请求的头部加上 Content-Type:application/vnd.api+json,不带其他的任何参数。

客户端在 JSON API 请求的头部的 Accept 中必须(MUST)至少指明一次协议的类型而不带任何的参数。

客户端必须(MUST)忽略收到的响应为 application/vnd.api+json 类型中 Content-Type所携带的任何参数。

服务器端职责

服务器必须(MUST)发送不携带任何参数的 application/vnd.api+json 类型的响应。

服务器必须(MUST)响应 415 Unsupported Media Type 状态码，如果请求 Content-Type:application/vnd.api+json 中携带任何参数的话。

服务器必须(MUST)响应 406 Not Acceptable 状态码，如果一个请求的头部的 Accept 的加上了参数的话。

注意：这个内容协定要求在当前和未来的使用这个协议以及相关扩展的版本中都会存在。

文档结构

这个小节讨论 JSON API 文档的结构。这个协议已经被定义为 application/vnd.api+json。JSON API 文档已经被定义在 JavaScript Object Notation(JSON)[RFC7159]。

尽管请求和响应使用的是相同的协议类型，某些方面只适合其中的一个，这其中的区别在稍后会谈到。

除非特殊情况，否则通过这个规格定义的对象不能(MUST NOT)包含其他的任何成员。客户端和服务器的实现必须(MUST)忽略不在这个规范范围内的其他成员。

注意：这些条件允许规格通过添加改变的方法来进化。

顶层

一个 JSON 对象必须(MUST)是任何的 JSON API 请求和响应所携带数据的根结构，这个对象定义文档的顶层。

一个文档必须(MUST)至少包含一个以下的顶层成员:

• data: 文档的主要数据
• errors: 一个错误对象的数组

• meta: 一个包含非标准信息的 meta 对象

  data 和 errors 不能同时出现在同一个请求或者响应中。

一个文档可能(MAY)会包含以下任何的顶层成员:

• jsonapi: 一个描述服务端实现的对象
• links: 与主要数据相关的链接对象
• included: 一个与主要数据有关联或者其他的资源对象的数组。

如果文档的顶层没有 data 键，这个 included 成员也不能(MUST NOT) 出现在这里。

这个顶层链接对象可能(MAY)包含以下的成员:

• self: 当前响应生成的链接
• related: 一个相关的资源链接，当这个主要的数据代表一个资源的关系
• pagination: 主数据的分页链接

文档中的主数据是指请求的资源的集合。

主数据必须(MUST)是以下两者中的一个:

• 一个单独的资源对象，一个单独的资源标识对象或者是 null, 为了去请求目标资源
• 资源对象数组，资源标识对象的数组或者一个 null 的数组，为了请求目标资源集合

举个例子，下面的数据就是一个单独的资源对象:

1
2
3
4
5
6
7
8
9
10
11
12

{
  "data": {
    "type": "articles",
    "id": "1",
    "attributes": {
      // ... this article's attributes
    },
    "relationships": {
      // ... this article's relationships
    }
  }
}

下面就是一个资源的标识对象，指代一些资源:

1
2
3
4
5
6

{
  "data": {
    "type": "articles",
    "id": "1"
  }
}

一个资源的集合必须用一个数组来表现，即使只有一项内容或者为空。

资源对象

资源对象 在 JSON API 的文档中代表资源。

一个资源必须(MUST)包含至少以下两个顶层成员:

• id
• type

例外: 当这个资源代表一个即将要被传送到服务器端创建的时候，这个 `id 可以被省略。

另外，一个资源对象可能(MAY)包含以下的顶层成员:

• attributes: 代表资源数据的属性对象
• relationships: 描述这个对象与　JSON API 其他对象关系的关系对象
• links: 包含其他资源的链接对象
• meta: 包含对象非属性数据的 meta 对象

一个 article 对象可能是如下的表示:

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

{
  "type": "articles",
  "id": "1",
  "attributes": {
    "title": "Rails is Omakase"
  },
  "relationships": {
    "author": {
      "links": {
        "self": "/articles/1/relationships/author",
        "related": "/articles/1/author"
      },
      "data": { "type": "people", "id": "9" }
    }
  }
}

唯一标识

论文管理

在学术的过程中，论文的管理是一个非常头疼的事情，当需要整理的论文多到一定数量的时候，很难按照一种有秩序的方式来管理。但是科技作为第一生产力，总是有办法来解决这个问题的。
Paper3 无疑是提升生产力的一个优秀的代表。阅读论文很难说是一个很好的体验，阅读的难度就不说了，还需要从中提炼出我们所需要的信息。如果不做好这些笔记，那么过了一会(并不需要一天)，这篇论文里面讲的东西也就忘的差不多了。在学术的过程中，有些问题总是一直存在的:

• 论文的分类
• 获取高质量的论文
• 获取一篇特定的论文
• 写论文想要用之前的笔记或者批注，发现很难找到
• 论文丢了。。或者电脑丢了。。。。

而 Paper3 刚好就可以用来解决这些问题。

Paper3

简介

官网上的简介是 你个人的科研图书馆，这句话正是对这个软件最好的描述。

进入软件后的主页如下:

强大的搜索能力

在 Paper3 里面，内置了多达 25 中搜索引擎，常见的例如 ACM, Google Patents, Google Scholar, Web of Science 等数据库引擎，所以如果想要找的论文在这里找不到，在其他的地方也不大可能找到了。

在搜索的过程中，所输入的关键词会同时在你收藏的数据库中搜索。而且同时支持从多方面的搜索，比如 title, author, year, publisher, abstract 方面搜索，比如我要搜索一篇 SDN 在 2015 年发表的论文，我可以如下搜索:

回车键后开始搜索，搜索结果如下:

然后选择我们想要的搜索结果，可以直接将论文导入到我们自己的数据库中:

整洁的资料分类

Paper3 提供了强大的论文分类功能，可以很方便的建立 Collection,我们可以通过 File -> New Collection 来新建一个 Collection。Collection 总体上可以分成两类:

• 一类是普通的 Collection, 这样我们就需要通过右键点击论文 add to collection

• 还有一个是 Smart Collection,论文会根据你自定义的参数自动的加入进来。

除了这样的分类，还可以为文章添加关键词，随后在搜索的时候，我们可以直接搜索这些关键词，就可以快速的定位到我们看过的一些文章，就可以自然的找到做过的笔记和批注。

便利的阅读体验

以下是阅读的主界面:

右栏中可以显示论文的相关信息，和笔记以及一些社交信息。

在阅读论文的过程中，可以通过右键来完成以下的功能:

• 可以轻松的在论文里面标注，加自己的笔记
• 将一段文本标记为高亮，有多种颜色可选
• 将一段文本标记为下划线
• 将一段文本标记为删除线
• Mac 利用自带的词典可以随时查单词，在 Windows 上可以利用有道词典的屏幕划词功能来取代这个。

其他

笔记本有丢失和损坏的风险，纸质的资料更是不保险，那么这个时候云同步的功能就是很有必要的。 Dropbox 可以带来很强大的同步体验，但是迫于无奈，在国内由于一些原因(你懂的),所以 Dropbox 可能没办法使用，所以百度云同步某种程度上也是可以作为替代品的。但是我还是一直在使用 Dropbox，为什么？因为颜值高呀，哈哈。

在 Java 中，观察者模式是一个很重要的设计模式，在这篇文章中，我们来简单了解一下如何利用 Java 语言的特性来实现
一个简单的观察者模式。

Java 中的 Obserable 与 Observer

在 Java SE 中，有一个 Observer 接口和一个 Observer 类。在 api 文档中，描述如下：

• Observer 一个类实现乐这个接口之后，被观察的对象如果有改变，那么这个类就可以接收到通知。实现这个接口必须要实现 update 方法。
• Obserable 这个类代表一个可观察的对象，或者 model 层的一个实例，可以被认为是想被观察的对象的一个子类。一个可观察的对象可以有多个观察者。

实现简单的观察者模式

首先需要定义一个可观察的对象,这个对象中有一个 data 变量，这个变量在被改变的时候会通知到观察者：

1
2
3
4
5
6
7
8
9
10

public class ObservableObject extends Observable{
	int data = 0;
	
	public void changeData(int change) {
		data = change;
		this.setChanged(); //标记对象被改变
		this.notifyObservers();  //通知所有的观察者
	}
}

定义观察者，观察者在接收到被观察者的改变之后，会将改变的值打印出来:

1
2
3
4
5
6
7
8
9
10

public class ObserverObject implements Observer {
	@Override
	public void update(Observable o, Object arg) {
		ObservableObject oo = (ObservableObject) o;
		
		System.out.println("被观察者的数据被修改为："+ oo.data);
	}
}

测试：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

public class Main {
	public static void main(String[] args) {
		ObservableObject observableObject = new ObservableObject();
		ObserverObject observerObject = new ObserverObject();
	
		observableObject.addObserver(observerObject);
		observableObject.changeData(1);
		observableObject.changeData(-100);
		
		observableObject.deleteObserver(observerObject); //移除观察者
		observableObject.changeData(200);
	}
}

运行结果为：

1
2

被观察者的数据被修改为：1
被观察者的数据被修改为：-100

需要注意的是只打印了两个结果，是因为在第三次改变之前将观察者移除了，这样造成的结果是被观察者的改变将不能通知到被移除的观察者。

Laravel5.2 中出现了一个很有用的特性。这一特性是值得期待的，中间件组的出现可以提高中间件的复用，而且可以让中间件更好组织。
这是 Laravel 在设计思想上的一个重大的提升，也就是 Laravel 在为无状态的开发，也就是前后端分离在做准备。

中间件组

在 app\Http\Kernel.php 文件中，出现一个新的配置选项 $middlewareGroups,该数组的键是中间件组的名称，值则是多个中间件
的集合。默认提供了 web 和 api 中间件组的配置:

1
2
3
4
5
6
7
8
9
10
11
12
13

protected $middlewareGroups = [
    'web' => [
        \App\Http\Middleware\EncryptCookies::class,
        \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
        \Illuminate\Session\Middleware\StartSession::class,
        \Illuminate\View\Middleware\ShareErrorsFromSession::class,
        \App\Http\Middleware\VerifyCsrfToken::class,
    ],
    'api' => [
        'throttle:60,1',
    ],
];

我们当然也可以在其中增加自己的中间件配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

protected $middlewareGroups = [
    'web' => [
        \App\Http\Middleware\EncryptCookies::class,
        \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
        \Illuminate\Session\Middleware\StartSession::class,
        \Illuminate\View\Middleware\ShareErrorsFromSession::class,
        \App\Http\Middleware\VerifyCsrfToken::class,
    ],
    'api' => [
        'throttle:60,1',
    ],
    'admin' => [...]
];

中间件组的使用：

1
2
3

Route::group(['middleware' => ['web']], function () {
    //
});

需要注意的地方

在之前的版本中，app\Http\Kernel.php 文件中默认的中间件配置如下：

1
2
3
4
5
6
7
8

protected $middleware = [
       \Illuminate\Foundation\Http\Middleware\CheckForMaintenanceMode::class,
       \App\Http\Middleware\EncryptCookies::class,
       \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
       \Illuminate\Session\Middleware\StartSession::class,
       \Illuminate\View\Middleware\ShareErrorsFromSession::class,
       \App\Http\Middleware\VerifyCsrfToken::class,
   ];

但是在 5.2 的版本中，配置是这样的:

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

protected $middleware = [
    \Illuminate\Foundation\Http\Middleware\CheckForMaintenanceMode::class,
   ];
protected $middlewareGroups = [
    'web' => [
        \App\Http\Middleware\EncryptCookies::class,
        \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
        \Illuminate\Session\Middleware\StartSession::class,
        \Illuminate\View\Middleware\ShareErrorsFromSession::class,
        \App\Http\Middleware\VerifyCsrfToken::class,
    ],
    'api' => [
        'throttle:60,1',
    ],
];

对比可以发现，cookies,sessions, CSRF的功能，都从默认中间件中被移除了，加入到了 web 中间件组中了。也就是说，没有
使用 web 中间件组的路由将没有 cookies，sessions，CSRF 的功能了，这也是为什么在 Laravel5.2 中使用默认的登录验证方式，在
没有使用 web 中间件的情况下，登录状态是没有办法保持的。这是 Larvel 在设计思想上的一个重大的提升。

在这次的开发中使用到了调用相机的功能，记录如下：

调用系统相机，获取照片方法如下：

1
2
3
4
5
6
7

File outputImage = new File(filename); //需要具体的文件名称和路径
Intent intent = new Intent();
intent.setAction(MediaStore.ACTION_IMAGE_CAPTURE);
imageUri = Uri.fromFile(outputImage);
intent.putExtra(MediaStore.EXTRA_OUTPUT, imageUri);

以上的代码虽然可以获取照片，但是却也什么都做不了，因为，我们可能需要对这些照片进行额外的操作，比如放到特定的文件夹，或者缩放，
或者裁剪。

将照片放到特定的位置

如果只是调用 Environment.getExternalStorageState() ,这会将照片直接保存在 SD 卡的根目录，下面的代码可以将照片保存到 SD
卡的任意地方，如果目录不存在，就会创建一个新的目录：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

private File createOutputFile(String path, String fileName) {
    String storageStatus = Environment.getExternalStorageState();
    if(Environment.MEDIA_REMOVED.equals(storageStatus)) {
        Log.i(TAG, "SD 卡不存在");
        return null;
    }
    File pictureDir = new File(Environment.getExternalStorageDirectory(), path);
    if(! pictureDir.exists()) {
        if(! pictureDir.mkdirs()) {
            Log.i(TAG, "目录创建失败");
        }
    }
    File file = new File(pictureDir, fileName);
    return file;
}

对照片进行裁剪

以下的代码可以启动一个裁剪器，对刚刚拍好的照片利用系统相机的功能进行裁剪：

1
2
3
4
5
6
7
8
9
10
11

Intent intent = new Intent("com.android.camera.action.CROP");
intent.setDataAndType(imageUri, "image/*");
intent.putExtra("aspectX", 1);
intent.putExtra("aspectY", 1);
intent.putExtra("outputX", 200);
intent.putExtra("outputY", 200);
intent.putExtra("scale", true);
intent.putExtra("return-data", false);
intent.putExtra(MediaStore.EXTRA_OUTPUT, imageUri);
intent.putExtra("outputFormat", Bitmap.CompressFormat.JPEG.toString());
intent.putExtra("noFaceDetection", true);

都知道坚持一件事可以超越 80% 的人，但是可能仅仅 20% 的人做到了。想清楚一点就发现我们的环境被概率论所支配，比如那个八二理论。从总体上来说，我们都是其中一个不可预知的随机变量，当然，这个是从总体上来说，对于每一个确定的个体，却不是随机的。

想学摄影，发现怎么也学不会构图，故而放弃。想学吉他，只学会了生日快乐。想学游泳，只学会了狗爬式。想学编程，直到现在也才只会 Hello world。学不下去最直观的感受就是，这个真他么难，但是实际上可能并不是这样，只是有时候步子跨的太大，扯着dan了。其实解决这个问题的方法也很简单，就是将自己的步子放小一点，让自己可以感受到自己的进步，这样来说，大脑接收到的都是正面的回馈，不会产生想放弃的感觉。就是说只要在学习的过程当中，不断的给大脑喂胡萝卜，让大脑一直保持学习的兴趣，这样的话，学习新的技能是不是轻松点。

AlertDialog 的坑

对话框是安卓开发里面使用的一个很广的组件，我们可以利用这个组件来完成很多的功能，而这篇文章主要讲到的是在开发中使用 AlertDialog 时候遇到的
一个小问题，开发时的代码类似下面这些:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

  AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(new ContextThemeWrapper(context, R.style.AlertDialogCustom));
  dialogBuilder.setTitle("xx");
  dialogBuilder.setMessage("xxx");
  dialogBuilder.setCancelable(false);
  dialogBuilder.setPositiveButton("OK", new DialogInterface.OnClickListener() {
            @Override
            public void onClick(DialogInterface dialog, int which) {
                ActivityCollection.finishAll();
                Intent intent = new Intent(context, LoginActivity.class);
                intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                context.startActivity(intent);
            }
        });
  AlertDialog alertDialog = dialogBuilder.create();
 alertDialog.getWindow().setType(WindowManager.LayoutParams.TYPE_SYSTEM_ALERT);
alertDialog.show();

在 AndroidManifest.xml 文件中还需要配置一个权限：

1

<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />

以上的代码是弹出一个系统级别的警告框，上面的那些代码是没有问题的，但是在小米手机上调试时，程序没有报错，但是那个警告框就是
没有弹出来，好吧，找了半天发现，需要在手机上开启这个系统对话框的权限：

opencv for android

opencv 近些年的发展很好，在安卓平台上已经有了比较成熟的版本。关于 Opencv For Android 的相关细节可以查看官网。本文主要是关于在 Android Studio 平台上开发环境的配置，本文的软件版本为 Android Studio 1.5 以及 Opencv For Android 2.4.11。

配置过程

1. 下载 Opencv For Android 的 sdk，下载地址, 下载完成之后解压。
2. 将 opencv 导入进 Android Studio, 从 File -> New -> Import Module， 然后选择 sdk/java 那个文件夹。
3. 更新导入的 Module 中的 build.gradle 文件，将其中 android sdk 的版本改成当前项目的 android sdk 的版本。
4. 增加 Module 依赖，File -> Project Structure, 然后选择 app Module，切换到Dependencies，点击 + 号，选择 Module，就能看见刚才添加的 OPencv Module，把它添加进来。
5. 将解压包下的 sdk/native/libs 里面的内容拷贝到 app/src/mian 目录下，并将其改名为 jniLibs。

在实际使用的时候，在 MainActivity 下添加以下的代码：

1
2

if (!OpenCVLoader.initDebug()) {
}

以上的代码是去加载 opencv 的库文件。

在 android studio 中配置这个环境很简便，甚至都不需要配置 NDK 的环境。

Laravel 队列

Laravel 队列使用起来很方便，任何的 Event 和 Job 只要实现了 ShouldQueue 这个接口就代表着这些 Event 或者 Job 在
触发的时候会被加入到队列中。本文中的队列是基于 redis 实现的，其他的配置方法可以查看官网。

队列监听

在测试的时候，队列的监听可以在命令行启动，但是在正式上线的时候，就需要将监听设置成后台的 deamon，让监听在后台持续的运行，确保队列正常的
运作。linux 的 nohup 命令基本可以完成这一个需求，但是这个命令有个问题，在队列监听因为异常挂掉了之后，没有办法重启监听。这个对于实际的
上线来说是有问题的。那么这个时候，使用 supervisord 就很有用。利用这个工具可以完成队列监听的开机启动
以及自动重启。

队列中的坑

通过以下的命令可以完成队列监听：

1

php artisan queue:listen

将这个命令写入到 supervosird 的配置文件中基本就算完成配置了，但是这里有一个坑，这个命令有一个 –tries 的参数，这个参数的意思是在队列
任务执行失败之后，需要重新执行多少次，它的默认值特别具有迷惑性，它的默认值是 0，这个0不是尝试0次，而是不断的尝试，之前就是因为没有配置这个
参数才导致微信的模板消息被消耗光。在不断尝试的时候，也不会发送队列执行失败的邮件。找了半天才发现这个bug。