/*
* Copyright (C) 2009 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;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
/**
* Resource Qualifier for Platform Version.
*/
public final class VersionQualifier extends ResourceQualifier {
/** Default pixel density value. This means the property is not set. */
private final static int DEFAULT_VERSION = -1;
private final static Pattern sVersionPattern = Pattern.compile("^v(\\d+)$");//$NON-NLS-1$
private int mVersion = DEFAULT_VERSION;
public static final String NAME = "Platform Version";
/**
* Creates and returns a qualifier from the given folder segment. If the segment is incorrect,
* null
is returned.
* @param segment the folder segment from which to create a qualifier.
* @return a new {@link VersionQualifier} object or null
*/
public static VersionQualifier getQualifier(String segment) {
Matcher m = sVersionPattern.matcher(segment);
if (m.matches()) {
String v = m.group(1);
int code = -1;
try {
code = Integer.parseInt(v);
} catch (NumberFormatException e) {
// looks like the string we extracted wasn't a valid number.
return null;
}
VersionQualifier qualifier = new VersionQualifier();
qualifier.mVersion = code;
return qualifier;
}
return null;
}
/**
* Returns the folder name segment for the given value. This is equivalent to calling
* {@link #toString()} on a {@link VersionQualifier} object.
* @param version the value of the qualifier, as returned by {@link #getVersion()}.
*/
public static String getFolderSegment(int version) {
if (version != DEFAULT_VERSION) {
return String.format("v%1$d", version); //$NON-NLS-1$
}
return ""; //$NON-NLS-1$
}
public VersionQualifier(int apiLevel) {
mVersion = apiLevel;
}
public VersionQualifier() {
//pass
}
public int getVersion() {
return mVersion;
}
@Override
public String getName() {
return NAME;
}
@Override
public String getShortName() {
return "Version";
}
@Override
public int since() {
return 1;
}
@Override
public boolean isValid() {
return mVersion != DEFAULT_VERSION;
}
@Override
public boolean hasFakeValue() {
return false;
}
@Override
public boolean checkAndSet(String value, FolderConfiguration config) {
VersionQualifier qualifier = getQualifier(value);
if (qualifier != null) {
config.setVersionQualifier(qualifier);
return true;
}
return false;
}
@Override
public boolean equals(Object qualifier) {
if (qualifier instanceof VersionQualifier) {
return mVersion == ((VersionQualifier)qualifier).mVersion;
}
return false;
}
@Override
public boolean isMatchFor(ResourceQualifier qualifier) {
if (qualifier instanceof VersionQualifier) {
// it is considered a match if the api level is equal or lower to the given qualifier
return mVersion <= ((VersionQualifier) qualifier).mVersion;
}
return false;
}
@Override
public boolean isBetterMatchThan(ResourceQualifier compareTo, ResourceQualifier reference) {
if (compareTo == null) {
return true;
}
VersionQualifier compareQ = (VersionQualifier)compareTo;
VersionQualifier referenceQ = (VersionQualifier)reference;
if (compareQ.mVersion == referenceQ.mVersion) {
// what we have is already the best possible match (exact match)
return false;
} else if (mVersion == referenceQ.mVersion) {
// got new exact value, this is the best!
return true;
} else {
// in all case we're going to prefer the higher version (since they have been filtered
// to not be too high
return mVersion > compareQ.mVersion;
}
}
@Override
public int hashCode() {
return mVersion;
}
/**
* Returns the string used to represent this qualifier in the folder name.
*/
@Override
public String getFolderSegment() {
return getFolderSegment(mVersion);
}
@Override
public String getShortDisplayValue() {
if (mVersion != DEFAULT_VERSION) {
return String.format("API %1$d", mVersion);
}
return ""; //$NON-NLS-1$
}
@Override
public String getLongDisplayValue() {
if (mVersion != DEFAULT_VERSION) {
return String.format("API Level %1$d", mVersion);
}
return ""; //$NON-NLS-1$
}
}