home *** CD-ROM | disk | FTP | other *** search
/ Java 1.2 How-To / JavaHowTo.iso / 3rdParty / jbuilder / unsupported / JDK1.2beta3 / SOURCE / SRC.ZIP / java / sql / Ref.java < prev    next >
Encoding:
Java Source  |  1998-03-20  |  1.3 KB  |  52 lines
  1. /*
  2.  * @(#)Ref.java    1.3 98/03/18
  3.  *
  4.  * Copyright 1998 by Sun Microsystems, Inc.,
  5.  * 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
  6.  * All rights reserved.
  7.  *
  8.  * This software is the confidential and proprietary information
  9.  * of Sun Microsystems, Inc. ("Confidential Information").  You
  10.  * shall not disclose such Confidential Information and shall use
  11.  * it only in accordance with the terms of the license agreement
  12.  * you entered into with Sun.
  13.  */
  14.  
  15. package java.sql;
  16.  
  17. /**
  18.  * JDBC 2.0
  19.  *
  20.  * A Ref is a reference to an SQL structured value in the database.  A
  21.  * Ref can be saved to persistent storage.
  22.  */
  23.  
  24. public interface Ref {
  25.  
  26.   /**
  27.   * @return a descriptor representing the Structured Type of the
  28.   * referenced item.
  29.   *
  30.   */
  31.   SQLType getBaseType ();
  32.  
  33.   /**
  34.   * Materialize the referenced item (by selecting it from
  35.   * the table "scope" where it is stored in the database).
  36.   *  
  37.   * @return an object representing the referenced SQL item
  38.   */
  39.   Object getObject ();
  40.  
  41.   /**
  42.   * Materialize the referenced item (by selecting it from
  43.   * the table "scope" where it is stored in the database).
  44.   *  
  45.   * @param map contains mapping of SQL user-defined type names to classes.
  46.   * @return an object representing the referenced SQL item
  47.   */
  48.   Object getObject (java.util.Map map);
  49.  
  50. }
  51.  
  52.