1 /* 2 * The Apache Software License, Version 1.1 3 * 4 * Copyright (c) 2001-2004 Caucho Technology, Inc. All rights reserved. 5 * 6 * Redistribution and use in source and binary forms, with or without 7 * modification, are permitted provided that the following conditions 8 * are met: 9 * 10 * 1. Redistributions of source code must retain the above copyright 11 * notice, this list of conditions and the following disclaimer. 12 * 13 * 2. Redistributions in binary form must reproduce the above copyright 14 * notice, this list of conditions and the following disclaimer in 15 * the documentation and/or other materials provided with the 16 * distribution. 17 * 18 * 3. The end-user documentation included with the redistribution, if 19 * any, must include the following acknowlegement: 20 * "This product includes software developed by the 21 * Caucho Technology (http://www.caucho.com/)." 22 * Alternately, this acknowlegement may appear in the software itself, 23 * if and wherever such third-party acknowlegements normally appear. 24 * 25 * 4. The names "Burlap", "Resin", and "Caucho" must not be used to 26 * endorse or promote products derived from this software without prior 27 * written permission. For written permission, please contact 28 * info@caucho.com. 29 * 30 * 5. Products derived from this software may not be called "Resin" 31 * nor may "Resin" appear in their names without prior written 32 * permission of Caucho Technology. 33 * 34 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED 35 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 36 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 37 * DISCLAIMED. IN NO EVENT SHALL CAUCHO TECHNOLOGY OR ITS CONTRIBUTORS 38 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, 39 * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT 40 * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR 41 * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 42 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE 43 * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN 44 * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 45 * 46 * @author Scott Ferguson 47 */ 48 49 package com.caucho.services.client; 50 51 /** 52 * Factory for creating client stubs. The returned stub will 53 * call the remote object for all methods. 54 * 55 * <pre> 56 * URL url = new URL("http://localhost:8080/ejb/hello"); 57 * HelloHome hello = (HelloHome) factory.create(HelloHome.class, url); 58 * </pre> 59 * 60 * After creation, the stub can be like a regular Java class. Because 61 * it makes remote calls, it can throw more exceptions than a Java class. 62 * In particular, it may throw protocol exceptions. 63 */ 64 public interface ServiceProxyFactory { 65 /** 66 * Creates a new proxy with the specified URL. The returned object 67 * is a proxy with the interface specified by api. 68 * 69 * <pre> 70 * String url = "http://localhost:8080/ejb/hello"); 71 * HelloHome hello = (HelloHome) factory.create(HelloHome.class, url); 72 * </pre> 73 * 74 * @param api the interface the proxy class needs to implement 75 * @param url the URL where the client object is located. 76 * 77 * @return a proxy to the object with the specified interface. 78 */ 79 public Object create(Class api, String url) 80 throws java.net.MalformedURLException; 81 } 82