Robot Framework自动化测试框架核心指南-如何使用Java编写自定义的RobotFramework Lib

时间 2020-05-23

标签 robot framework 自动化测试框架核心指南如何使用 java 编写自定义 robotframework lib 栏目测试自动化繁體版

原文原文链接

如何使用Java编写自定义的RobotFramework Libhtml

本文包括2个章节java

一、 Robot Frdamwork中如何调用java Lib库python

二、使用 java编写自定义的Libmysql

本文做者为：张永清，转载请注明出处，版权归做者全部。Robot Framework自动化测试框架核心指南-如何使用Java编写自定义的RobotFramework Libgit

一、 Robot Frdamwork中如何调用java Lib库github

咱们在前面介绍了，Robot Framework能够支持跨语言，那么对java确定也是能够支持的。sql

并且Robot Framework中，RIDE中自己也提供了对测试案例的两种执行方式，支持pybot和jybot两种执行方式，以下图所示。数据库

其中jybot 就是以java虚拟机的形式来执行测试案例，此种方式执行，执行的环境中，须要安装java jdk运行环境以及jython 安装包，jython是一个python语言在java中彻底实现，也就是说用java来实现了python语言的功能，jython中不只提供了python库，也支持java方法的执行。因此jython其实就是解决了Robot Framework中python 不支持直接调用java语言的问题。Jython 能够从http://www.jython.org/downloads.html 连接中进行下载，而后安装完成后，就能够在Robot Framework中进行使用，以下图所示。apache

咱们来看一个jython 语言来执行测试案例的例子。oracle

示例：这是一个将字符串所有转换成大写形式的例子，这个例子咱们用jython语言来执行。

${str} Set Variable aaBBccDDeeFF

${result} Convert To Uppercase ${str}

log ${result}

运行结果以下：

以下图所示，这里咱们选择了jybot 来进行执行，执行时，同pybot同样获得了咱们想要的运行结果。

其实在Robot Framework的官方网站中不少Library库都提供了java语言版本的实现，以下图所示。

这里咱们以咱们在第二章节中讲到的Database Library python库来做为示例，来看下这个库对应的java语言的实现以及如何来经过java语言的形式来进行调用。

咱们使用时，能够经过Robot Framework提供的maven插件robotframework-maven-plugin来直接引入

<dependency>
    <groupId>com.github.hi-fi</groupId>
    <artifactId>robotframework-dblibrary</artifactId>
    <version>3.1.1</version>
</dependency>

或者咱们将源码下载下来后，本身经过执行编译打包的方式来生成均可以。这里咱们选择直接用源码的形式进行编译，源码能够从https://github.com/Hi-Fi/robotframework-dblibrary上直接获取到。下载完成解压到本身须要的目录后，能够经过cmd命令行切入到对应的目录下，使用maven命令行进行编译，前提是须要在本身的环境中事先安装好maven的编译环境，编译打包时执行mvn clean install -Dmaven.test.skip=true 便可以生成咱们想要的java语言实现的Library库，以下图所示。

打包完成后，再生成的target目录中，就能够获取到编译好的java语言实现的Library，以下图所示。

将编译生成好的robotframework-dblibrary-3.2-SNAPSHOT.jar包和mysql的Driver驱动包一块儿加入到运行环境的CLASSPATH下面，而后在测试案例集中引入DatabaseLibrary库，以下图所示。

引入后，咱们就能够正常使用jython的方式来调用java语言版本的DatabaseLibrary库了，以下图所示。

使用java语言版本的DatabaseLibrary库中的关键字时，和使用python语言版本的DatabaseLibrary库中的部分关键字的传参有些不同。Java语言版本的DatabaseLibrary链接数据库时，是经过jdbc的方式来进行连接，这里咱们列举了java语言版本的DatabaseLibrary库连接一些经常使用数据库的示例，以下表所示。Java语言版本的Connect To Database关键字接收 [数据库driver类|jdbc连接地址|数据库用户名|数据库密码| alias=default ]五个参数，alias若是不传入的话，默认为取名为default。

Connect To Database	com.mysql.jdbc.Driver	jdbc:mysql://localhost:3306/world	root	root	链接mysql数据库
Connect To Database	oracle.jdbc.driver.OracleDriver	jdbc:oracle:thin:@servername:port:dbname	system	12345678	链接oracle数据库
Connect To Database	org.h2.Driver	jdbc:h2:mem:robotframeworkt;DB_CLOSE_DELAY=-1	sa	sa	链接h2数据库库

这里咱们看一个java语言实现的DatabaseLibrary库的源码的片断，让你们能够了解下，java语言版本中是如何实现和封装关键字的，这是Connect To Database关键字的实现方法，

咱们能够看到是经过在方法上加java注解的方式来实现的，@RobotKeyword和@ArgumentNames注解均来自javalib-core库，咱们本身在开发时，能够经过maven依赖的方式引入。

<dependency>

   <groupId>org.robotframework</groupId>

   <artifactId>javalib-core</artifactId>

   <version>1.2.1</version>

</dependency>

DatabaseLibrary库的源码片断：

@RobotKeyword("Establish the connection to the database. This is mandatory before any of"

      + "the other keywords can be used and should be ideally done during the "

      + "suite setup phase. To avoid problems ensure to close the connection again "

      + "using the disconnect-keyword.\n\n"

      + "It must be ensured that the JAR-file containing the given driver can be "

      + "found from the CLASSPATH when starting robot. Furthermore it must be "

      + "noted that the connection string is database-specific and must be valid of course.\n\n"

      + "If alias is given, connection can be later referred with that. If alias was in use, existing connection "

      + "is replaced with new one\n\n" + "" + "Example: \n"

      + "| Connect To Database | com.mysql.jdbc.Driver | jdbc:mysql://my.host.name/myinstance | UserName | ThePassword | default |") @ArgumentNames({ "Driver class name", "Connection string", "Database username", "Database password","Database alias=default" }) public void connectToDatabase(String driverClassName, String connectString, String dbUser, String dbPassword, String... aliasParam) throws SQLException, InstantiationException, IllegalAccessException, ClassNotFoundException { String alias = aliasParam.length > 0 ? aliasParam[0] : defaultAlias; Class.forName(driverClassName).newInstance(); setConnection(DriverManager.getConnection(connectString, dbUser, dbPassword), alias); }

除了经过jython语言来调用java的Library外，咱们还能够经过Remote的方式来实现调用Java语言实现的Library库。从https://github.com/ombre42/jrobotremoteserver 连接中，能够获取到用java语言来实现的远程接口服务，以下图所示。

咱们不建议在实际工做中，过多的使用的jython的方式来调用java语言实现的Library，由于每一个测试案例在执行时，都须要一个启动jvm虚拟机的过程，执行会比使用python语言的方式执行耗时更长，并且兼容性并非十分好，推荐使用Remote的方式来调用Java语言实现的Library库。

二、使用 java编写自定义的Lib

本文做者为：张永清，转载请注明出处，版权归做者全部。Robot Framework自动化测试框架核心指南-如何使用Java编写自定义的RobotFramework Lib

前面咱们已经讲了如何调用java语言编写的Lib库，这一节中，咱们来介绍下如何使用java语言编写自定义的Lib库。

要使用java编写自定义Lib库，咱们首先须要构建一个java的开发工程，这里咱们以构建一个java的maven项目为例。在构建的maven工程的的pom.xml文件中，咱们须要引入以下必要依赖。

<dependency>

   <groupId>org.robotframework</groupId>

   <artifactId>javalib-core</artifactId>

   <version>0.9.1</version>

</dependency>

这个是必须引入的依赖包，做用是提供了建立RobotFramework的关键字的注解等功能，方便咱们快速的去建立一个Lib库以及对应的关键字。

<dependency>

   <groupId>com.github.ombre42</groupId>

   <artifactId>jrobotremoteserver</artifactId>

   <version>2.0-BETA</version>

</dependency>

这个是Remote Server的依赖包，做用是能够启动一个RobotFramework的远程调用接口服务，而后RIDE中经过Remote的方式就能够链接到该远程调用服务上，若是不使用远程调用服务的话，能够不引入该依赖包。

<plugin>

      <groupId>com.googlecode.robotframework-maven-plugin</groupId>

      <artifactId>robotframework-maven-plugin</artifactId>

      <version>1.1.1</version>

      <executions>

         <execution>

            <phase>test</phase>

            <goals>

               <goal>run</goal>

            </goals>

         </execution>

      </executions>

      <configuration>

         <variables>

            <variable>BUILDING:True</variable>

         </variables>

      </configuration>

   </plugin>

</plugins>

这个是RobotFramework提供的maven插件，这个不是一个必须的maven工程依赖，该插件的做用在于能够模拟咱们的RIDE同样来执行测试案例，在使用maven编译打包时，能够同时来执行RobotFramework的测试案例。经过以下的方式来指定测试案例的位置。

<testResources>

   <testResource>

      <directory>src/test/resources</directory>

      <filtering>true</filtering>

   </testResource>

</testResources>

在maven工程构建好了后，咱们就能够来编写自定义的Lib库了，下表中描述了使用java语言来编写自定义Lib时，一些经常使用的java注解。

注解名称	使用描述
@RobotKeywords	该注解通常用于java类的头部，用来标注该java类提供的是一个RobotFramework关键字类。
@RobotKeyword	该注解和@RobotKeywords注解须要一块儿配合使用，@RobotKeyword注解通常用于java中的某个具体方法的头部，用来标注该方法提供的是一个RobotFramework关键字。能够经过@RobotKeyword后面加括号的方式来讲明该关键字的用途，好比@RobotKeyword("这是一个示例关键字")
@ArgumentNames	该注解须要和@RobotKeyword注解一块儿使用，该注解用于标注一个RobotFramework关键字须要传入的参数，使用示例： @ArgumentNames({"elementString"})

代码示例：咱们这里用java的方式来实现RobotFramework 中的Sting Lib库(以下图所示)中的部分关键字Convert To Lowercase和Convert To Uppercase。

package com.example.keywords; import org.robotframework.javalib.annotation.ArgumentNames; import org.robotframework.javalib.annotation.RobotKeyword; import org.robotframework.javalib.annotation.RobotKeywords; @RobotKeywords public class StringKeyWord { @RobotKeyword("Convert To Lowercase") @ArgumentNames({"string"}) public String convertToLowercase(String string) { System.out.print("Convert "+string+" To Lowercase"); return string.toLowerCase(); } @RobotKeyword("Convert To Uppercase") @ArgumentNames({"string"}) public String convertToUppercase(String string){ System.out.print("Convert "+string+" To Uppercase"); return string.toUpperCase(); } } 关键字编写完了后，咱们还须要定义一个Library库，经过继承AnnotationLibrary这个类， 而且这里咱们经过RemoteServer的方式来启动。 package com.example; import java.io.IOException; import java.io.InputStream; import java.io.StringWriter; import java.nio.charset.Charset; import org.apache.commons.io.IOUtils; import org.robotframework.javalib.library.AnnotationLibrary; import org.robotframework.remoteserver.RemoteServer; public class MyRemoteLibrary extends AnnotationLibrary { public MyRemoteLibrary() { // 关键字类的路径

        super("com/example/keywords/*.class"); } @Override public String getKeywordDocumentation(String keywordName) { if (keywordName.equals("__intro__")) return getIntro(); return super.getKeywordDocumentation(keywordName); } /** * 远程接口服务的启动 * @param args * @throws Exception */

    public static void main(String[] args) throws Exception { RemoteServer.configureLogging(); RemoteServer server = new RemoteServer(); //向server中加入自定义的library，而且设置远程接口服务的端口
 server.addLibrary(MyRemoteLibrary.class, 8270); server.start(); } /** * 定义Library的说明信息 * @return

     */

    private String getIntro() { try { InputStream introStream = MyRemoteLibrary.class.getResourceAsStream("__intro__.txt"); StringWriter writer = new StringWriter(); IOUtils.copy(introStream, writer, Charset.defaultCharset()); return writer.toString(); } catch (Exception e) { throw new RuntimeException(e); } } }

定义完Library后，咱们就能够以RemoteServer的方式来启动咱们的远程接口服务，以下图中所示

在RIDE中，咱们经过Remote 链接到咱们启动的远程接口服务中，以下图所示。

而后经过F5快捷键，就能够看到咱们远程服务中定义的关键字了，以下图所示。

示例：咱们经过一个示例来调用一下咱们远程接口服务中定义的关键字，以下图所示。

运行结果以下：

Starting test: RobotFrameworkTest1.TestSuite11.TestCase001

20180822 10:04:23.328 : INFO : Convert robotFramework To Lowercase

20180822 10:04:23.328 : INFO : ${strLowercase } = robotframework

20180822 10:04:23.330 : INFO : robotframework

20180822 10:04:23.337 : INFO : Convert robotframework To Uppercase

20180822 10:04:23.338 : INFO : ${strUppercase } = ROBOTFRAMEWORK

20180822 10:04:23.340 : INFO : ROBOTFRAMEWORK

Ending test: RobotFrameworkTest1.TestSuite11.TestCase001

从运行结果看，能够成功调用到咱们远程接口服务中自定义编写的两个关键字。

上面咱们是经过RemoteServer的方式来调用java编写的自定义的关键字，咱们也能够改用jybot的方式来调用java编写的自定义关键字，在工程中，咱们引入maven-assembly-plugin这个插件，这个插件能够经过执行mvn clean assembly:assembly -Dmaven.test.skip=true 打包时，将全部相关的依赖包打包在一个jar包中，方便咱们在执行时，不须要手动一个个去配置执行时须要依赖的其它相关jar包。

<properties>
<!--  定义打包时的字符集格式 -->

   <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

   <testLibraryClass>MyRemoteLibrary</testLibraryClass>

</properties>
 

<plugin>

   <artifactId>maven-assembly-plugin</artifactId>

   <configuration>

      <descriptorRefs>

         <descriptorRef>jar-with-dependencies</descriptorRef>

      </descriptorRefs>

      <archive>

         <manifest>
          <!--  配置执行时的java main方法 -->

            <mainClass>${testLibraryClass}</mainClass>

         </manifest>

      </archive>

   </configuration>

   <executions>

      <execution>

         <id>make-my-jar-with-dependencies</id>

         <phase>package</phase>

         <goals>

            <goal>single</goal>

         </goals>

      </execution>

   </executions>

</plugin>

另外须要注意是，咱们须要将咱们上面定义的MyRemoteLibrary这个类移动到咱们maven工程的根目录下，以下图所示。

执行mvn clean assembly:assembly -Dmaven.test.skip=true打包后，就能够生成咱们须要的jar包了，以下图所示。

将MyRemoteLibrary-1.0-jar-with-dependencies.jar 放置到java的classpath目录下后，咱们就能够在RIDE中引入MyRemoteLibrary库了，以下图所示。

引入后，咱们再用jybot的方式执行上面RemoteServer运行时的一样示例，以下图所示。

运行结果以下：以下图所示。

能够看到，运行后获得了一样的结果。

备注：本文内容摘选自做者本身出版的Robot Framework自动化测试框架核心指南一书。

关于自动化测试的更多内容，请关注：

Robot Framework自动化测试框架核心指南京东官方购买
 Robot Framework自动化测试框架核心指南电子版试读
 Robot Framework自动化测试框架核心指南天猫官方旗舰店购买
 Robot Framework自动化测试框架核心指南当当网购买
 Robot Framework自动化测试框架核心指南做者签名版本购买

RobotFramework自动化测试框架-Selenium Web自动化(二)关于在RobotFramework中如何使用Selenium很全的总结（上）

RobotFramework自动化测试框架-MongoDBLibrary库的使用

原文出处：https://www.cnblogs.com/laoqing/p/12341442.html