BarTender与ASP.NET的集成小结

话说自从上次发了篇NHibernate的资料后，好久没有写东西了，半年来一直在忙一个项目，做完项目后，发现很多东西虽然当时做了，懂了，但是很快就会模糊了，于是又再想起总结的重要性~~没啥地方好放资料的，放在博客园也是一个不错的选择~~

 

本人也是新手，写的不好的地方，请多原谅。如果发现有什么错误，请指出，我会更改的，谢谢！

 

本文章做探讨交流只用，欢迎转载，转载请注明出处，谢谢！

 

BarTender是一款优秀的条形码打印软件，可以支持很多种类型的条形码设计和打印，具体大家可参考他的官网（http://www.seagullscientific.com/aspx/products.aspx），这里不多介绍。

本来在做SilverLight的东西的，后来项目有需求，说要在系统里加入条形码的设计和打印功能，PM提出两个方案，一个就是自己去开发一个条形码设计器，这样的好处就是跟系统的集成使用比较方便，但是开发这个设计器又是一个比较大的Task；另外一个方案就是使用客户原有的BarTender软件，把软件集成到系统中，那么设计部分还是交由BarTender去完成，我们的系统只需开发集成的部分就好。经过商量，大家决定了采取集成BarTender的方案，于是就要找人去做技术攻关了，跟原来的Partner商量了一下，他说想继续深入学习SilverLight，我就想去涉猎更多的东西，于是刚好，分道了~~

在刚开始接触BarTender的时候，发现网上的资料很少，我是把他们官网上的资料都看了，什么白皮书啊，向导之类的都看了。我们的系统是ASP.NET做的，通过一段时间的学习，知道了BarTender的几种集成模式。ActiveX COM集成，Commander的触发式集成，还有9.0版本后支持的.NET SDK的支持。简单说说这几个方式：

1、              ActiveX COM：BarTender在你的机器上安装好后，会在机器上注册一个COM，你在程序中可以调用这个COM，使用他提供的方法和属性，进行BarTender的程序级控制。这个集成方式比较实用，对BarTender的版本要求低，不过因为是基本的COM使用，所以要求你对COM的接口比较熟悉，对整个BarTender的调用流程和细节比较清晰，对于COM接口的描述，大家可以参考Automation.chm这个帮助文档（在Seagull\BarTender Suite\BarTender目录下）。

2、              Commander的触发式集成：简单来说，这个是通过配置BarTender，让他监视某个文件，当程序生成这个文件的时候，就会触发唤醒BarTender进行打印工作，这种方式我觉得不大好用，所以了解也不多，欢迎讨论交流。

3、              .NET SDK：这个是9.0版本开始支持的一个适用于.NET框架的SDK，里面提供了很多类来进行BarTender的控制，由于这个SDK也是用.NET编写的，所以对于用在.NET下的集成非常方便，不过由于对版本有要求，所以要考虑客户的成本来使用。

一、.NET SDK

我们的项目开始的时候是使用.NET SDK 的，因为那时都还没有搞清楚客户是需要在服务器打印还是客户端打印，老大就要求先开始研究了，这个很气人！做了许久才说客户要在客户端打印，把之前做的一切东西都推翻了~~

.NET SDK里面分开了两个，一个是标准的，一个是Server版的，标准的只是简单的开启BarTender进程去处理打印任务，所以当有多个任务同时打印的时候，就需要自己去管理任务队列问题；而Server版的就是里面有了任务队列机制，很方便的管理任务队列和BarTender的进程资源。但是Server版需要安装BarTender的Enterprise版才支持，ORZ~~什么都是钱~~

1、              SDK其实底层上也是对COM的调用，只不过封装了，让开发者更好操作，标准的SDK应该看帮助文档没什么问题，里面对各个类以及他们的方法和属性都做了详细的解释。下面给出一段代码，里面代表了最简单的典型使用：

　　　　　　　　首先添加引用，在.NET的TAB里面可以找到Seagull.BarTender.Print

　　　　　　　　然后，在程序里添加命名空间引用 “using Seagull.BarTender.Print;”

　　　　　　　　之后程序的简单使用如下：

 　　　　　　　　　　 //new an BarTender engine

　　　　　　　　　　Engine engine = new Engine(true);

　　　　　　　　　　//use the engine to open a format document to return a LabelFormatDocument object

　　　　　　　　　　LabelFormatDocument format = engine.Documents.Open("c:\\test.btw");

　　　　　　　　　　//use the LabelFormatDocument object to print

　　　　　　　　　　format.Print("Select printer", out messages);

　　　　　　　　　　　使用完成后记得回收相关资源。

　　2、              对于Server版的SDK，我在这里稍微的描述一下他的队列管理详细吧，不过单纯使用SDK是不需要知道这些东西的，使用上跟标准的SDK一样简单，只要参考帮助文档和Samples就可以很好明白了。写出他的队列管理详细仅供大家探讨~~大家看这一部分源码的时候，要先看一下线程的相关知识。

　　　　　　1） 程序流程核心是：把任务放进任务队列里，任务队列检测到有任务在排队的话，就把任务扔到引擎管理中，选择一个空闲的引擎来执行任务。

　　　　　　2） 管理任务队列主要是使用BtPool类，这个类里面的Consume函数不断地检测队列是否为空，如果不为空，则开始任务的提交工作，先通过engine.Status != TaskEngineStatus.Busy来检测空闲的Engine，然后通过engine.SubmitTask(this.m_masterTaskQueue)来提交任务到Engine里。

　　　　在SubmitTask函数里面，我们可以看到把扔进来的任务付给当前引擎对应的任务的句子：

　　　　　　this.m_task = tasks.Dequeue();

　　　　然后我们查看管理引擎的主要类TaskEngine，可以看到里面同样有一个Consume函数，他会不断检测当前引擎对应的任务是否为空，不为空则开始执行任务。

　　　　因此，当SubmitTask函数里通过this.m_task = tasks.Dequeue()把任务赋给了当前引擎的任务后，就会开始任务执行的Task.Run()方法。

　　　　在Task.Run()方法里，根据多态的特性，调用this.OnRun()的时候，是调用了PrintLabelFormatTask类的OnRun()方法。在PrintLabelFormatTask类的OnRun()方法里就实现了把任务发送到打印机或者打印成文件的工作。

　　　　　　BtPool管理任务队列和引擎池。TaskEngine对应的是一个引擎。TaskQueue为队列的相关操作的类。TaskEngines为TaskEngine的相关操作的类。

　　3、              大家可能看到网络浏览器的打印例子，里面写到了客户端的打印，这个客户端的打印其实也是在服务器上做，但服务器上做的只是把打印的结果输出为一个打印文件，然后把文件传送到客户端，客户端再通过JaveScript调用本地的打印机读取打印文件进行打印。这个要求服务器和客户端都装有同一个打印机驱动，而且客户端真正打印时使用的打印机驱动，要跟服务器上用来生成打印文件的打印机驱动一致。这里也有对这种方式的一些资料，仅供参考：

1）WebLabelPrint客户端打印

 //设定打印到文件

labelFormat.PrintSetup.PrintToFile = true;

//设定打印机

      labelFormat.PrintSetup.PrinterName = compatibleServerPrinter;

      //设定打印机的License

labelFormat.PrintSetup.PrintToFileLicense = Request.Form.Get(_listPrinters.PrintLicenseUniqueID);

      string tempFullPath = (string)Application["TempFolderFullPath"];

//设定打印文件的路径

           labelFormat.PrintSetup.PrintToFileName = System.IO.Path.Combine(tempFullPath,Guid.NewGuid().ToString() + ".prn");

2）设定好以上东西后，就像正常的服务器打印一样，把任务发送到任务队列，当打印完成的时候，调用函数TaskPrint_Succeeded，里面将printTask.PrintCode读取出来，然后把打印码发送到本地的打印机进行打印。

3）ClientPrinting.js： PrintList.aspx页面里用到GetClientPrinters函数，完成客户端打印的主要是BarTenderPrintClient.js和WebLabelPrintSample.js文件。

4）BarTenderPrintClient.js文件里主要包含了一些针对打印机的操作，如获得打印机列表，匹配服务器和客户端的打印机，获得打印机的License，还有就是把打印码发送到对应的打印机上。

 

        5）WebLabelPrintSample.js文件主要包含了将客户端打印机列表填充到DropDownList里（PrintListControl.ascx），将客户端打印机列表填充到Table里（Printers.aspx）。

二、ActiveX COM

         在我呕心沥血看了好久的SDK，把他的源码反编译出来慢慢研究了几个星期后，老大说要在客户端进行打印~~顿时内牛满面~~我跟老大说起上面的那种先生成打印文件，再发送到客户端的打印方式，老大说不行，最好少跟服务器进行通信，因为他们的网络环境不怎样~~郁闷了~~在Senior的提醒下，开始对ActiveX进行研究~~主要的思路是想通过做出一个ActiveX插件，然后进入页面的时候在客户端进行安装，然后对客户端机器上的BarTender进行控制~~既然是用ActiveX，那就使用BarTender提供的最简单的COM就行了~

               COM里面主要的就那么几个类，下面一一详细说明：

1）           Application类：实际上代表一个BarTender的进程，当你新建一个此类的对象的时候，就会出现一个新的BarTender进程。

2）           Format类：实际上代表一个格式标签（BTW文件），使用Application. Formats.Open()方法可以打开并返回一个Format对象。这个类里面包含了打印设置，标签的参数设置等一系列的设置，很重要的一个类。

3）           NamedSubString类：管理标签文件里所有SubString的类。

4）           DataBase类：管理标签文件里设置的所有数据库链接的类。

 

    5)      QueryPromts类：管理标签文件里面数据库查询参数的类。

 

         鉴于Format类是比较重要的类，这里再对他的相关属性和方法也做一下说明：

1） Print方法：这个就是最常用的打印方法，里面可设置打印的任务名，是否等待打印完成，等待超时时间，打印过程输出的信息。

2） PrintOut方法：如果你需要在打印时出现打印设置对话框和状态框，你可以选择这个方法来实现。

3） Save方法：保存对Format的更改。

4） SetNamedSubStringValue方法：设置某个特定的SubString的值，这里就可以作为一个动态改变打印内容的方法。

5） SetPromt方法：跟SetNamedSubStringValue方法类似，不过他设置的是打印提示的值，某些标签通过设置可以在打印的时候弹出对话框，输入某些变量的值来改变打印内容，这个方法就是动态设置这些变量的。不过在集成中比较少用。

6） IdenticalCopiesOfLabel属性：这个是设置打印时要打印多少份相同的标签的，默认为标签设置。

7） NumberSerializedLabels属性：这个是序列化打印时使用的，当你的标签启动了序列化后，这个属性代表的就是打印的份数，譬如你的序列化初始数据是1，增量为1，NumberSerializedLabels设置为5，那么就会打印出1、2、3、4、5，五个标签出来。

8） Printer属性：指定要使用的打印机，默认为系统指定的默认打印机。

 

9)     PrintToFile属性：标示是马上用打印机打印出实物，还是生成一个打印文件。

通过上面方法的解释，大家已经看到里面已经有几种动态控制打印内容的方式了，我在项目中使用了上面两种，一种是直接通过SetNamedSubStringValue方法去设置某些变量的值，然后进行打印，这个适合小量的打印，因为每次都要调用Application和Format对象来处理，所以打印100份就要调用一百次，效率低，但是可以灵活设置每次的打印内容；另外一种是使用序列化打印，这个的效率就高了，因为他是只调用一次把数据扔给BarTender，之后的都是BarTender根据序列化规则去生成打印内容，不过这个方式就欠缺灵活性，只适用于标签的内容是有一定的规律进行变化的大批量打印。

上面还提到了DataBase和QueryPromts类，这两个类是用在连接数据库的打印中的，这个是我用到的第三种动态控制打印内容的方法。主要思路是，在标签里设置好各项内容，这些内容都是对应数据库的某些字段，然后设置好查询条件，暴露一个或多个查询参数，然后在程序里通过QueryPromts类来设置这些查询参数来查询出不同的数据库内容，达到动态改变打印内容的目的。Format.Databases.QueryPrompts.GetQueryPrompt()可以特定的查询条件，然后通过设置Value属性来设置他的值，最后设置完所有查询条件后进行打印。

关于这几种动态控制打印内容的方法，都是要设计标签文件和程序相互配合的，比较不灵活，其实可以做成更好的动态配置方式的，不过老大说没必要，就放弃了。至于要是有朋友不了解标签文件的设计，我有时间会写一个文章来专门说标签文件的设计的。

三、集成

     有了上面的介绍后，大家对BarTender提供的集成信息有了一定的了解了。我是采用了ActiveX COM的方式，而且我的是客户端打印，于是我也做了个伪ActiveX插件，为什么叫“伪”呢？因为他不是传统意义上的ActiveX，而是用C#编写的（悔恨当年没学C++），所以叫“伪”。关于制作伪ActiveX，网上有很好的教程，我这里就给个链接算了（http://www.cnblogs.com/homer/archive/2005/01/04/86473.html）。

         在做好ActiveX并确定部署好后，在网页上调用ActiveX插件就需要用到JavaScript了，大家在部署ActiveX的网页上，会有下面这样一句代码：

        <object id="BTDPrintClient" classid="clsid:{0750A7B0-CF1E-4EAD-8C73-E0C8F6D9E890}" codebase="CAB/BarTender_AX.cab"></object>

       这里也提醒一下，第二个属性的名字是classid，然后里面设置的字符串的开头那几个是clsid，是不同的，我当时就在这里没注意，部署了好久都不行。

       回到JavaScript的调用上来，在调用时，主要就是下面的代码：

            printClient = new ActiveXObject("BTDPrintClient.PrintClient");

     这里应该很好理解，就是创建BTDPrintClient这个object对象里面的PrintClient对象。完成这一句后，printClient就等于是一个PrintClient的对象了，你可以在JavaScript里面调用PrintClient的各种方法属性了，于是就可以控制本地的BarTender了。 

 

四、小结

         做一个东西的集成，我觉得首先你是必须要去很了解这个要集成的软件，可以通过上网搜索资料，官方文档，最重要的还是软件自身的一些帮助文档和API文档，基本软件的信息都在里面了。而且这次做集成我还联系上了BarTender的亚太区这边的技术支持，也给我带来了不少帮助，虽然他们是要购买产品才能提供支持，但是初步的支持还是可以提供的，你只要跟他们说在用他们的试用版进行集成测试，看效果如何再决定要不要购买产品，哈哈~~引诱引诱~~

         还有在做一个新的东西的时候，还是建议多动手吧，做些小Demo来验证一下想法，认真调试一下追踪问题。不动手是没办法可以很好的理解一样东西的，所以，做IT，累死了~~什么时候上天砸些钱给我啊？烧香去~~~