讨论创建基于WSE的报表打印服务及其实现

摘要：
看过卢彦先生的关于WEB报表打印实现文章的人，一定会为里面所提供的解决方案击节叫好，本文试图给大家展现一个更灵活的打印作业流水，并具有一定的实用性。建议大家在阅读本文之前先阅读卢彦先生的两篇文章，同时本文采用了微软的WSE（1.0）作为辅助工具，对此感到陌生的朋友，建议先参考一些概念性的文章，我在文章的最后列了一些参考资料和所需工具，大家可自行体会。

--------------------------------------------------------------------------------

目录
引言
软件原理
程序实现
注意事项
总结
参考资料

--------------------------------------------------------------------------------

引言：
WSE提供了一个非常方便的功能，就是支持附件的传输，尽管我们可以采用别的方式来达到这个目的，比如直接的返回byte型的数据，但是对于大多数应用而言，直接返回一个附件，如一张图片更为实在些，请大家不要误会我文章的标题，以为创建一个WEBSERVICE就可以方便地实现了打印了，我们的软件原理和最终打印的方式跟卢彦先生里提到的并无多大区别，我们只是利用了WebService的强大的穿透性，来使这个方式更为灵活，更易于应用和拓展，本文所采用的代码全部用C#编写。

--------------------------------------------------------------------------------

软件原理：
本文采用了XML形式的数据，客户端将需要打印的数据和一些基本的参数，如图象大小，图象形式等传送给服务器端，而服务器端则根据客户端的要求生成特定的一张或多张图片返回给客户端，由客户端的打印程序统一处理，看了这个逻辑我们就可以发现：所有的业务规则完全在服务器端运做，而客户端只需要少量的代码就可以实现报表的打印。这样就避免了各种升级所带来的烦恼，当实际运用中要求增加一种或多种图表的时候，我们所需要做的只是增加或者修改服务器端的业务规则，而客户所要做的只是告诉我们要打印这种图表就可以了。
本文采用了一些简单的XML数据，仅供示范用，客户端的Demo数据如下：
<?xml version="1.0" encoding="utf-8"?>
<Root PrintType="line" Width="450" Height="500" Title="Print Demo">
<Child Text="1" Value="100" Color="Black">
</Child>
<Child Text="2" Value="60" Color="Orange">
</Child>
<Child Text="3" Value="30" Color="Red">
</Child>
<Child Text="4" Value="40" Color="Gray">
</Child>
<Child Text="5" Value="90" Color="Blue">
</Child>
<Child Text="6" Value="60" Color="Green">
</Child>
</Root>

其中PrintType就是客户端要求的打印类型。
程序实现：
服务器端代码
本系统也同样采用了Abstract Factory的设计模式，以利于服务器端方便的扩展，此处就不再赘述。
新建一个Web服务项目，添加抽象基类，实现类，解析类，建成后的界面如下所示：
需要加入对Microsoft.Web.Services命名空间的引用


其中
PrintBase.cs是基类
Parser.cs是解析类
LinePrint.cs是实现具体图象的类
基类代码：
public class PrintBase
{
public PrintBase()
{
//
// TODO: 在此处添加构造函数逻辑
//
}

public virtual Stream DrawImage()
{
return null;
}
}

解析类代码：
public class Parser
{
public Parser()
{
//
// TODO: 在此处添加构造函数逻辑
//
}

public static PrintBase CreateElement(DataSet ds)
{
PrintBase pb = null;

string l_strPrintType = ds.Tables["Root"].Rows[0]["PrintType"].ToString();

switch(l_strPrintType)
{
case "line":
pb = new LinePrint(ds);
break;
default:
pb = new PrintBase();
break;
}
return pb;
}

}

实现类的代码：
由于此处代码较长，我只贴出部分代码供参考，大家可以根据自己的实际情况进行图形的绘制。
/// <summary>
/// 重载画的规则
/// </summary>
/// <returns>图象Stream</returns>
public override Stream DrawImage()
{
_ChartSize = new SizeF(float.Parse(ds.Tables["Root"].Rows[0]["Width"].ToString()),
float.Parse(ds.Tables["Root"].Rows[0]["Height"].ToString()));

Bitmap b = new Bitmap((int)_ChartSize.Width,(int)_ChartSize.Height,
PixelFormat.Format32bppArgb);

//初始化
_Graphics = Graphics.FromImage(b);

//以下省略，请自行绘制

//存储返回
MemoryStream s = new MemoryStream();
b.Save(s,ImageFormat.Png);
return s;
}

我个人一直比较喜欢用DataSet操作小型的XML数据，大家请按自己喜好调整，此处展示的方法将直接供Web服务类调用。
Web服务类的代码：
[WebMethod]
public bool CreateImage(DataSet ds)
{
bool l_bStatus = true;

try
{
PrintBase pb = null;

pb = Parser.CreateElement(ds);

Stream s = pb.DrawImage();

SoapContext sc = HttpSoapContext.ResponseContext;

sc.Attachments.Add(new DimeAttachment("image/png",TypeFormatEnum.MediaType,s));

}
catch
{
l_bStatus = false;
}

return l_bStatus;
}

至此，我们服务器端的代码就基本完成了，下面我们来看客户端所需要做的工作，我在此处建立了一个WinForm工程来做演示用，实际运用中，则采用卢彦文章里提到的usercontrol就可以了。
客户端代码：
private void button1_Click(object sender, System.EventArgs e)
{
DataSet ds = new DataSet();
ds.ReadXml(Application.StartupPath+@"\test.xml");

PrintWebService.Proxy.Service proxy = new PrintWebService.Proxy.Service();

proxy.CreateImage(ds);

if (proxy.ResponseSoapContext.Attachments.Count != 0)
{
b = new Bitmap(proxy.ResponseSoapContext.Attachments[0].Stream);

this.pictureBox1.Image = b;
}
}

在这里，我们用DataSet载入XML，并调用WebService返回图象Stream，可以看到，客户端的工作变得非常简单，只需要调用个WebService就可以，WSE对于附件的支持完成的很好，代码也极为的简单。我还做了一步打印预览的工作来测试我创建的图片，如下：


至此，我们就大功告成了。

--------------------------------------------------------------------------------

注意事项：
 需在Web服务项目中的web.config内加入以下语句，以保证代码的正确运行。
<webServices>
<soapExtensionTypes>
dd type="Microsoft.Web.Services.WebServicesExtension,Microsoft.Web.Services,Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"
priority="1" group="0"/>
</soapExtensionTypes>
</webServices>
否则Web服务代码里的SoapContext sc = HttpSoapContext.ResponseContext; sc将永远返回null值。
 尽管在我的测试下Web服务所表现出来的性能相当OK，但是在实际运用中，朋友们还得仔细测试一下才行。

--------------------------------------------------------------------------------

总结：
通过上面的描述，相信大家也有同样的体会，那就是扩展非常的方便，在实际应用中，客户所要求打印的数据不会发生很大变化，而对这些数据进行的汇总、列表却有着复杂的要求，通过WebService的方式，我们把这种变化集中在服务器端，尽量减少了客户端程序的改动，服务器端完全可以采用更强大的第三方组件来实现绘图功能；对于多页打印的应用，由于WSE支持多个附件的好处，我们既可以采用一次性发送所有数据在服务器端生成对应的多个图表返回，也可以分批发送；由于采用了XML的介质，数据的采集也实现了多样化，您完全可以在A服务器上采集数据，在B服务器上实现打印。
对于文中所涉及到的代码，有需要的朋友可来信跟我索取(wohuosile@hotmail.com)，对于文中所涉及到的问题，欢迎大家到计算机世界开发者俱乐部（）进行探讨。

--------------------------------------------------------------------------------

参考资料：
文章标题：了解 DIME 和 WS-Attachments
地址：
文章标题：Using Web Services Enhancements to Send SOAP Messages with Attachments
地址：
?pull=/library/en-us/dnwebsrv/html/wsedime.asp

--------------------------------------------------------------------------------

工具：
采用本文所提供的解决方案，需要下载微软的Web Services Enhancements for Microsoft .NET 1.0（WSE）
下载地址：

--------------------------------------------------------------------------------

作者：林焯