1. 必须遵循的命名规则
1)不能以数字、$ 符号开头。
2)变量名只能是字母 (26个字母大小写都可)、数字 (0-9)、下划线(_)、(@) 或中文的组合,并且之间不能包含空格。
3)变量名中不能含有 ? * . - +/等字符和空格(如 ab--cd 这种格式)。
4)变量名建议不要使用编程语言的保留字,比如 true、false 等保留字。
5)变量名建议不要使用系统参数名称,否则会因为优先级调用系统参数,而非用户定义的参数,另外还可能存在引发系统参数紊乱的风险。系统参数内容可查看:系统参数
6)参数名称建议不要过长,过长可能会超过浏览器 url 长度限制导致预览出现问题。
2. 经典命名规则
1)匈牙利命名法
该命名法是在每个变量名的前面加上若干表示数据类型的字符。基本原则是:变量名=属性+类型+对象描述。如i表示 int,所有i开头的变量名都表示 int 类型。s 表示 String,所有变量名以s开头的都表示 String 类型变量。
2)骆驼命名法
正如它的名称所表示的那样,是指混合使用大小写字母来构成变量和函数的名字。驼峰命名法跟帕斯卡命名法相似,只是首字母为小写,如 userName。因为看上去像驼峰,因此而得名。
3)帕斯卡命名法,即 pascal 命名法
做法是首字母大写,如 UserName。
3. 同名参数优先级
FineReport 有多种类型的参数,分别有不同的使用场景,详情可查看 :参数的种类与区别
用户在命名时,不同类型的参数不要使用同一名称。当模板中有重名参数时,将会按优先级顺序加载调用。参数加载的优先级顺序可参考:参数优先级
4. 注意事项
1)参数值的引用格式为参数前面加 $ 符号,如$adce。
2)超级链接传递参数时,参数名称长度上限为20位,例如:参数名为地区,其长度为2位;参数名为ID,其长度为2位。