1 /* 2 * JBoss, Home of Professional Open Source 3 * Copyright 2005, JBoss Inc., and individual contributors as indicated 4 * by the @authors tag. See the copyright.txt in the distribution for a 5 * full listing of individual contributors. 6 * 7 * This is free software; you can redistribute it and/or modify it 8 * under the terms of the GNU Lesser General Public License as 9 * published by the Free Software Foundation; either version 2.1 of 10 * the License, or (at your option) any later version. 11 * 12 * This software is distributed in the hope that it will be useful, 13 * but WITHOUT ANY WARRANTY; without even the implied warranty of 14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 15 * Lesser General Public License for more details. 16 * 17 * You should have received a copy of the GNU Lesser General Public 18 * License along with this software; if not, write to the Free 19 * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 20 * 02110-1301 USA, or see the FSF site: http://www.fsf.org. 21 */ 22 package org.jboss.invocation.iiop; 23 24 import org.omg.PortableServer.POA; 25 26 /** 27 * Interface of a CORBA reference factory. Such a factory encapsulates a POA 28 * and provides reference creation methods. 29 * 30 * @author <a HREF="mailto:reverbel@ime.usp.br">Francisco Reverbel</a> 31 * @version $Revision: 37459 $ 32 */ 33 public interface ReferenceFactory 34 { 35 36 /** 37 * Creates a reference with a null id in its "reference data" and 38 * with object type information given by the <code>interfId</code> 39 * parameter. 40 */ 41 org.omg.CORBA.Object createReference(String inferfId) throws Exception; 42 43 /** 44 * Creates a reference with the specified <code>id</code> in its 45 * "reference data" and with object type information given by the 46 * <code>interfId</code> parameter. 47 */ 48 org.omg.CORBA.Object createReferenceWithId(Object id, String interfId) 49 throws Exception; 50 51 /** 52 * Returns a reference to the POA encapsulated by this 53 * <code>ReferenceFactory</code>. 54 */ 55 POA getPOA(); 56 57 } 58