blob: 6abac4ecef2c633132a8332a48903d37248de9f2 (
plain)
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
|
/*
* Copyright (C) 2007 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.android.ide.common.resources.configuration;
/**
* Base class for resource qualifiers.
* <p/>The resource qualifier classes are designed as immutable.
*/
public abstract class ResourceQualifier implements Comparable<ResourceQualifier> {
/**
* Returns the human readable name of the qualifier.
*/
public abstract String getName();
/**
* Returns a shorter human readable name for the qualifier.
* @see #getName()
*/
public abstract String getShortName();
/**
* Returns whether the qualifier has a valid filter value.
*/
public abstract boolean isValid();
/**
* Returns whether the qualifier has a fake value.
* <p/>Fake values are used internally and should not be used as real qualifier value.
*/
public abstract boolean hasFakeValue();
/**
* Check if the value is valid for this qualifier, and if so sets the value
* into a Folder Configuration.
* @param value The value to check and set. Must not be null.
* @param config The folder configuration to receive the value. Must not be null.
* @return true if the value was valid and was set.
*/
public abstract boolean checkAndSet(String value, FolderConfiguration config);
/**
* Returns a string formated to be used in a folder name.
* <p/>This is declared as abstract to force children classes to implement it.
*/
public abstract String getFolderSegment();
/**
* Returns whether the given qualifier is a match for the receiver.
* <p/>The default implementation returns the result of {@link #equals(Object)}.
* <p/>Children class that re-implements this must implement
* {@link #isBetterMatchThan(ResourceQualifier, ResourceQualifier)} too.
* @param qualifier the reference qualifier
* @return true if the receiver is a match.
*/
public boolean isMatchFor(ResourceQualifier qualifier) {
return equals(qualifier);
}
/**
* Returns true if the receiver is a better match for the given <var>reference</var> than
* the given <var>compareTo</var> comparable.
* @param compareTo The {@link ResourceQualifier} to compare to. Can be null, in which
* case the method must return <code>true</code>.
* @param reference The reference qualifier value for which the match is.
* @return true if the receiver is a better match.
*/
public boolean isBetterMatchThan(ResourceQualifier compareTo, ResourceQualifier reference) {
// the default is to always return false. This gives less overhead than always returning
// true, as it would only compare same values anyway.
return false;
}
@Override
public String toString() {
return getFolderSegment();
}
/**
* Returns a string formatted for display purpose.
*/
public abstract String getShortDisplayValue();
/**
* Returns a string formatted for display purpose.
*/
public abstract String getLongDisplayValue();
/**
* Returns <code>true</code> if both objects are equal.
* <p/>This is declared as abstract to force children classes to implement it.
*/
@Override
public abstract boolean equals(Object object);
/**
* Returns a hash code value for the object.
* <p/>This is declared as abstract to force children classes to implement it.
*/
@Override
public abstract int hashCode();
public final int compareTo(ResourceQualifier o) {
return toString().compareTo(o.toString());
}
}
|
