1 /* 2 * The contents of this file are subject to the terms 3 * of the Common Development and Distribution License 4 * (the License). You may not use this file except in 5 * compliance with the License. 6 * 7 * You can obtain a copy of the license at 8 * https://glassfish.dev.java.net/public/CDDLv1.0.html or 9 * glassfish/bootstrap/legal/CDDLv1.0.txt. 10 * See the License for the specific language governing 11 * permissions and limitations under the License. 12 * 13 * When distributing Covered Code, include this CDDL 14 * Header Notice in each file and include the License file 15 * at glassfish/bootstrap/legal/CDDLv1.0.txt. 16 * If applicable, add the following below the CDDL Header, 17 * with the fields enclosed by brackets [] replaced by 18 * you own identifying information: 19 * "Portions Copyrighted [year] [name of copyright owner]" 20 * 21 * Copyright 2006 Sun Microsystems, Inc. All rights reserved. 22 */ 23 24 package javax.resource; 25 26 import javax.naming.Reference; 27 28 /** The Referenceable interface extends the javax.naming.Referenceable 29 * interface. It enables support for JNDI Reference mechanism for 30 * the registration of the connection factory in the JNDI name space. 31 * Note that the implementation and structure of Reference is specific 32 * to an application server. 33 * 34 * <p>The implementation class for a connection factory interface is 35 * required to implement both java.io.Serializable and 36 * javax.resource.Referenceable interfaces to support JNDI registration. 37 * 38 * @version 0.9 39 * @author Rahul Sharma 40 * 41 **/ 42 43 public interface Referenceable extends javax.naming.Referenceable { 44 45 /** Sets the Reference instance. This method is called by the 46 * deployment code to set the Reference that can be later 47 * returned by the getReference method (as defined in the 48 * javax.naming.Referenceable interface). 49 * 50 * @param reference A Reference instance 51 * @see javax.naming.Referenceable#getReference 52 * 53 **/ 54 public 55 void setReference(Reference reference); 56 57 } 58