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
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
|
/*
This file is part of Subsonic.
Subsonic is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
Subsonic is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with Subsonic. If not, see <http://www.gnu.org/licenses/>.
Copyright 2009 (C) Sindre Mehus
*/
package net.sourceforge.subsonic.service.metadata;
import java.io.File;
import java.util.List;
import org.apache.commons.io.FilenameUtils;
import net.sourceforge.subsonic.domain.MediaFile;
import net.sourceforge.subsonic.domain.MusicFolder;
import net.sourceforge.subsonic.service.ServiceLocator;
import net.sourceforge.subsonic.service.SettingsService;
/**
* Parses meta data from media files.
*
* @author Sindre Mehus
*/
public abstract class MetaDataParser {
/**
* Parses meta data for the given file.
*
* @param file The file to parse.
* @return Meta data for the file, never null.
*/
public MetaData getMetaData(File file) {
MetaData metaData = getRawMetaData(file);
String artist = metaData.getArtist();
String album = metaData.getAlbumName();
String title = metaData.getTitle();
if (artist == null) {
artist = guessArtist(file);
}
if (album == null) {
album = guessAlbum(file, artist);
}
if (title == null) {
title = guessTitle(file);
}
title = removeTrackNumberFromTitle(title, metaData.getTrackNumber());
metaData.setArtist(artist);
metaData.setAlbumName(album);
metaData.setTitle(title);
return metaData;
}
/**
* Parses meta data for the given file. No guessing or reformatting is done.
*
*
* @param file The file to parse.
* @return Meta data for the file.
*/
public abstract MetaData getRawMetaData(File file);
/**
* Updates the given file with the given meta data.
*
* @param file The file to update.
* @param metaData The new meta data.
*/
public abstract void setMetaData(MediaFile file, MetaData metaData);
/**
* Returns whether this parser is applicable to the given file.
*
* @param file The file in question.
* @return Whether this parser is applicable to the given file.
*/
public abstract boolean isApplicable(File file);
/**
* Returns whether this parser supports tag editing (using the {@link #setMetaData} method).
*
* @return Whether tag editing is supported.
*/
public abstract boolean isEditingSupported();
/**
* Guesses the artist for the given file.
*/
public String guessArtist(File file) {
File parent = file.getParentFile();
if (isRoot(parent)) {
return null;
}
File grandParent = parent.getParentFile();
return isRoot(grandParent) ? null : grandParent.getName();
}
/**
* Guesses the album for the given file.
*/
public String guessAlbum(File file, String artist) {
File parent = file.getParentFile();
String album = isRoot(parent) ? null : parent.getName();
if (artist != null && album != null) {
album = album.replace(artist + " - ", "");
}
return album;
}
/**
* Guesses the title for the given file.
*/
public String guessTitle(File file) {
return removeTrackNumberFromTitle(FilenameUtils.getBaseName(file.getPath()), null);
}
private boolean isRoot(File file) {
SettingsService settings = ServiceLocator.getSettingsService();
List<MusicFolder> folders = settings.getAllMusicFolders(false, true);
for (MusicFolder folder : folders) {
if (file.equals(folder.getPath())) {
return true;
}
}
return false;
}
/**
* Removes any prefixed track number from the given title string.
*
* @param title The title with or without a prefixed track number, e.g., "02 - Back In Black".
* @param trackNumber If specified, this is the "true" track number.
* @return The title with the track number removed, e.g., "Back In Black".
*/
protected String removeTrackNumberFromTitle(String title, Integer trackNumber) {
title = title.trim();
// Don't remove numbers if true track number is given, and title does not start with it.
if (trackNumber != null && !title.matches("0?" + trackNumber + "[\\.\\- ].*")) {
return title;
}
String result = title.replaceFirst("^\\d{2}[\\.\\- ]+", "");
return result.length() == 0 ? title : result;
}
}
|
