（二） robot framework - variable file

一，文件中创建variable的两种方式
1） 直接创建：
例子：
VARIABLE = "An example string" = ${VARIABLE}
INTEGER = 42 = ${INTEGER}
STRINGS = ["one", "two", "kolme", "four"] = ${STRINGS}
全是scalar类型的variable， 要创建List类型的variable就需要以LIST__ (注意双下划线)开头来命名variable：
LIST__STRINGS = ["list", "of", "strings"] = @{STRINGS}

还支持创建对象类型的variable，如：
MAPPING = {'one': 1, 'two': 2} -- 创建dictionary variable = ${MAPPING}
class MyObject: --创建一个类
def __init__(self, name):
self.name = name
OBJ1 = MyObject('John')
OBJ2 = MyObject('Jane') -创建2个类的对象


此外，还可以动态创建variable：
RANDOM_INT = random.randint(0, 10)；
if time.localtime()[3] > 12:
AFTERNOON = True
else:
AFTERNOON = False

注1： 通常全局的大写，非全局的小写；
注2： 以下划线_开头的属性不被识别为variable；
注3： 在variable文件中提到的所有不以下划线开头的属性都被认为是variable，可以使用添加下划线的方式来过滤它们， 也可以使用__all__ （双下滑）来将要定义为variable的加进去，如：__all__ = ['AREA1', 'AREA2']，那么只有area1和area2被认为是variable；

2） 从方法或函数中获得返回值的方式 get_variables(),存储结构是python的dictionary 或 java的map;如下例子和1）中的第一个例子效果一样：
def get_variables():
variables = { "VARIABLE": "An example string",
"INTEGER": 42,
"STRINGS": ["one", "two", "kolme", "four"],
"LIST__STRINGS": ["list", "of", "strings"]
}
return variables

java实现版本：
public Map getVariables() {
HashMap variables = new HashMap();
variables.put("VARIABLE", "An example string");
variables.put("INTEGER", 42);
variables.put("STRINGS", ["one", "two", "kolme", "four"]);
variables.put("LIST__STRINGS",["list", "of", "strings"]);
return variables;
}

此外，get_variables()也可以接受参数，通常可以用来进行选择导入哪个variable file或者variable value，如下：
variables1 = { 'a': 'Scalar variable',
'LIST__a': ['List','variable'] }
variables2 = { 'a' : 'Some other value',
'LIST__a': ['Some','other','value'],
'extra': 'variables1 does not have this at all' }

def get_variables(arg):
if arg == 'one':
return variables1
else:
return variables2


二，一些规则
- 当找不到导入的variable文件时，会去python PATH下面找；
- 如果多个引入的variable文件中含有相同的变量名，那么最早的那个将被采用；
- cmd下设置的变量将覆盖文件中的同名variable；
- cmd上导入variable文件：
（--variablefile myvariables.py
--variablefile path/variables.py
--variablefile /absolute/path/common.py
--variablefile taking_arguments.py:arg1:arg2）
此时的variable scope是全局的；

三， 采用java class和python class 来实现 variable files:
一些rules：
1） Python class的名字必须和module的名字相同；
2） java class必须处于默认包中；
3） java class的路径必须以.java或.class结尾，并且两种文件都要存在；

例子-1：创建类属性 $｛VARIABLE｝，@{LIST} 和对象属性 ${ANOTHER VARIABLE}
class StaticPythonExample(object): --python版本
variable = 'value'
LIST__list = [1, 2, 3]
_not_variable = 'starts with an underscore'

def __init__(self):
self.another_variable = 'another value'

public class StaticJavaExample { -------java版本
public static String variable = "value";
public static String[] LIST__list = {1, 2, 3};
private String notVariable = "is private";
public String anotherVariable;

public StaticJavaExample() {
anotherVariable = "another value";
}
}

例子-2：
class DynamicPythonExample(object): --python

def get_variables(self, *args):
return {'dynamic variable': ' '.join(args)}

import java.util.Map;
import java.util.HashMap;

public class DynamicJavaExample { -java

public Map<String, String> getVariables(String arg1, String arg2) {
HashMap<String, String> variables = new HashMap<String, String>();
variables.put("dynamic variable", arg1 + " " + arg2);
return variables;
}
}