I:项目描述:利用 Silverlight+WCF 技术,模拟资源管理器(如图1)功能,通过地址栏输入本地文件夹路径,然后将解析出来的该目录下所有文件(夹)存储到数据库中,然后再加载到界面上显示出来;
(图1)
II:涉及技术:Silverlight + WCF + Component One 控件(TreeView 和 FlexGrid)
III:开发环境:Visual Studio2012 + SQL Server 2008 R2 + Silverlight 5 + Component One C1Silverlight_2014v1;
一 项目架构(如图2)
(图2)
FolderDB:DAL(数据访问层),包括文件属性类 Folders,文件夹树模型类 FolderModel,数据库操作类 DBHelper;
FolderUI:Silverlight 客户端,基本界面显示,包括 FlexGrid 标题数据源类 ColumnHeaders,文件大小值转换类 FileSizeConverter;
FolderWCF:WCF 服务层,包括 FolderService 服务类;
FolderWeb:Web层,该项目中涉及不多;
二 源码部分解析
/// <summary>
/// 执行多条SQL语句,实现数据库事务
/// </summary>
/// 多条SQL语句
public int ExecuteSqlTran(List sqlStrList)
{
SqlTransaction sqlTran = null;
try
{
if (ConnectionState.Open != m_SqlConn.State)
{
m_SqlConn.Open();
}
int count = 0;// 影响的记录数
SqlCommand cmd = new SqlCommand();
sqlTran = m_SqlConn.BeginTransaction();
cmd.Connection = m_SqlConn;
cmd.Transaction = sqlTran;
foreach (string sqlStr in sqlStrList)
{
if (sqlStr.Trim().Length > 1)
{
cmd.CommandText = sqlStr;
count += cmd.ExecuteNonQuery();
}
}
sqlTran.Commit();// 提交数据库事务
return count;
}
catch (SqlException sqlEx)
{
if (null != sqlTran)
{
sqlTran.Rollback();// 失败后回滚
} throw new Exception(sqlEx.Message);
}
}
注意执行完 ExecuteNonQuery() 后,并不算完,事务在最后还需要进行提交数据库事务才行,sqlTran.Commit(),否则操作一直都不会执行,但是调试过程中也不会出现异常;
public class FolderModel
{
/// <summary>
/// 当前目录(文件夹)属性
/// </summary>
public Folders CurrFolder { get; set; } /// <summary>
/// 子文件(夹)集合
/// </summary>
public ObservableCollection SubFolders { get; set; } public FolderModel()
{
SubFolders = new ObservableCollection();
} public FolderModel(Folders folders)
{
CurrFolder = folders;
SubFolders = new ObservableCollection();
}
}
这是绑定 C1TreeView 控件的数据源模型,其中 ObservableCollection 是表示一个动态数据集合,在添加项、移除项或刷新整个列表时,此集合将提供通知。SubFolders 则是作为子树的绑定,CurrFolder 则是作为当前节点的绑定,详细见下面的 XAML 代码解释;
/// <summary>
/// Header数据源
/// </summary>
public class ColumnHeader : INotifyPropertyChanged
{
private List m_HeaderList;
public event PropertyChangedEventHandler PropertyChanged;
public List HeaderList
{
get
{
return m_HeaderList;
}
set
{
m_HeaderList = value;
if (PropertyChanged != null)
{
PropertyChanged.Invoke(this, new PropertyChangedEventArgs("HeaderList"));
}
}
}
}
该类作为 C1FlexGrid 列标题即 Column.Header 的动态绑定数据源,HeaderList 中存储的是每列的列名;该数据会从 WCF 服务端获取,然后绑定在客户端上显示;
public object Convert(object value, System.Type targetType, object parameter, System.Globalization.CultureInfo culture)
{
try
{
int byteSize = int.Parse(value.ToString());// 单位字节
int nKBSize = (int)Math.Ceiling(byteSize * 1.0 / 1024);// 转换成KB return string.Format("{0} KB", nKBSize);
}
catch (Exception ex)
{
throw new Exception(ex.Message);
}
}
因为要将文件大小该列的值全部由字节转换成 KB,则将 Size 那一列绑定该转换器即可;
- ItemsSource="{Binding SubFolders}" // 绑定 SubFolders 数据源,该数据源在 FolderModel 类中定义,作为树数据源;
- ItemTemplate="{StaticResource FolderTemplate}" // 指定树每个节点的模版定义;静态资源 FolderTemplate 则是在<UserControl.Resources>标签中定义;
- HierarchicalDataTemplate:// 定义 TreeView 节点模版
- ItemsSource="{Binding SubFolders}" // 同样指定该模版数据源
- <TextBlock Text="{Binding CurrFolder.Name}" /> // 节点所包含的内容,绑定 CurrFolder 对象中 Name 属性值,在 FolderModel 类中定义;
C1FlexGrid控件:
AutoGenerateColumns="False" //绑定数据源中有些列数据并不想显示出来,只要求部分指定的列显示,则需要设置成 false,阻止其自动生成列;
<c1:C1FlexGrid.Columns> // 设置每列所绑定的数据
<c1:Column Binding="{Binding [2]}" HorizontalAlignment="Left" Width="200">
<c1:Column.HeaderTemplate>
<DataTemplate>
<TextBlock Text="{Binding Path=HeaderList[2]}" />
</DataTemplate>
</c1:Column.HeaderTemplate>
</c1:Column>
该树绑定的数据源类型为 List<List<string>>,所以 Binding 的对象就是 List<string> 类型,而按以往的思路,Binding 的对象是具有 get,set 的属性,查看了 List 类下有 public T this[int index] { get; set; },所以可以直接通过 [n] 索引来绑定数据;
HeaderTemplate 作为 Header 的模版定义,绑定的数据源类型是 ColumnHeader,直接访问其属性 HeaderList 即可;
添加文件夹树节点单击事件,在 FlexGrid 中加载该文件夹下所有文件信息;
// 文件夹目录上的选择单个文件夹事件
private void FoldersTree_SelectionChanged(object sender, SelectionChangedEventArgs e)
{
C1TreeViewItem selectedNode = tvFoldersTree.SelectedItem;
if (null != selectedNode)
{
// 当前选择的节点
FolderModel selectedFolderModel = (FolderModel)selectedNode.Header;
m_SelectedFolderName = selectedFolderModel.CurrFolder.Name;// 节点名称(文件夹名)
m_WCFClient.GetFilesAsync(selectedFolderModel.CurrFolder.ID);
}
} void GetFilesCompleted(object sender, GetFilesCompletedEventArgs e)
{
if (null == e.Error)
{
List<List<string>> result = e.Result;
ColumnHeader columnHeader = new ColumnHeader();
columnHeader.HeaderList = result[0];
fgFilesView.ColumnHeaders.DataContext = columnHeader;// 绑定列标题数据源 result.RemoveAt(0);// 移除第一个表示列名称的List
fgFilesView.ItemsSource = new PagedCollectionView(result);// 绑定列内容数据源
fgFilesView.Columns[3].ValueConverter = new FileSizeConverter();
txtMsg.Text = "加载文件夹【" + m_SelectedFolderName + "】目录下的文件已完成。";
}
else
{
txtMsg.Text = "加载文件数据失败,异常信息:" + e.Error.Message;
}
}
C1TreeView 的节点是 C1TreeViewItem 类型,所以获得当前点击的节点可以用:C1TreeViewItem selectedNode = tvFoldersTree.SelectedItem; 当然也可以由 sender 转型得到;值得注意的是,在这里,C1TreeViewItem 的 Header 属性是 C1TreeView 所绑定数据源的类型,即 FolderModel,而在 xaml 文件中,对 Column 标签的 header 属性进行值绑定时,其 header 值为 string 类型!!故在 xaml 中对 header 的绑定是通过 HeaderTemplate 模版定义来完成的;
服务器端返回的 e.Result 是一个 List<List<string>> 类型,其中第一个 List<string> 指的是列名;列名的绑定方式:fgFilesView.ColumnHeaders.DataContext = columnHeader; C1FlexGrid 的绑定方式:fgFilesView.ItemsSource = new PagedCollectionView(result); 其中 DataContext 和 ItemsSource 两种是有区别的,本人还没有学习到,读者可以阅读他人的相关博文学习;
对第三列的文件大小需要绑定值转换器:fgFilesView.Columns[3].ValueConverter = new FileSizeConverter(); 即可;
<configuration>
<system.serviceModel>
<bindings>
<basicHttpBinding>
<binding name="BasicHttpBinding_IFolderService" maxBufferSize="2147483647"
maxReceivedMessageSize="2147483647">
<security mode="None" />
</binding>
</basicHttpBinding>
</bindings>
<client>
<endpoint address="http://localhost:54416/FolderService.svc"
binding="basicHttpBinding" bindingConfiguration="BasicHttpBinding_IFolderService"
contract="FolderServiceRefer.IFolderService" name="BasicHttpBinding_IFolderService" />
</client>
</system.serviceModel>
</configuration>
ServiceReferences.ClientConfig
该文件是由 Silverlight 客户端添加服务引用时自动生成的配置文件,其中 <bindings> 标签内容是由 WCF 服务器端的 Web.config 配置文件中对应的 <bindings> 标签内容截取部分而来,对于 maxBufferSize 和 maxReceivedMessageSize 两个属性最好设置值大一些,而且必须值一样,不能超过 2147483647;否则会报如下异常:
1:“由于正在缓冲消息,MaxReceivedMessageSize 和 MaxBufferSize 的值必须相同”;
2:发生了 System.ServiceModel.ProtocolException
Message=已超过传入消息(65536)的最大消息大小配额。若要增加配额,请使用相应绑定元素上的MaxReceivedMessageSize属性。
Source=System.ServiceModel
StackTrace:
在System.ServiceModel.Channels.HttpInput.ThrowHttpProtocolException(String messagem, HttpStatusCode statusCode, String statusDescription)
<endpoint> 是客户端终结点设置,address 属性指 WCF 所在服务器端的访问路径,其他属性内容也是从服务器端 Web.config 配置文件中自动生成过来的;
三 项目遇到的问题及参考解决方法
1:WCF 的独立调试
参考解决方法:将 WCF 项目“设为启动项目”,并将 svc 文件“设为起始页”,然后按“F5”即可打开“WCF测试客户端”,如下图,然后选择要是调试的方法(如SaveFolders()),在右侧的“值”中填入所需参数(字符串里需要转义),再执行“调用”即可在“响应”中看到结果值;如果在 VS 中相应的方法中加入断点,则可以进行断点调试操作!
2:WCF 测试客户端的配置文件
参考解决方法:上图中,在“配置文件”上右键选择“用 SvcConfigEditor 进行编辑”选项,即可对 WCF 测试客户端的配置文件进行修改;
尤其是出现“已超过传入消息(65536)的最大消息大小配额。”的异常信息时,需要修改其中“绑定”目录下已定义的 basicHttpBinding 属性配置信息,将其中的 MaxBufferPoolSize 和 MaxBufferSize 和 MaxReceivedMessageSize 的值均改为 int 的 MaxValue 即可;
还有,每次打开该 SvcConfigEditor,程序都会自动重新加载“个人文件夹\AppData\Local\Temp\Test Client Projects\11.0\f868aff1-aa2d-4418-abaf-f4be03a71529”下的 Client.dll.config 配置文件,f868aff1-aa2d-4418-abaf-f4be03a71529 这个根据情况会有所变动,这样之前的属性配置修改就白搭了,每次启动都要修改,这丫的肯定不干了呀,在 WCF 测试客户端里,在“工具”-》“选项”中,把“始终在启动服务时重新生成配置”选项去掉就欧克了!
3:没有异常,重新生成解决方案也都成功,但是启动 Silverlight 后界面上完全空白
参考解决方法:毫无头绪的 bug 呀,而且是深藏不露的!通过启动 Web 端的界面也无法显示 Silverlight 程序,而且查看了 Silverlight 中 xaml 文件下也无异常情况,此时此刻,可以肯定的是加载 Silverlight 过程中出错了,没有正常加载Silverlight!但是又如何知道是什么 bug,什么地方出现了 bug 呢?
在 Web 项目中找到要加载 Silverlight 应用程序的 aspx 页面文件,将 onSilverlightError 该函数内的 errMsg 错误信息弹出显示即可;
这时候再根据错误提示去找度娘就简单多了,2103的错误解决如下:
由于在修改 Silverlight 客户端的命名空间时,导致项目内部没有彻底完全的修改完命名空间,才会导致2103错误;在 Silverlight 项目右键属性中,查看“启动对象”是否是修改命名空间后的选项即可;
4:在 Silverlight 客户端添加服务引用时,异常“找不到类型 Project.Web.Service,它在 ServiceHost 指令中提供为 Service 特性值,或在配置元素...”
如果,我说的是如果,你已经完全确定你的 WCF 服务完全正确,Web.config 配置里也完全正确,那这个错误只可能是因为你在 WCF 项目中编辑完服务之后,没有对 WCF 项目“重新生成”导致的!!这也提醒着大家,在项目编码过程中,每次对 WCF 项目进行编辑修改后,都要重新生成一下,并且在 Silverlight 客户端的服务上右键“更新服务引用”才行,不然你改了半天的 WCF 服务端方法,结果执行的结果依然让人寒心,那就真的寒心了... ...
5:项目的部署问题
VS 默认是采用自带的 IIS Express 来部署 Silverlight 项目以及 WCF 服务,部署后在右下角会出现如下图标和内容;
关于 IIS Express 和本地的 IIS 的区别,是一个很有意思的话题,这里就不说了,建议去看大神博客解析,会受益匪浅的。这里简单提及一些基本的关于 IIS Express 知识:
配置文件:C:\Program Files\IIS Express\AppServer\applicationhost.config
<applicationPools> 标签 ---- 应用程序池配置
<add name="Clr4IntegratedAppPool" managedRuntimeVersion="v4.0" managedPipelineMode="Integrated" CLRConfigFile="%IIS_BIN%\config\templates\PersonalWebServer\aspnet.config" autoStart="true" />
相当于 IIS 中
<sites> 标签 ---- 网站配置,每一个 <site> 子标签,代表一个网站的配置
<site name="Development Web Site" id="1" serverAutoStart="true">
<application path="/">
<virtualDirectory path="/" physicalPath="%IIS_BIN%\AppServer\empty_wwwroot" />
</application>
<bindings>
<binding protocol="http" bindingInformation=":8080:localhost" />
</bindings>
</site>
<defaultDocument> 标签 ---- 设置默认起始页
<files>
<add value="Default.htm" />
<add value="Default.asp" />
<add value="index.htm" />
<add value="index.html" />
<add value="iisstart.htm" />
<add value="default.aspx" />
</files>
其他的可以自行了解去了!
Silverlight+WCF 部署在本地 IIS 上,需要注意事项:
1)WCF 项目和 SilverlightWeb 项目发布到 IIS 网站下的相同目录下,
2:作为第二次发布的项目,不能选择“发布前删除所有现有文件”,否则会把前一个发布的文件清除了;
3:发布目录下的配置文件 Web.config 检查一下是不是WCF项目中的配置文件,如果不是,手动粘贴过来覆盖
4:修改 ClientBin\*.xap\ServiceReferences.ClientConfig 文件中,关于WCF服务地址的终结点配置,改为本地 ip 地址;
5:应用程序“DEFAULT WEB SITE”中的服务器错误;HTTP 错误 403.14-Forbidden;Web服务器被配置为不列出此目录的内容。
因为部署的项目中没有默认的启动页面,IIS 设置的默认启动页面文档包括【“Default.htm”,“Default.asp”,“index.htm”,“index.html”,“iisstart.htm”,default.aspx】,而你部署的项目根目录下没有这些文档中的至少一个,而且,在 IIS 功能视图中的“目录浏览”设置里也禁用了,所以报此错误!解决方法自己去搞定吧!!
6:直接访问 svc 服务文件(http://192.168.0.64/FolderService.svc)报如下异常:
当前已禁用此服务的元数据发布。
如果之前在 VS 上调试一切正常,只是发布后出现这个问题,去发布目录下查看配置文件 Web.config,看是否是 WCF 项目下的那个配置文件,不是的话就手动拷贝覆盖。
否则的话就按浏览器下面出现的异常提示解决: