摘要: 1.SoapUI default script library 2.Custom script library

Background:

做API自动化的时候，往往需要针对每个API编写很多方法，这个时候为了使代码有更高的可读性，维护性和扩展性，我们需要把这很多方法编写成外部的Groovy Script，然后向引用java class一样的方式在TestStep中引用，这个时候就需要用到SoapUI的Script Library功能。

1.在SoapUI的File->Preferences->Ready!API 可以设置SoapUI的默认脚本路径和自定义脚本路径：

2.SoapUI default script library

My path is : C:\Program Files\SmartBear\ReadyAPI-1.6.0\bin\scripts

其中“C:\Program Files\SmartBear\ReadyAPI-1.6.0”是SoapUI的安装目录，因为我本地用的是SoapUI Professional Version, 所以名字是ReadyAPI。

如上图所示，我有两个文件夹，一个是用于产品自动化测试的代码，一个是用于我自己测试的代码，在Groovy Script中调用的时候用package语句区别,即：如果想调用direct文件里面存放的某些groovy脚本，就在“Groovy Script” type的test step第一句加入：package direct。

具体调用如下：

3.Custom script library

在第一步中，我将该目录设置成custom script library,现在我在该目录下新建了一个Callee.groovy:

调用方法如下：

4.SoapUI在script library里查询调用的groovy文件的先后顺序：

因为在Setting中增加了两个Script library，如果这两个library中有同样名称的groovy文件，系统会优先调用哪一个目录下的文件呢?

为了得出结果，我在custom script library中增加了一个文件：Callee2.groovy：

在default script library中同样有这个名字的一个groovy文件哦，现在我这样调用groovy文件：

根据输出结果可以看出：

a.系统将优先从custom script library中查询调用的类Callee2，如果找不到，才会去default script library中查找该类。

b.如果要调用default script library中的类，需要加入package语句。

(正如在Java Build Path folder下新建了一个package "com.vicky.test", 然后在这个package中添加了一个Test.groovy，那么打开这个groovy文件，文件头部自动回加入 “package com.vicky.test“ 一样的道理）

以上是更改本地整个SoapUI tool的script library，但有时候我们并不需要修改该路径，只是想给这个Project一个特殊的脚本库，该脚本只适用于这一个单独的Project。

例如：我们将一个Project部署到Jenkins上面，然后Server上的Script Library并不需要修改，我们只需要将这个特殊的脚本库放到该Project代码中即可，这时候需要用到Project level的”Project Properties“-》"Script Library".

将Script Library的值设为该Project的当前工作目录”${projectDir}"，然后在Groovy script中加入package语句即可。

若这些脚本库放在工作目录的"ScriptLibrary"文件夹，那么在调用该文件夹下面的groovy scripts的时候，只需要加入：

package ScriptLibrary

若调用了该ScriptLibrary中的groovy文件后，报错"Reference to one class is ambiguous", 请参考另一篇文章：https://my.oschina.net/u/942203/blog/916833

若是这些Groovy Script需要引用java的一些jar包，需要把这些jar包先在网上下载下来，然后放到“SoapUI安装目录\lib”或者“SoapUI安装目录\bin\ext”文件夹下面。