<菜鸟反攻战>第二章--硕正插件

              硕正轻量级富web应用套件应用比较广泛，之前公司做项目要是使用，但是在网上发现基本没有关于该插件应用的文章，于是自己看着官方文档最终还是做出来了，官方文档比较详细了，不过在使用过程中还是出现了一些问题，做一下总结记录，防止以后忘记，同时希望可以帮助需要的人。

            硕正插件的简介可以查看官方文档，说的很详细，其实硕正插件就相当于为开发人员提供的一套用于操作页面的辅助性插件，可以实现数列表、自由表头、报表、打印、统计图等一系列的功能，而且使用方便。

       因为硕正插件功能比较强大，我在使用的过程中主要使用的是报表功能，下面就报表的打印功能来讲述，基本功能类似，我使用的项目是SSM框架，遵循MVC开发框架，界面使用的是jsp开发。

    一、使用方法

   1、过程

    （1）创建数据集

    （2）利用硕正插件设计打印模板

    （3）在界面引入硕正插件，并关联相关功能

  2、特别说明（注意事项）

     因为在使用中出现一些比较容易出现的坑，记录一下：

    （1）在界面如果要使用硕正插件，必须使用<script>将相关的js文件包含进来（文件可以在官网下载），导入时要将整个binary文件包含进去，里面主要的文件是dynaload.js，里面包含注册组件的函数，其他文件功能可以查看官网，主要是兼容和配置文件；

    （2）界面要使用<script></script>插入硕正插件

       <script>insertReport("AF",'')</script>

         其中AF是插件的id，在后面可以用id调用功能

   （3）引入的插件会嵌入页面，不能使用hidden进行隐藏，隐藏之后该插件将会销毁，所有的硕正功能将会失效，官网文档有一种方法，但是我使用的是设置插件的width 和 height的大小为1px ， 不能设置为0px ，设置为0就相当于隐藏。

   （4）硕正插件在谷歌和火狐有版本限制，详情查看官网。

   二、具体功能说明   

   1、创建数据集

   将数据库中数据对应的实体类写入xml文件中，每一个实体类属性对应一个标签，在开头添加

    <?xml version='1.0' encoding='UTF-8'?>
     <DataRoot>

   

   2、设计打印模板

    在硕正插件上面创建一个新的文件，同时创建一个新的临时数据源（中心数据源也可），然后根据自己的需求创建一个模板，并将数据源拖入模板中（具体的步骤可以查看官网的   附件：临时数据源），创建好的模板为xml文件

  

   3、将模板文件整合到jsp界面

    在jsp界面，利用<script>引入js语句，通过硕正的初始化函数将模板文件引入界面

<script>  function OnReady( id ) {  //页面自动调用        AF.func('Build', 'index.XML');     } </script> 

    其中AF为引入插件时的id，func表示函数，函数名为Build,index.xml是函数的参数，表示的就是上面创建的模板文件的路径，OnReady函数是预处理函数，当插件创建实例后就会调用该函数将模板文件加载进入界面

  4、从后台获取数据集填充模板数据

     我使用的系统是SSM框架，通过URL访问后台获取数据

      

function click(){   //当点击打印时调用的函数    AF.func("SetSource","ds1 \r\n url");     //获取数据集    AF.func('Calc', '');    AF.func("CallFunc", "105\r\n60");}

   SetSource函数：ds1参数表示的模板中数据集的标号，创建临时数据源时设置的

                              url参数表示的是从后台获取数据集的连接，此处获取的数据集应该为json格式数据，在后台要使用                                       @ResponseBody注释方法，否则返回的是jsp界面，获取不到数据集

  Calc函数：执行函数，在这里是将获得的数据集填充进入模板中，注意：如果是临时数据源，要先获取模板文件，                       再获取数据集，然后执行数据填充函数，中心数据源相反，先获取数据源，在获取模板函数，然后执行                        数据填充函数

CallFunc函数：执行功能函数，参数1的11表示的是工具栏中各功能对应的功能号，11对应的是打印，参数2根据参数                      1定（目前我还不知道什么功能）

                 

  执行完上面的内容，点击按钮，关联click函数，就会调用打印机进行打印，可以通过更换CallFunc函数的第一个参数来实现不同的功能.

    

  以上内容是本人在项目中使用的方法，菜鸟新手，努力加油！！！