001    /*
002     * The Apache Software License, Version 1.1
003     *
004     * Copyright (c) 2001-2004 Caucho Technology, Inc.  All rights reserved.
005     *
006     * Redistribution and use in source and binary forms, with or without
007     * modification, are permitted provided that the following conditions
008     * are met:
009     *
010     * 1. Redistributions of source code must retain the above copyright
011     *    notice, this list of conditions and the following disclaimer.
012     *
013     * 2. Redistributions in binary form must reproduce the above copyright
014     *    notice, this list of conditions and the following disclaimer in
015     *    the documentation and/or other materials provided with the
016     *    distribution.
017     *
018     * 3. The end-user documentation included with the redistribution, if
019     *    any, must include the following acknowlegement:
020     *       "This product includes software developed by the
021     *        Caucho Technology (http://www.caucho.com/)."
022     *    Alternately, this acknowlegement may appear in the software itself,
023     *    if and wherever such third-party acknowlegements normally appear.
024     *
025     * 4. The names "Burlap", "Resin", and "Caucho" must not be used to
026     *    endorse or promote products derived from this software without prior
027     *    written permission. For written permission, please contact
028     *    info@caucho.com.
029     *
030     * 5. Products derived from this software may not be called "Resin"
031     *    nor may "Resin" appear in their names without prior written
032     *    permission of Caucho Technology.
033     *
034     * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
035     * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
036     * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
037     * DISCLAIMED.  IN NO EVENT SHALL CAUCHO TECHNOLOGY OR ITS CONTRIBUTORS
038     * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
039     * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
040     * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
041     * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
042     * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
043     * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
044     * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
045     *
046     * @author Scott Ferguson
047     */
048    
049    package com.caucho.services.client;
050    
051    /**
052     * Factory for creating client stubs.  The returned stub will
053     * call the remote object for all methods.
054     *
055     * <pre>
056     * URL url = new URL("http://localhost:8080/ejb/hello");
057     * HelloHome hello = (HelloHome) factory.create(HelloHome.class, url);
058     * </pre>
059     *
060     * After creation, the stub can be like a regular Java class.  Because
061     * it makes remote calls, it can throw more exceptions than a Java class.
062     * In particular, it may throw protocol exceptions.
063     */
064    public interface ServiceProxyFactory {
065      /**
066       * Creates a new proxy with the specified URL.  The returned object
067       * is a proxy with the interface specified by api.
068       *
069       * <pre>
070       * String url = "http://localhost:8080/ejb/hello");
071       * HelloHome hello = (HelloHome) factory.create(HelloHome.class, url);
072       * </pre>
073       *
074       * @param api the interface the proxy class needs to implement
075       * @param url the URL where the client object is located.
076       *
077       * @return a proxy to the object with the specified interface.
078       */
079      public Object create(Class api, String url)
080        throws java.net.MalformedURLException;
081    }