/* * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$) * Copyright (C) $$Year-Rel$$ The Jalview Authors * * This file is part of Jalview. * * Jalview 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. * * Jalview 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 Jalview. If not, see . * The Jalview Authors are detailed in the 'AUTHORS' file. */ package jalview.ext.ensembl; import java.util.Locale; import jalview.datamodel.AlignmentI; import jalview.datamodel.DBRefSource; import jalview.util.JSONUtils; import java.io.BufferedReader; import java.io.IOException; import java.net.MalformedURLException; import java.net.URL; import java.util.HashMap; import java.util.Iterator; import java.util.List; import java.util.Map; import java.util.Set; import org.json.simple.parser.ParseException; public class EnsemblInfo extends EnsemblRestClient { /* * cached results of REST /info/divisions service, currently *
   * { 
   *  { "ENSEMBLFUNGI", "http://rest.ensemblgenomes.org"},
   *    "ENSEMBLBACTERIA", "http://rest.ensemblgenomes.org"},
   *    "ENSEMBLPROTISTS", "http://rest.ensemblgenomes.org"},
   *    "ENSEMBLMETAZOA", "http://rest.ensemblgenomes.org"},
   *    "ENSEMBLPLANTS",  "http://rest.ensemblgenomes.org"},
   *    "ENSEMBL", "http://rest.ensembl.org" }
   *  }
   * 
* The values for EnsemblGenomes are retrieved by a REST call, that for * Ensembl is added programmatically for convenience of lookup */ private static Map divisions; @Override public String getDbName() { return "ENSEMBL"; } @Override public AlignmentI getSequenceRecords(String queries) throws Exception { return null; } @Override protected URL getUrl(List ids) throws MalformedURLException { return null; } @Override protected boolean useGetRequest() { return true; } /** * Answers the domain (http://rest.ensembl.org or * http://rest.ensemblgenomes.org) for the given division, or null if not * recognised by Ensembl. * * @param division * @return */ public String getDomain(String division) { if (divisions == null) { fetchDivisions(); } return divisions.get(division.toUpperCase(Locale.ROOT)); } /** * On first request only, populate the lookup map by fetching the list of * divisions known to EnsemblGenomes. */ void fetchDivisions() { divisions = new HashMap<>(); /* * for convenience, pre-fill ensembl.org as the domain for "ENSEMBL" */ divisions.put(DBRefSource.ENSEMBL.toUpperCase(Locale.ROOT), ensemblDomain); try { @SuppressWarnings("unchecked") Iterator rvals = (Iterator) getJSON( getDivisionsUrl(ensemblGenomesDomain), null, -1, MODE_ITERATOR, null); if (rvals == null) return; while (rvals.hasNext()) { String division = rvals.next().toString(); divisions.put(division.toUpperCase(Locale.ROOT), ensemblGenomesDomain); } } catch (IOException | ParseException | NumberFormatException e) { // ignore } } /** * Constructs the URL for the EnsemblGenomes /info/divisions REST service * * @param domain * TODO * * @return * @throws MalformedURLException */ URL getDivisionsUrl(String domain) throws MalformedURLException { return new URL( domain + "/info/divisions?content-type=application/json"); } /** * Returns the set of 'divisions' recognised by Ensembl or EnsemblGenomes * * @return */ public Set getDivisions() { if (divisions == null) { fetchDivisions(); } return divisions.keySet(); } }