【仅供内部供应商使用,不提供对外解答和培训】
...
关于@Open注解,可以查看链接:3种插件中较为稳定的接口说明【稿】3种插件中较为稳定的接口说明
其中 ScriptPath script(); 与 StylePath style(); 方法均为废弃接口。仅仅用于兼容保留,开发者在开发的过程中切勿使用!
...
这四种方法除了提供缺省构建以外,功能完全相同。需要单独介绍的是FileType和ParserType这两个枚举类型的入参的含义。
枚举值 | 说明 |
---|---|
FileType.PLAIN | 文件类型是纯文本类型,读取时直接当作字符串读取进来。绝大部分时候,在插件开发过程中使用的都是这个类型。并且文件类型为PLAIN时,参数path的含义就是脚本文件的包内路径(比如com/fr/plugin/js/main.js) |
FileType.CLASS | 文件的类型为calss类型,读取时以class文件进行读取,且该class必须实现com.fr.gen.TextGenerator接口,通过接口返回js的字符串脚本。在插件中很少有场景会使用到,举例的话比如产品中生成国际化的前端数据的时候,就会用到这个类型。并且文件类型为CLASS时,参数path的含义就是生成脚本字符串的class名(比如com.fr.plugin.js.JsMaker) |
根据FileType读取到的字符串,并不一定是最终的JS数据,其中可以使用 ${FineReport的公式/部分系统环境参数} 这样的表达式来进行脚本的动态生成。比如一些链接什么的。所以在转换成最终JS脚本时,提供了两种解析的方法声明。
开发者需要根据开始时的具体场景需要来选择,能不使用公式解析就不要使用,以节省资源的开销。
枚举值 | 说明 |
---|---|
ParserType.PLAIN | 解析是什么都不做,读取到的文本是什么,就把这段文本当作是最终的JS脚本。 |
ParserType.DYNAMIC | 解析的时候,会对读取到的文本中${}包含的部分进行动态计算得到最终的JS脚本。 |
StylePath style(RequestClient req) 方法是与ScriptPath script(RequestClient req) 相对应的获取样式文件声明的接口,其构造与ScriptPath一致。差异仅仅是ScriptPath生成的最终是JS脚本,而StylePath生成的最终是样式文件。相关参数含义不再赘述。
...