src/share/doc/stub/java/rmi/activation/ActivationGroup_Stub.java

/*
 * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

package java.rmi.activation;

/**
 * <code>ActivationGroup_Stub</code> is a stub class
 * for the subclasses of <code>java.rmi.activation.ActivationGroup</code>
 * that are exported as a <code>java.rmi.server.UnicastRemoteObject</code>.
 *
 * @since       1.2
 */
public final class ActivationGroup_Stub
    extends java.rmi.server.RemoteStub
    implements java.rmi.activation.ActivationInstantiator, java.rmi.Remote
{
    /**
     * Constructs a stub for the <code>ActivationGroup</code> class.  It
     * invokes the superclass <code>RemoteStub(RemoteRef)</code>
     * constructor with its argument, <code>ref</code>.
     *
     * @param   ref a remote ref
     */
    public ActivationGroup_Stub(java.rmi.server.RemoteRef ref) {
    }

    /**
     * Stub method for <code>ActivationGroup.newInstance</code>.  Invokes
     * the <code>invoke</code> method on this instance's
     * <code>RemoteObject.ref</code> field, with <code>this</code> as the
     * first argument, a two-element <code>Object[]</code> as the second
     * argument (with <code>id</code> as the first element and
     * <code>desc</code> as the second element), and -5274445189091581345L
     * as the third argument, and returns the result.  If that invocation
     * throws a <code>RuntimeException</code>, <code>RemoteException</code>,
     * or an <code>ActivationException</code>, then that exception is
     * thrown to the caller.  If that invocation throws any other
     * <code>java.lang.Exception</code>, then a
     * <code>java.rmi.UnexpectedException</code> is thrown to the caller
     * with the original exception as the cause.
     *
     * @param   id an activation identifier
     * @param   desc an activation descriptor
     * @return  the result of the invocation
     * @throws  java.rmi.RemoteException if invocation results in
     *          a <code>RemoteException</code>
     * @throws  java.rmi.activation.ActivationException if invocation
     *          results in an <code>ActivationException</code>
     */
    public java.rmi.MarshalledObject newInstance(
                                java.rmi.activation.ActivationID id,
                                java.rmi.activation.ActivationDesc desc)
        throws java.rmi.RemoteException,
            java.rmi.activation.ActivationException
    {
        return null;
    }
}