This way any number of pre-defined DataSources can be used, but plugins can define new ones and you can handle unknown data sources in the same way as predefined ones.
Definitions for common DataSources can be found in {@link org.bridgedb.bio.BioDataSource}.
*/
public final class DataSource
{
private static Map
* Warning: the ordering of this list is undefined.
* Two subsequent calls may give different results.
* @return List of full names
*/
static public List
*
* We should try not to use the system code anywhere outside
* these 4 uses.
* @return systemcode, a short unique code.
*/
public String getSystemCode()
{
return sysCode;
}
/**
* Return the main Url for this datasource,
* that can be used to refer to the datasource in general.
* (e.g. http://www.ensembl.org/)
*
* May return null in case the main url is unknown.
* @return main url
*/
public String getMainUrl()
{
return mainUrl;
}
/**
* @return type of entity that this DataSource describes, for example
* "metabolite", "gene", "protein" or "probe"
*/
public String getType()
{
return type;
}
/**
* Creates a global identifier.
* It uses the MIRIAM data type list
* to create a MIRIAM URI like "urn:miriam:uniprot:P12345",
* or if this DataSource is not included
* in the MIRIAM data types list, a bridgedb URI.
* @param id Id to generate URN from.
* @return the URN.
*/
public String getURN(String id)
{
String idPart = "";
try
{
idPart = URLEncoder.encode(id, "UTF-8");
} catch (UnsupportedEncodingException ex) { idPart = id; }
return urnBase + ":" + idPart;
}
/**
* Uses builder pattern to set optional attributes for a DataSource. For example, this allows you to use the
* following code:
*
* DataSource.register("X", "Affymetrix")
* .mainUrl("http://www.affymetrix.com")
* .type("probe")
* .primary(false);
*
*/
public static final class Builder
{
private final DataSource current;
/**
* Create a Builder for a DataSource. Note that an existing DataSource is
* modified rather than creating a new one.
* This constructor should only be called by the register method.
* @param current the DataSource to be modified
*/
private Builder(DataSource current)
{
this.current = current;
}
/**
* @return the DataSource under construction
*/
public DataSource asDataSource()
{
return current;
}
/**
*
* @param urlPattern is a template for generating valid URL's for identifiers.
* The pattern should contain the substring "$ID", which will be replaced by the actual identifier.
* @return the same Builder object so you can chain setters
*/
public Builder urlPattern (String urlPattern)
{
if (urlPattern == null || "".equals (urlPattern))
{
current.prefix = "";
current.postfix = "";
}
else
{
int pos = urlPattern.indexOf("$ID");
if (pos == -1) throw new IllegalArgumentException("Url maker pattern for " + current + "' should have $ID in it");
current.prefix = urlPattern.substring(0, pos);
current.postfix = urlPattern.substring(pos + 3);
}
return this;
}
/**
* @param mainUrl url of homepage
* @return the same Builder object so you can chain setters
*/
public Builder mainUrl (String mainUrl)
{
current.mainUrl = mainUrl;
return this;
}
/**
* @param idExample an example id from this system
* @return the same Builder object so you can chain setters
*/
public Builder idExample (String idExample)
{
current.idExample = idExample;
return this;
}
/**
* @param isPrimary secondary id's such as EC numbers, Gene Ontology or vendor-specific systems occur in data or linkouts,
* but their use in pathways is discouraged
* @return the same Builder object so you can chain setters
*/
public Builder primary (boolean isPrimary)
{
current.isPrimary = isPrimary;
return this;
}
/**
* @param type the type of datasource, for example "protein", "gene", "metabolite"
* @return the same Builder object so you can chain setters
*/
public Builder type (String type)
{
current.type = type;
return this;
}
/**
* @param organism organism for which this system code is suitable, or null for any / not applicable
* @return the same Builder object so you can chain setters
*/
public Builder organism (Object organism)
{
current.organism = organism;
return this;
}
/**
* @param base for urn generation, for example "urn:miriam:uniprot"
* @return the same Builder object so you can chain setters
*/
public Builder urnBase (String base)
{
current.urnBase = base;
return this;
}
}
/**
* Register a new DataSource with (optional) detailed information.
* This can be used by other modules to define new DataSources.
* @param sysCode short unique code between 1-4 letters, originally used by GenMAPP
* @param fullName full name used in GPML. Must be 20 or less characters
* @return Builder that can be used for adding detailed information.
*/
public static Builder register(String sysCode, String fullName)
{
DataSource current = null;
if (fullName == null && sysCode == null) throw new NullPointerException();
// if (fullName != null && fullName.length() > 20)
// {
// throw new IllegalArgumentException("full Name '" + fullName + "' must be 20 or less characters");
// }
if (byFullName.containsKey(fullName))
{
current = byFullName.get(fullName);
}
else if (bySysCode.containsKey(sysCode))
{
current = bySysCode.get(sysCode);
}
else
{
current = new DataSource ();
registry.add (current);
}
current.sysCode = sysCode;
current.fullName = fullName;
if (isSuitableKey(sysCode))
bySysCode.put(sysCode, current);
if (isSuitableKey(fullName))
byFullName.put(fullName, current);
return new Builder(current);
}
/**
* Helper method to determine if a String is allowed as key for bySysCode and byFullname hashes.
* Null values and empty strings are not allowed.
* @param key key to check.
* @return true if the key is allowed
*/
private static boolean isSuitableKey(String key)
{
return !(key == null || "".equals(key));
}
/**
* @param systemCode short unique code to query for
* @return pre-existing DataSource object by system code,
* if it exists, or creates a new one.
*/
public static DataSource getBySystemCode(String systemCode)
{
if (!bySysCode.containsKey(systemCode) && isSuitableKey(systemCode))
{
register (systemCode, null);
}
return bySysCode.get(systemCode);
}
/**
* returns pre-existing DataSource object by
* full name, if it exists,
* or creates a new one.
* @param fullName full name to query for
* @return DataSource
*/
public static DataSource getByFullName(String fullName)
{
if (!byFullName.containsKey(fullName) && isSuitableKey(fullName))
{
register (null, fullName);
}
return byFullName.get(fullName);
}
/**
get all registered datasoures as a set.
@return set of all registered DataSources
*/
static public Set