IntelliJ IDEA 进阶教程: 语言注入

2019-09-09 05:28:54

参考链接 IntelliJ IDEA 进阶教程: 语言注入

我真的太久没发 IntelliJ 的教程了,最近 Sakura 同学找我帮他配 IntelliJ ,我秀了一下技术,假装自己是老司机。 然后发现 Language Injection 这个非常好用的功能我居然没写教程(很明显,一堆人不知道这个东西), 于是我又开始写教程了。

本文多图。

愚人节快乐。本文不愚人。

本文主要内容

  • 语言注入

  • 文学编程

  • 测试代码中的正则

  • 测试代码中的 SQL 语句

  • 在 Markdown 中的使用

卖萌

想必各位都知道什么是文学编程

正文

基本用途

文学编程( Literate programming ) 用最简单的方式解释其实就是 把代码写进文档,然后提取代码运行。知乎用户bhuztez(不撸兔子) (现已被永久封号)说过他为了验证21 天学通 Erlang里代码的正确性,写了个程序把书里面的代码抠出来, 然后分别验证运行结果和书上说的是否一致。

嘛,这差不多就是文学编程了(其实这只是很偏颇的理解,详情请看 Wikipedia, 但是和本文关系不大),那么为什么我要说这个呢?

因为 IntelliJ IDEA 有一个功能,可以讲代码检查注入到一些常量当中。 这些常量在大部分情况下,是代码里的注释和字符串常量。

举个例子,我们在 IntelliJ 里面写:

/*
class Main {
 public static void main(String[] a) {
   System.out.println("Hello World");
 }
}
*/object Main {
  @JvmStatic
  fun main(a: Array<String>) {
    println("Hello World")
  }}

我写在注释里面的是一段等效于下面的 Kotlin 代码的 Java 代码,我这时只能通过大脑编译它。 万一写错了,读者找你撕逼可是很麻烦的呀。

步骤

所以说 IntelliJ IDEA 提供了一个很方便的功能叫 Language Injection。操作步骤:

  1. 在要注入的地方(注释,字符串, etc.) Alt+Enter

  2. 选择 Inject Language or Reference

  3. 选择要注入的语言

  4. Enjoy

例子

我们来看看这个例子,首先在上面的注释里面 Alt+Enter :

Alt+Enter

然后选 Inject Language or Reference ,然后选语言。这里根据我们的需求,选 Java :

Choose Java

然后就可以看到高亮出来了,左边也多了一个并不能按的运行按钮:

See highlight

如果写一些调皮的代码,也会出现报错:

See highlight

之所以前面的代码没有报错,是因为此处 IntelliJ 关闭了对于外部类的检查,因此:

  • IntelliJ 被视为一个类

  • IDEA 是变量名

  • boy 是一个函数/变量

  • 后面的就什么都不是了,所以有一个报错

代码补全也有了:

See highlight

Live Template 也有了:

See highlight

重构功能也有了:

See highlight

注意,上面那个对 233 这个字面值的 Unused 也检查出来了。

看起来是不是很棒?这有点文学编程的味道了吧?

顺带一提,上面的代码其实是错的,下文再解释。

如果你的代码有伪代码成分,可以取消语言注入。直接 Alt+Enter 然后选 Uninject Language 开头的那个就好啦。

那么运行呢?我想运行代码看看效果怎么办?

运行

在 Inject 了的代码块中 Alt+Enter ,选 Edit [语言] Fragment ,

Edit Fragment

可以看到蹦出来了一个窗口,里面就是这段代码的碎片。

Edit Fragment

这时 IntelliJ 就会检查依赖了,说找不到 Random 这个函数。此时就显示出了我写了多久 Kotlin静态分析的重要性了。

我们进行重构,先把 new 加上,然后把 Random 类给 import 进来,可以看到 import pop up 都有了,然后加上 nextInt()的方法调用:

Fragment Refactor

上下代码是同步的,下面的编辑了上面的也会变:

Fragment Changes

Markdown 支持

这功能在写文档的时候很方便, IntelliJ 的官方 Markdown 插件会在 Markdown 代码块中强制注入你所选的语言,举个例子:

Markdown Injection

而且在写 Markdown 的时候也会有这样的补全:

Markdown Completion

非常方便不是吗?(可惜是强制注入)

正则和 SQL 支持

想必大家在写代码的时候代码里面肯定会出现很多 SQL 语句,或者正则表达式,有时它们会被 IntelliJ 识别出来,有时不会,比如:

Reg

正则注入

而且这个正则表达式的支持真的太方便了!

先对正则表达式 Alt+Enter ,选 Check :

Reg1

然后可以测试正则表达式,比如上面那个我随手写的 16 进制检测:

Reg2

和调皮的测试,会报 Not matches :

Reg3

要让上面那个没被识别的字符串也可以进行这样的正则检测,可以对它注入 RegExp 语言(就是正则表达式), 这样就会被识别为正则表达式了:

Reg4

这时你会看到一个提示,让你加个 annotation ,这样在别的地方也会直接被识别出 Language Injection :

Reg4

fun main(args: Array<String>) {
	@Language("RegExp")
	val rg = "0[xX]([0-9]|[a-f]|[A-F])+"
	val reg = Regex("0[xX]([0-9]|[a-f]|[A-F])+")}

然后就可以进行 check regexp 了:

Reg4

同理,我们有时候会看到被识别出的 SQL 语句:

SQL1

它还会提示你选择对应的数据源,如果是查询语句,可以直接对查询语句进行测试。

同理,我们也可以对 SQL 字符串直接注入:

SQL2

注释也可以注入:

SQL3

但是注释不能通过 annotation 来保留这次注入。


  • 2019-06-03 00:07:32

    Android程序Crash时的异常上报

    家都知道,android应用不可避免的会发生crash,无论你的程序写的多完美,总是无法完全避免crash的发生,可能是由于android系统底层的bug,也可能是由于不充分的机型适配或者是糟糕的网络状况。当crash发生时,系统会kill掉你的程序,表现就是闪退或者程序已停止运行,这对用户来说是很不友好的,也是开发者所不愿意看到的,更糟糕的是,当用户发生了crash,开发者却无法得知程序为何crash,即便你想去解决这个crash,但是由于你无法知道用户当时的crash信息,所以你也无能为力。是否真的这样呢,其实android中有处理这类问题的方法,请看下面Thread类中的一个方法#setDefaultUncaughtExceptionHandler

  • 2019-06-04 16:40:30

    为了美观当网页图片不存在时不显示叉叉图片

    当在页面显示的时候,万一图片被移动了位置或者丢失的话,将会在页面显示一个带X的图片,很是影响用户的体验。即使使用alt属性给出了”图片XX”的提示信息,也起不了多大作用。

  • 2019-06-04 17:38:44

    PHP时间转换今天昨天前天几天前

    实际情况应该是,昨天任何时间都算一天前,前天任意时间都算2天前,所以自己琢磨了一番,去动态更新时间与今天23:59:59相差的时间秒数与86400(24 x 3600)相除后,向下取整,这样就得到了相差的天数,比如昨天00:00~昨天23:59:59的任何时间与今天的23:59:59,都相差 86400~(86400 x 2) 天,也就是2天。

  • 2019-06-04 17:44:14

    【VUE】图片预览放大缩小插件

    在看项目时,突然看到预览图片的弹窗,感觉好僵硬,不能放大,不能切换,于是便在网上找下关于图片预览的插件,有找到三个插件,具体的优劣势的看自己的使用吧,我目前只是在电脑查看效果,分别是viewerjs插件、基于photoswipe的vue-photo-preview插件以及vue-picture-preview插件 作者:北极星丶超帅的 链接:https://www.jianshu.com/p/e3350aa1b0d0 来源:简书 简书著作权归作者所有,任何形式的转载都请联系作者获得授权并注明出处。

  • 2019-06-04 21:32:05

    Android 全局Dialog的简单实现

    这里所说的全局Dialog是指无论当前应用是处于哪一个页面上,都能够及时弹出Dialog来提示用户一些信息,用户体验不会很好,一般应用于优先级非常高的通知。

  • 2019-06-06 16:14:50

    intent-filter的action,category,data匹配规则

    我们知道有两种方式来启动Activity,显示调用和隐式调用。当使用隐式调用时,又会涉及到IntentFilter的匹配规则。我确信大多数开发者很少关注隐式调用,因为平时开发中用到大多数是显示调用。例如:用Intent直接打开一个Activity,或者用Intent通过包名等其他信息打开另外一个应用等。而隐式调用则使用的比较少,当然也不是完全不使用。例如:当我们需要打开浏览器访问某个链接时,手机上可能存在多个浏览器,我们也无法拿到某一个浏览器的包名,那么一般情况下我们会写如下代码:

  • 2019-06-06 17:57:57

    input【type="checkbox"】标签与字体对齐

    今天分享一个比较实用的技巧,在实际项目中我们会经常遇到表单的input标签多选和单选的问题,但是往往由于标签自身的样式和我们项目的风格很不搭调,就不能实现了,今天就来告诉大家怎么去实现吧。

  • 2019-06-10 11:54:52

    html.div禁用点击事件

    今天做项目中偶然误把元素加上了pointer-events属性,结果导致后来在js中给该元素加点击事件不能用,检查了半天才发现是这个属性的问题。之前没有好好研究,于是决定仔细研究一下。