Java Lint 工具 Stephen Suen
Copyright (c) 2005 Stephen Suen. All rights reserved.
如果你在编译 Java 程序时,碰到类似"注意: 要了解详细信息,请使用 -Xlint:deprecation 重新编译"这样的提示,而且你对选项
-Xlint 感到困惑的话,本文或许会带给你一些有趣且有用的信息。
本文的最新版本将发布在程序员咖啡馆
<http://www.programmercafe.com/>网站上(建设中)。欢迎订阅我们的邮件组<http://groups.google.com/group/programmercafe>
,以获得关于本文的正式发布及更新信息。全文在保证完整性,且保留全部版权声明(包括上述链接)的前提下可以在任意媒体转载——须保留此标注。
------------------------------
*目录* 1. 简介 2. Lint 3. Java Lint 选项
1. 简介
如果你已经开始使用 JDK 1.5(或者称为 JDK 5.0),那么你很可能在编译时,已经看到过类似如下的警告信息:
注意: E:\sandbox\src\DefaultController.java 使用或覆盖了已过时的 API。
注意: 要了解详细信息,请使用 -Xlint:deprecation 重新编译。
或者这个:
注意: E:\sandbox\src\DefaultController.java 使用了未经检查或不安全的操作。
注意: 要了解详细信息,请使用 -Xlint:unchecked 重新编译。
这些警告不难理解。如果愿意,只要按照提示在编译时指定相应的选项就可以了。可是,如果你也像我一样,困惑于这个编译选项中晦涩的英文(-Xlint),以至于 经常要借助参考手册才能想起这个选项的用词或者拼写,那么这篇短文或许对你有些帮助。
2. Lint
在介绍这些关于警告的选项前,我们先看看 lint 究竟是什么。在英文中,lint
是指纠缠在一起的细小纤维或者绒毛,比如衣物上面起的毛或者线头。咋看起来,这个词用在 Java
编译器选项中,似乎有点风马牛不相及。但是如果你知道一个古老的 Unix 工具被命名为 lint(1),那就另当别论了。
在 Unix 中,实用工具 lint(1)
用于在对程序编译的过程中,对程序进行更为细致的额外检查,比如使用未经初始化的变量等常见的编程问题。如此命名该工具,正是借用了"lint"
一词的含义:将"lint"从程序中挑拣出来,从而使程序更"干净"。
现在我们至少对选项中的 "lint" 有了一些有趣的认识了,记住这个词应该问题不大了。随后,我们将简单地了解一下 Java 的 lint
工具。当然,因为 lint 工具当然会涉及到语言规范中的一些知识,而这篇短文显然不适合阐述这些知识。如果对相关内容有兴趣,可以参考其它资料。
3. Java Lint 选项
Java 编译器的选项包括所谓的标准选项和非标准选项。标准选项是指在当前版本的开发环境中支持,且在未来版本中也将被支持的选项。常用的标准选项比如
-classpath 以及 -d 等等。
非标准选项是在当前版本的开发环境中支持,但不能保证将来一定会继续支持的选项。非标准选项都由 -X 开头,比如我们这里所关心的 Java Lint
选项都由 -Xlint 开头。需要先说明的是,单纯的选项 -X 本身是一个标准选项,作用是显示关于非标准选项的信息。参考这个例子:
E:\>javac -X
-Xlint 启用建议的警告
-Xlint:{all,deprecation,unchecked,fallthrough,path,serial,finally,-deprecat ion
,-unchecked,-fallthrough,-path,-serial,-finally}启用或禁用特定的警告
-Xbootclasspath/p:<路径> 置于引导类路径之前
-Xbootclasspath/a:<路径> 置于引导类路径之后
-Xbootclasspath:<路径> 覆盖引导类文件的位置
-Djava.ext.dirs=<目录> 覆盖安装的扩展目录的位置
-Djava.endorsed.dirs=<目录> 覆盖签名的标准路径的位置
-Xmaxerrs <编号> 设置要输出的错误的最大数目
-Xmaxwarns <编号> 设置要输出的警告的最大数目
-Xstdout <文件名> 重定向标准输出
这些选项都是非标准选项,如有更改,恕不另行通知。
我们依次来看看其中涉及 lint 的选项:
-Xlint
启用所有警告。该选项相当于 -Xlint:all 选项。相反,关闭所有警告的选项为 -Xlint:none。
-Xlint:unchecked
启用对所谓的未经检查的转换(unchecked warning)的警告。这个警告涉及 JDK 5.0 中的新特性——范型(Generic
Type),这绝对是另外一个故事了。有兴趣的话,可以在 Internet 上搜索到很多关于范型的文章。
-Xlint:path
当发现不存在的路径或者目录时给出警告,比如标准选项中的类路径(classpath),源代码路径(sourcepath)等等。
-Xlint:serial
当在可序列化的类中没有发现 serialVersionUID 的定义时,给出警告。
Xlint:finally
当发现 finally 子句无法正常结束的情况时给出警告。比如下面这段代码:
try {
} catch (Exception e) {
} finally {
for (;;);
}
-Xlint:fallthrough
当在 switch 语句块中发现 fall-through 的情形时给出警告。这里所说的 fall-through 情形指的是在
switch语句块中,除了最后一个
case 之外的其它 case 中没有包含 break 语句,导致执行代码时从一个 case 直接穿过执行到了下一个 case 中。比如下面这段代码:
switch (color) {
case GREEN:
System.out.println("green");
// 没有 break 语句;fall-through
case RED:
System.out.println("red");
break;
case YELLOW:
System.out.println("yellow");
}
-Xlint:deprecation
显示关于使用了过时的 API 的详细信息。这个选项等同于一个我们熟悉的标准选项,即 -deprecation 选项。相对其它 lint
选项而言,该选项的特别之处在于,即使你关闭了它,编译器仍然会简单地提醒你某个类中使用了过时的 API。只是启用该项警告时,显示的信息将更详细而以。
上面提到的这些 lint 选项中的警告名称(冒号后面的部分),可以加以组合,从而有选择的开启或者关闭特定的一组 lint 警告选项,比如
-Xlint:deprecation,
finally 表示开启 deprecation 和 finally 警告。还可以在警告名称前加上"-"表示关闭该项警告,比如
-Xlint:all,-unchecked 表示开启除了 unchecked 之外的所有警告。
关于 Java 编译器命令的完整参考请见 javac - Java programming language
compiler<http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/javac.html>。
--
Stephen Suen
stephen.s...@gmail.com
http://spaces.msn.com/members/stephensuen
http://groups.google.com/group/programmercafe
本文来自CSDN博客,转载请标明出处:http://blog.csdn.net/lzhw1985/archive/2009/02/09/3870391.aspx
分享到:
相关推荐
Sonar 是一个用于代码质量管理的开源平台,用于管理源代码的质量,通 过 Eclipse 插件形式,可以支持包括 java, C#, C/C++, PL/SQL, Cobol, JS, Groovy 等等二十几种编程语言的代码质量管理与检测。
idea的工具插件,SonarLint,代码质量审查工具,文件下载后解压,用里面的SonarLint-3.5.1.2759.zip
Java 代码规范检查插件: 1.不遵循代码标准 sonar可以通过PMD,CheckStyle,Findbugs等等代码规则检测工具规范代码编写 2. 潜在的缺陷 sonar可以通过PMD,CheckStyle,Findbugs等等代码规则检测工具检测出潜在的缺陷 ...
它的灵感来自于出色的Java ESLint工具以及NPM的软件包中。 它可以帮助集中的构建工具团队在整个组织中轻轻地引入和维护标准的构建脚本样式。 入门 阅读。 要应用此插件,请从获取最新版本,并将以下内容添加到...
IDEA插件,Sonar是一个用于代码质量管理的开源平台,用于管理源代码的质量 通过插件形式,可以支持包括java,C#,C/C++,PL/SQL,Cobol,JavaScrip,Groovy等等二十几种编程语言的代码质量管理与检测 Sonar可以从以下七个...
Java 静态代码分析工具调研和引入,包括maven与findbugs、checkstyle、pmd。gradle与findbugs、checkstyle、pmd,lint。
它使用Java字节码工具来收集和报告每个检测器的性能统计信息,以用于从Gradle调用的Lint分析。 尽管原则上可以使用替代的检测代理,但是它依靠来执行字节码检测部分。 该工具参与了Android Studio 3.3发行版2倍级别...
yaml-lint 简单的Yaml检查工具。 yaml-lint只会尝试使用内置的Ruby yaml库加载YAML文件。 安装 gem install yaml-lint 用法 检查文件 yaml-lint filename.yaml 检查一个完整的文件夹 yaml-lint hiera/
java工具源码java-lint.pl 使用grep,sed,awk,perl等提取相关模式以在管道中进行进一步处理。
断言的美味轻量级工具包。 下载 从jcenter()获取它: testCompile " de.mannodermaus.lint:lintobox:0.1.2 " 用法 Lintobox为您提供了三个类,当它们一起使用时,将产生符合 Lint 预期的格式良好的输出,可用于...
2017年8月份的时候,我在公司开始推广Lint、FindBugs等静态代码检测工具。然后发现系统自带的Lint检测的Issue不满足我们团队内部的特定需求,因此去自定义了部分Lint规则。这个检测运行了大半年,运行良好,团队的...
Android lint工具是Android studio中集成的一个代码提示工具,它主要负责对你的代码进行优化提示,包括xml和java文件,很强大。编写完代码及时进行lint测试,会让我们的代码变得非常规范而且避免代码冗余。让我们...
Android Gradle Java多模块模板 这演示了在具有Android应用程序模块,Android库模块和Java模块的多模块构建中运行源分析工具(PMD,Findbugs,Checkstyle,Lint和Jacoco)。建立和运行该项目使用和Android Build构建...
#lint-graph强调Lint问题与文件之间关系的工具。 :construction: 该工具仍在开发中 :construction: ##动机是功能强大的工具。 它分析了各种开发工件,并报告了不良的编码习惯,约定缺陷等等。 它可以很好地集成到...
java恶意代码检测源码 前言 在团队Android项目开发过程中,难免会出现一些比较不容易发现,但是又比较低级的bug。而且因为每个开发人员的编码习惯不同,写出的代码也会有差异。为了保证团队开发中代码的规范以及尽量...
CURes.java清理资源文件,内置ADT SDK自带的Lint工具,相对路径为\ sdk \ tools \ lint.bat。 CUSrc.java用于清理.java文件,需要Eclipse插件配合。 使用 清除无用文件,需要交替运行CURes.java和CUSrc.java ,...
java建立类,并实现接口简单实例,实例中用了交通收费作为接口,交通工具有共同的方法,但有不同的实现过程,利用三个交通工具实现了这个接口
Lint、CheckStyle、Dry、FindBugs、PMD、警告、静态分析实用程序、静态分析收集器。 该插件会发布在您的构建中发现的问题的报告,因此您可以从主构建页面导航到摘要报告。 从那里您还可以深入了解细节: 新问题、...
Gradle静态分析插件 Gradle插件可在不同的Android,Java或Kotlin项目中轻松应用相同的静态分析工具设置。 支持因此使用此插件时,构建速度的开销为零!描述Gradle通过一组内置插件支持许多流行的静态分析...
使用checkstyle程序为Java命名约定和javadoc提供Lint输出 游戏结果统计 该工具在学生的座席和其他座席之间进行了四次(例如,一千次)“四通”游戏,并吐出类似以下内容的内容: Number of games played: 1000 # ...