1f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes/* 2adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Licensed to the Apache Software Foundation (ASF) under one or more 3adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * contributor license agreements. See the NOTICE file distributed with 4adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * this work for additional information regarding copyright ownership. 5adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * The ASF licenses this file to You under the Apache License, Version 2.0 6adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * (the "License"); you may not use this file except in compliance with 7adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the License. You may obtain a copy of the License at 8f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 9adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 10f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 11adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Unless required by applicable law or agreed to in writing, software 12adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 13adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * See the License for the specific language governing permissions and 15adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * limitations under the License. 16adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 17adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 18adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectpackage java.sql; 19adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 20adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectimport java.util.Map; 21adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 22adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project/** 23adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * This interface represents an SQL Ref - a data object containing a cursor 24adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * or pointer to a result table. 25adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * <p> 26f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * The data structure identified by an instance of Ref is held in the 27adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * database, so the data is not necessarily read and converted 28f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * into a Java object until {@code getObject} is called. However, if 29f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * the database supports the {@code Ref} type, it is not typically 30adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * necessary to get the underlying object before using it in a method call - 31adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the {@code Ref} object can be used in place of the data structure. 32142d526f8bf90fb9bb63c637beb5299f39791f55Jesse Wilson * <p> 33adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * A {@code Ref} object is stored into the database using the 34adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@link PreparedStatement#setRef(int, Ref)} method. 35adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 36adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectpublic interface Ref { 37adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 38adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 39adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Gets the fully-qualified SQL name of the SQL structured type that this 40adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * {@code Ref} references. 41f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 42adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the fully qualified name of the SQL structured type. 43adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws SQLException 44adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if there is a database error. 45adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 46adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public String getBaseTypeName() throws SQLException; 47adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 48adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 49adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Gets the SQL structured type instance referenced by this {@code Ref}. 50f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 51adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return a Java object whose type is defined by the mapping for the SQL 52adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * structured type. 53adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws SQLException 54adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if there is a database error. 55adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 56adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public Object getObject() throws SQLException; 57adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 58adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 59adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns the associated object and uses the relevant mapping to convert it 60adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * to a Java type. 61f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 62adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param map 63adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the mapping for type conversion. 64adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return a Java object whose type is defined by the mapping for the SQL 65adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * structured type. 66adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws SQLException 67adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if there is a database error. 68adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 69adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public Object getObject(Map<String, Class<?>> map) throws SQLException; 70adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 71adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 72adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Sets the value of the structured type that this {@code Ref} references to 73adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * a supplied object. 74f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 75adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param value 76adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the {@code Object} representing the new SQL structured type 77adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * that this {@code Ref} references. 78adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws SQLException 79adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if there is a database error. 80adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 81adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public void setObject(Object value) throws SQLException; 82adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project} 83