JAL-1645 Version-Rel Version 2.9 Year-Rel 2015 Licensing glob

[jalview.git] / src / jalview / ws / dbsources / das / api / jalviewSourceI.java

diff --git a/src/jalview/ws/dbsources/das/api/jalviewSourceI.java b/src/jalview/ws/dbsources/das/api/jalviewSourceI.java
index fef6a0b..79d003f 100644 (file)
--- a/src/jalview/ws/dbsources/das/api/jalviewSourceI.java
+++ b/src/jalview/ws/dbsources/das/api/jalviewSourceI.java
@@ -1,9 +1,29 @@
+/*
+ * Jalview - A Sequence Alignment Editor and Viewer (Version 2.9)
+ * Copyright (C) 2015 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 <http://www.gnu.org/licenses/>.
+ * The Jalview Authors are detailed in the 'AUTHORS' file.
+ */
 package jalview.ws.dbsources.das.api;
 
-import java.util.List;
-
 import jalview.ws.seqfetcher.DbSourceProxy;
 
+import java.util.List;
+
 import org.biodas.jdas.schema.sources.MAINTAINER;
 import org.biodas.jdas.schema.sources.VERSION;
 
@@ -34,7 +54,9 @@ public interface jalviewSourceI
 
   /**
    * 
-   * @return null if not a sequence source, otherwise a series of database sources that can be used to retrieve sequence data for particular database coordinate systems
+   * @return null if not a sequence source, otherwise a series of database
+   *         sources that can be used to retrieve sequence data for particular
+   *         database coordinate systems
    */
   List<DbSourceProxy> getSequenceSourceProxies();
 
@@ -42,8 +64,24 @@ public interface jalviewSourceI
 
   /**
    * returns the base URL for the latest version of a source's DAS endpoint set
+   * 
    * @return
    */
   String getSourceURL();
 
+  /**
+   * test to see if this source's latest version is older than the given source
+   * 
+   * @param jalviewSourceI
+   * @return true if newer than given source
+   */
+  boolean isNewerThan(jalviewSourceI jalviewSourceI);
+
+  /**
+   * test if the source is a reference source for the authority
+   * 
+   * @return
+   */
+  boolean isReferenceSource();
+
 }