1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
|
#pragma once
#include <QDateTime>
#include <QFile>
#include <QFileInfo>
#include <QUrl>
#include <QtDebug>
// Wrapper class for dealing with track files and their
// path/location, URL, and URI representations.
//
// All file-related track properties are snapshots from the provided
// QFileInfo. Obtaining them might involve accessing the file system
// and should be used consciously! The QFileInfo class does some
// caching behind the scenes.
//
// Please note that the canonical location of QFileInfo may change at
// any time, when the underlying file system structure is modified.
// It becomes empty if the file is deleted.
//
// Copying an instance of this class is thread-safe, because the
// underlying QFileInfo is implicitly shared.
class TrackFile {
public:
static TrackFile fromUrl(const QUrl& url) {
return TrackFile(url.toLocalFile());
}
// For backward-compatibility the QString single argument
// constructor has not been declared as "explicit". It is
// also not strictly necessary and might be removed at some
// point to prevent unintended type conversions.
/*non-explicit*/ TrackFile(
const QString& filePath)
: m_fileInfo(filePath) {
}
explicit TrackFile(
QFileInfo fileInfo = QFileInfo())
: m_fileInfo(std::move(fileInfo)) {
}
explicit TrackFile(
const QDir& dir,
const QString& file = QString())
: m_fileInfo(QFileInfo(dir, file)) {
}
const QFileInfo& asFileInfo() const {
return m_fileInfo;
}
// Local file representation
QString location() const {
return m_fileInfo.absoluteFilePath();
}
QString canonicalLocation() const {
return m_fileInfo.canonicalFilePath();
}
QString directory() const {
return m_fileInfo.absolutePath();
}
QString baseName() const {
return m_fileInfo.baseName();
}
QString fileName() const {
return m_fileInfo.fileName();
}
qint64 fileSize() const {
return m_fileInfo.size();
}
QDateTime fileCreated() const {
#if QT_VERSION >= QT_VERSION_CHECK(5, 10, 0)
return m_fileInfo.birthTime();
#else
return m_fileInfo.created();
#endif
}
QDateTime fileLastModified() const {
return m_fileInfo.lastModified();
}
// Check if the file actually exists on the file system.
bool checkFileExists() const {
return QFile::exists(location());
}
void refresh() {
m_fileInfo.refresh();
}
// Refresh the canonical location if it is still empty, i.e. if
// the file may have re-appeared after mounting the corresponding
// drive while Mixxx is already running.
//
// We ignore the case when the user changes a symbolic link to
// point a file to an other location, since this is a user action.
// We also don't care if a file disappears while Mixxx is running.
// Opening a non-existent file is already handled and doesn't cause
// any malfunction.
QString freshCanonicalLocation();
// Portable URL representation
QUrl toUrl() const {
return QUrl::fromLocalFile(location());
}
friend bool operator==(const TrackFile& lhs, const TrackFile& rhs) {
return lhs.m_fileInfo == rhs.m_fileInfo;
}
private:
QFileInfo m_fileInfo;
};
inline bool operator!=(const TrackFile& lhs, const TrackFile& rhs) {
return !(lhs == rhs);
}
inline QDebug operator<<(QDebug debug, const TrackFile& trackFile) {
#if QT_VERSION >= QT_VERSION_CHECK(5, 12, 0)
return debug << trackFile.asFileInfo();
#else
return debug << trackFile.location();
#endif
}
inline uint qHash(
const TrackFile& key,
uint seed = 0) {
return qHash(key.location(), seed);
}
|
