Add "safe type casting" warnings

[jabaws.git] / webservices / compbio / data / msa / RegistryWS.java

diff --git a/webservices/compbio/data/msa/RegistryWS.java b/webservices/compbio/data/msa/RegistryWS.java
index 123546d..e2ce9a4 100644 (file)
--- a/webservices/compbio/data/msa/RegistryWS.java
+++ b/webservices/compbio/data/msa/RegistryWS.java
@@ -1,3 +1,20 @@
+/* Copyright (c) 2011 Peter Troshin\r
+ *  \r
+ *  JAva Bioinformatics Analysis Web Services (JABAWS) @version: 2.0     \r
+ * \r
+ *  This library is free software; you can redistribute it and/or modify it under the terms of the\r
+ *  Apache License version 2 as published by the Apache Software Foundation\r
+ * \r
+ *  This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without\r
+ *  even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the Apache \r
+ *  License for more details.\r
+ * \r
+ *  A copy of the license is in apache_license.txt. It is also available here:\r
+ * @see: http://www.apache.org/licenses/LICENSE-2.0.txt\r
+ * \r
+ * Any republication or derived work distributed in source code form\r
+ * must include this copyright and license notice.\r
+ */\r
 package compbio.data.msa;\r
 \r
 import java.util.Date;\r
@@ -28,11 +45,21 @@ public interface RegistryWS extends JABAService {
         */\r
        Set<Services> getSupportedServices();\r
        /**\r
+        * List of services that are functioning on the server. This function\r
+        * returns the results of testing performed some time ago by\r
+        * {@link #testAllServices} or {@link #testService(Services)} methods. The\r
+        * time of last check can be obtained from\r
+        * {@link #getLastTestedOn(Services)} method\r
+        * \r
+        * @return the Set of Services which are functioning on the server\r
+        * @see #testAllServices()\r
+        */\r
+       Set<Services> getNonoperatedServices(); /**\r
         * Number of seconds since the last test. Returns 0 if the service was not\r
         * tested or tested less then a one second ago.\r
         * \r
         * @param service\r
-        * @return\r
+        * @return when last time tested\r
         */\r
        int getLastTested(Services service);\r
        /**\r
@@ -63,4 +90,22 @@ public interface RegistryWS extends JABAService {
         */\r
        boolean isOperating(Services service);\r
 \r
+       /**\r
+        * Gives the description of the service.\r
+        * \r
+        * @param service\r
+        * @return String, plain text or html formatted piece, but NOT a full html\r
+        *         document\r
+        */\r
+       String getServiceDescription(Services service);\r
+\r
+       /**\r
+        * Gets the list of services per category. ServiceClassifier has the method\r
+        * that returns Map<Category, Set<Services>>\r
+        * \r
+        * @return ServiceClassifier the object to represent relation between\r
+        *         Services and Categories\r
+        */\r
+       Set<Category> getServiceCategories();\r
+\r
 }\r