QTreeWidget实现动态加载本地文件系统

用户既可以选择网盘（即：服务器上用户的存储目录）中的文件，又可以选择本地文件系统中的文件，而我实现的功能就是后者，也就是要将本地文件系统映射为树结构目录，这里采用动态加载的方式，何谓动态加载呢，就是只有当用户点击之后才会根据你点击的路径，加载该路径下的所有文件或文件夹，而不是一次性将所有的本地文件系统全部映射到目录树中，这样做能很好的解决性能问题。比如：用户开始看到“我的电脑”，然后当用户点击我的电脑后，你的下级目录（即：C盘，D盘，或E盘）才会加载，然后再点击C盘，C盘下的内容又再次加载。看下效果图吧。







实现思路分析：

这种形式最好的实现方式是利用两个类通过它们之间的协作来实现，一个用来处理本地文件系统扫描，一个用来处理界面的显示，二者之间通过SIGNAL（信号）和SLOT（槽）进行相互协作。类之间的协作关系见下图：



具体描述为：界面显示类在初始化Init()阶段设置树控件的基本外观以及建立信号与槽的绑定。这里要绑定三个信号与槽：

1> 本地树控件中的节点点击响应信号与SelectItem槽的绑定，树节点的点击信号是系统行为无需我们手动声明，而SelectItem槽的作用是，根据点击的节点获取它的绝对路径，然后发送信号给文件系统扫描类对该目录进行扫描。在该connect中，发送者是QTreeWidge树控件，接收者是界面显示本身，信号是系统树控件点击信号itemClicked，槽是界面显示类中的selectItem（）；

2> 绑定发送出去的信号（界面类中定义的信号：sendToDirScan()）与 文件系统扫描类中的处理槽Scan() ，即：对点击树节点后，获取它的绝对路径后，触发sendToDirScan信号，将绝对路径发送出去；而文件系统扫描类中的Scan槽，收到该绝对路径，就开始扫描该绝对路径下的文件或文件夹，并将符合条件的item再发送给界面显示类。在该connect中，发送者是界面显示类，接收者是文件系统扫描类，信号是界面显示类中定义的sendToDirScan，槽是文件系统扫描类中的实现Scan；

3> 绑定文件系统扫描类中扫描到满足条件item的信号ItemScaned() 与 界面显示类中处理添加树节点的槽AddItem()，即：文件系统扫描类扫描到目录下满足条件的文件或文件夹后，将扫描结果发送给界面显示类进行处理显示。在该connect中，发送者是文件系统扫描类，接收者是界面显示类，信号是文件系统扫描类中定义的ItemScaned()，槽是界面显示类中定义的AddItem()；

从上面的关系我们可以得出这样的一个结论：信号的发送有两种：一种是系统自带的信号；一种是用户自定义的信号。对于前者，我们无需声明，只需要绑定特定的处理槽就好，对于后者我们需要自己定义好对应的信号与槽。而在很多情况下，槽的处理过程中会包含着信号，比如：在响应树节点点击后的槽中，我们获取到绝对路径后就要发送信号；又比如在文件扫描类的扫描槽Scan中，当我们扫描到满足条件的item后，也会发送信号。

添加节点小算法：

用户在点击“选择场景文件”后，弹出上面的对话框，用户在开始只能看到“我的电脑”，当用户点击“我的电脑”后，文件系统扫描到C、D、E等盘，发送给界面显示；当用户点击C盘后，文件扫描类扫描C盘下的目录与文件，发送个界面显示类显示。这里我们就面临一个问题：在插入树节点的时候如何判断层级关系？这里我们需要用到哈希结构来保存这一层级关系，哈希结构中保存的是：目录的绝对路径，以及树节点地址。为什么需要保存这两个信息呢？保存目录的绝对路径是为了判断层级关系，保存树节点地址是为了能够取出树的某个节点，当该节点下有其它文件或目录时，可以将其它文件或目录作为子节点插入该节点下。比如：当前存在某个哈希值：<"C:\bin"
, *item>，然后又过来一个路径："C:\bin\houqd"，注意：在判断时我们要判断：C:\bin是否存在，即它的上级目录，通过哈希值比较发现C:\bin存在，则C:\bin\houqd这个节点应该是item的子节点，然后我们从哈希里面取出item，然后利用C:\bin\houqd生成item_1，将item_1插入到节点item底下。然后将<"C:\bin\houqd" , *item_1>再保存下来，如此往复即可。

注意：在哈希表中我们只插入目录的绝对路径，对于文件不用插入，因为文件不是目录，不会包含其它的文件或目录，即文件下不会形成层级目录。

情景模拟：1》点击“我的电脑”后，哈希表中存入的值以及界面显示对应的关系为：



2》点击“C:\”后，哈希表中存入的值以及界面显示对应的关系为（注意：文件的绝对路径不会保存在Hash表中，因为它不需要记录层级关系）：



3》点击“C:\bin”，哈希表中存入的值以及界面显示对应的关系为：



通过上面的分析，应该对实现方式有个很清晰明了的认识了吧！！

实现代码：

这里将文件扫描类的代码和界面显示类的代码的.h文件和.cpp文件都贴上吧，赋值下来稍作修改应该可以直接使用：

文件扫描类DirScan头文件：DirScan.h

#ifndef DIRSCAN_H
#define DIRSCAN_H

#include <QObject>
#include <QFileInfo>

class DirScan : public QObject
{
Q_OBJECT
public:
explicit DirScan(QObject *parent = 0);

void AsncScan(const QString strPath);

signals:
void ItemScaned(const QString &strRootPath, const QFileInfo &ItemInfo , const int i);

protected slots:
void Scan(const QString strPath);

private:
static int k ;

};

#endif // DIRSCAN_H

文件扫描类DirScan的cpp文件：DirScan.cpp

#include "dirscan.h"

#include <QtCore>

int DirScan::k = 0 ;

DirScan::DirScan(QObject *parent) :
QObject(parent)
{
}

void DirScan::AsncScan(const QString strPath)
{
QtConcurrent::run(this, &DirScan::Scan, strPath);
}

void DirScan::Scan(const QString strPath)
{
//! 第一次肯定是显示磁盘驱动器
if(k == 0 && !QString::compare(strPath , QString(tr("我的电脑")))){
QFileInfoList drivers = QDir::drives();
int q = 0 ;
do{
QFileInfo d = drivers.at(q++);

qDebug("-----sendBack:%s\n" , d.filePath().toLatin1().data());
emit ItemScaned(strPath , d , k);
}while(q < drivers.size());
k++ ;

//! 其它就是盘符下面的内容
}else{
QDir dir(strPath);
if(dir.exists())
{
k ++ ;
QFileInfoList fileList = dir.entryInfoList();
int i = 0 ;
do{
QFileInfo file = fileList.at(i++);

emit ItemScaned(strPath, file , k);

}while(i < fileList.size());

}
}

return ;
}

界面显示类mainwindow的头文件：mainWindow.h

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>
#include <QFileInfo>
#include <QTreeWidgetItem>
#include <QHash>
#include "dirscan.h"

namespace Ui {
class MainWindow;
}

class MainWindow : public QMainWindow
{
Q_OBJECT

public:
explicit MainWindow(QWidget *parent = 0);
~MainWindow();
void init();
QString getItemFullPath(QTreeWidgetItem* item);

protected slots:
void AddItem(const QString &strRootPath, const QFileInfo &ItemInfo , const int k );
void selectItem(QTreeWidgetItem * , int);

signals:
void sendToDirScan(const QString &selectedItem );

private:
Ui::MainWindow *ui;

private:
DirScan *dirScan ;
QList<QTreeWidgetItem *> root ;
QString rootPath ;

private:
QHash<QString/*path*/, QTreeWidgetItem *> m_StoreDirItem;
};

#endif // MAINWINDOW_H

界面显示类mainwindow的cpp文件：mainwindow.cpp

#include "mainwindow.h"
#include "ui_mainwindow.h"
#include <QMessageBox>

MainWindow::MainWindow(QWidget *parent) :
QMainWindow(parent),
ui(new Ui::MainWindow)
{
ui->setupUi(this);
ui->treeWidget->setColumnCount(1);
ui->treeWidget->setHeaderLabel("LocalFileSystem");
dirScan = new DirScan();

//! 绑定扫DirScan扫描完的信号，发送过来添加进树
if(!connect(dirScan , SIGNAL(ItemScaned(QString,QFileInfo,int)) , this , SLOT(AddItem(QString,QFileInfo,int)))){
qDebug("--error:1--\n");
}

//! 绑定本地树控件的单击事件，经过处理后发送出去，参数为点击的path
if(!connect(ui->treeWidget , SIGNAL(itemClicked(QTreeWidgetItem*,int)) , this , SLOT(selectItem(QTreeWidgetItem* , int)))){
qDebug("--error:2--\n");
}

//! 绑定发送出去的事件，即发送给DirScan的事件
if(!connect(this , SIGNAL(sendToDirScan(QString)) , dirScan , SLOT(Scan(QString)))){
qDebug("--error:3--\n");
}

qDebug("--structre function--\n");
}

MainWindow::~MainWindow()
{
delete ui;
}

void MainWindow::init()
{
QTreeWidgetItem *top = new QTreeWidgetItem(ui->treeWidget , QStringList(QString(tr("我的电脑"))));
root.append(top);
ui->treeWidget->insertTopLevelItems(0 , root);
}

void MainWindow::AddItem(const QString &strRootPath, const QFileInfo &ItemInfo , const int k)
{

if(ItemInfo.isDir()){

if(ItemInfo.fileName() == QLatin1String(".") || ItemInfo.fileName() == QLatin1String("..")){
return ;
}

QString fullPath = ItemInfo.absolutePath().replace("/" , "\\") ;

//		if(!QString::compare(strRootPath , rootPath)){
//		   return ;
//		}

qDebug("(fullPath: %s)\n" , fullPath.toLatin1().data());

// 这个只是第一次走，剩下的肯定都是包含的，因为盘符是在最外面的
if(!m_StoreDirItem.contains(fullPath)){

QString showname = ( k ? ItemInfo.fileName() : ItemInfo.filePath() );
qDebug("---not----contains----k = %d ---------showname = %s.\n" , k , showname.toLatin1().data());
QTreeWidgetItem *item = new QTreeWidgetItem(ui->treeWidget->findItems(QString(tr("我的电脑")) , 0 , 0).at(0) , QStringList(showname));

m_StoreDirItem.insert(fullPath , item);

}else{

qDebug("---------contains---------\n");
QTreeWidgetItem *item = m_StoreDirItem.value(fullPath);
QTreeWidgetItem *item_1 = new QTreeWidgetItem(QStringList(ItemInfo.fileName()));

int j ;
for(j=0 ; j < item->childCount() ; j++){
if(!QString::compare(ItemInfo.fileName() , item->child(j)->text(0))){
break ;
}
}

if(j == item->childCount()){
item->addChild(item_1);
m_StoreDirItem.insert(ItemInfo.absoluteFilePath().replace("/","\\") , item_1);
}
}

}else if(ItemInfo.isFile()){
qDebug(":::::::I am a file.\n");

QString fileFullPath = ItemInfo.filePath();
QString filename = ItemInfo.fileName();

QString file_path ;

file_path = ItemInfo.absolutePath().replace("/","\\");

qDebug("::::::file_path = %s\n" , file_path.toLatin1().data());

if(!m_StoreDirItem.contains(file_path)){

qDebug("----not contains----\n");
QTreeWidgetItem *item = new QTreeWidgetItem(ui->treeWidget , QStringList(file_path));
QTreeWidgetItem *item_1 = new QTreeWidgetItem(item , QStringList(filename));
item->addChild(item_1);

m_StoreDirItem.insert(file_path , item);
}else{

qDebug("---contains---\n");
QTreeWidgetItem *item = m_StoreDirItem.value(file_path);
QTreeWidgetItem *item_1 = new QTreeWidgetItem(QStringList(filename));
int j ;
for( j = 0 ; j < item->childCount() ; j++){
if(!QString::compare(filename , item->child(j)->text(0))){
break ;
}
}

qDebug("---j = %d and childCount = %d \n" , j , item->childCount());
if(j == item->childCount()){
item->addChild(item_1);
}
}
}

return ;

}

void MainWindow::selectItem(QTreeWidgetItem *item, int index)
{
QString itemFullPath = getItemFullPath(item);

qDebug("send signal and itemFullPath = %s ... \n" , itemFullPath.toLatin1().data());
emit sendToDirScan(itemFullPath);

return ;
}

//! 通过查找父节点，定位某节点的绝对路径
QString MainWindow::getItemFullPath(QTreeWidgetItem *item)
{
QString itemFullPath = item->text(0);

while(item->parent() != NULL && QString::compare(item->parent()->text(0) , QString(tr("我的电脑")))){
qDebug("------parentPath = %s\n" , item->parent()->text(0).toLatin1().data());
itemFullPath = item->parent()->text(0).replace("/","") + "\\" + itemFullPath ;
item = item->parent();
}

if(!QString::compare(item->text(0) , QString(tr("我的电脑")))){
return QString(tr("我的电脑"));
}

return itemFullPath ;
}

说在最后：

以上的代码是我进行测试时候的代码，和生产环境中的代码还有一定的区别，代码中有些冗余的地方以及一些改进的地方。改进的地方是：1> Dir::drives()扫描出来的是本地的所有磁盘驱动器，包括系统下可使用的盘以及DVD磁盘驱动器，我们可以通过判断该设备是否是可读以及可写的方式将DVD磁盘驱动器过滤掉。即：
d . isReadable () &&
d . isReadable () ；2> 只显示符合特定后缀名的文件，例如：只显示".mb"的文件或者其它，取出文件后缀名，然后过滤掉。