IBM API Usage Scanner入门介绍

蕴涛

　　一、何谓API Usage Scanner： 　　 　　二进制兼容性和容忍性对于客户来讲是一些最大、最频繁经历的问题。在升级或者应用于他们应用程序运行的软件堆栈的一些部件时，二进制兼容性和容忍性的问题常常导致不可预知的破坏。导致这些破坏性的主导因素之一是在软件产品之间使用了为公布的内部API。因此，当一次升级或者服务被应用时，一些内部API发生了改变，从而破坏了对其依赖的软件产品，这样就破坏了客户的操作稳定性。为了维护并提高软件产品的稳定性，就应改消灭上述的脆弱依赖关系。 　　 　　API Usage Scanner（AUS）工具能够帮助我们快速定义内部API用法，以致兼容性问题能够被避免或者校正。AUS是一种纯JAVA工具，它能够扫描Java Bytecode中的API引用。从另一个角度来讲，AUS也能用于扫描某种软件产品，检测其对所依赖的另外一种软件产品的内部API使用情况。当软件产品的内部API用法被标记后，上文所讲的脆弱性依赖情况可以通过使用被更新后发布的API替换这些引起问题的内部API而被消除。如果当前没有一套有效的API被发布，则产品小组可以及时通知那些在两种产品之间对脆弱的接口进行扩展的API开发者，并且提出对保持API稳定性的要求，直至一套稳定的API替换之。一些IBM的旗舰产品已经这样实施，并且获得了很大的成功。 　　 　　同理，一个面向客户移植的服务小组也可使用AUS来发现在产品版本移植或者平台移植时所发生的破坏性。这些信息将帮助服务小组和他们的客户获得对项目范畴和风险更好的理解。 　　 　　二、AUS发行包构成： 　　 　　AUS发行包很简单，仅含有4项内容：一个可执行文件、一个信息中心、一个说明文件和一个简单的示例应用。 　　 　　三、AUS如何工作： 　　 　　在AUS使用时，我们须将一套编译后的Java class文件或者由class文件组成的JAR、WAR、EAR文件作为输入。具备了这套文件作为输入，还要配置好一套用于生成报告的扫描规则。报告可以两种XML、HTML格式产生。HTML报告有益于分析，XML报告则可以用于后期的扫描结果处理（例如，转换为其它格式的数据）。 　　 　　四、安装AUS： 　　 　　1。系统环境： 　　 　　Java version: Java Run-time Environment (JRE) 1.4 or above 　　 　　浏览器: 支持EMCAScript (JavaScript) and Cascading Stylesheets Level 2 (CSS2)。AUS目前已经与Internet Explorer 6.x, Mozilla Firefox 1.0.x, Opera 8.x进行了测试。 　　 　　2。安装步骤： 　　 　　1. 将下载的压缩包解压缩。 　　 　　2. 确认JAVA_HOME环境变量设置正确。 　　 　　3. 进入AUS安装后的bin目录，执行下列命令： 　　* On Windows®: 　　aus.bat -help (Windows) 　　* On Linux®: 　　./aus.sh -help (Linux) 　　如果见到help信息，则证明安装正确。 　　 　　五、运行AUS： 　　 　　AUS通过以下三种方式调用： 　　 　　* MS Windows batch file: bin/aus.bat 　　* Unix Bash script file: bin/aus.sh 　　* 使用java -jar命令执行lib/aus.jar文件 　　 　　详细的配置扫描规则，请看AUS的InfoCenter目录中的帮助文件"Rule Construction Guide" 。