--- /dev/null
+/*\r
+\r
+ Derby - Class org.apache.derby.catalog.DependableFinder\r
+\r
+ Licensed to the Apache Software Foundation (ASF) under one or more\r
+ contributor license agreements. See the NOTICE file distributed with\r
+ this work for additional information regarding copyright ownership.\r
+ The ASF licenses this file to You under the Apache License, Version 2.0\r
+ (the "License"); you may not use this file except in compliance with\r
+ the License. You may obtain a copy of the License at\r
+\r
+ http://www.apache.org/licenses/LICENSE-2.0\r
+\r
+ Unless required by applicable law or agreed to in writing, software\r
+ distributed under the License is distributed on an "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
+ See the License for the specific language governing permissions and\r
+ limitations under the License.\r
+\r
+ */\r
+\r
+package org.apache.derby.catalog;\r
+\r
+import java.sql.SQLException;\r
+\r
+import org.apache.derby.iapi.error.StandardException;\r
+import org.apache.derby.iapi.sql.dictionary.DataDictionary;\r
+\r
+/**\r
+ \r
+ A DependableFinder is an object that can find an in-memory\r
+ Dependable, given the Dependable's ID.\r
+ \r
+ \r
+ <P>\r
+ The DependableFinder is able to write itself to disk and,\r
+ once read back into memory, locate the in-memory Dependable that it\r
+ represents.\r
+\r
+ <P>\r
+ DependableFinder objects are stored in SYS.SYSDEPENDS to record\r
+ dependencies between database objects.\r
+ */\r
+public interface DependableFinder\r
+{\r
+ /**\r
+ * Get the in-memory object associated with the passed-in object ID.\r
+ *\r
+ * @param dd DataDictionary to use for lookup.\r
+ * @param dependableObjectID the ID of a Dependable. Used to locate that Dependable.\r
+ *\r
+ * @return the associated Dependable\r
+ * @exception StandardException thrown if the object cannot be found or on error o\r
+ */\r
+ public Dependable getDependable(DataDictionary dd,\r
+ UUID dependableObjectID) throws StandardException;\r
+\r
+ /**\r
+ * The name of the class of Dependables as a "SQL Object" which this\r
+ * Finder can find.\r
+ * This is a value like "Table" or "View".\r
+ * Every DependableFinder can find some class of Dependables. \r
+ *\r
+ *\r
+ * @return String type of the "SQL Object" which this Finder can find.\r
+ * @see Dependable\r
+ */\r
+ public String getSQLObjectType();\r
+}\r