Mercurial > jdk8-mips64-public > corba / file revision

 /*

  * Copyright (c) 1998, 2007, 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.

  */

 /*

  * Licensed Materials - Property of IBM

  * RMI-IIOP v1.0

  * Copyright IBM Corp. 1998 1999  All Rights Reserved

  *

  */

 package sun.rmi.rmic.iiop;

 import java.util.Vector;

 import sun.tools.java.CompilerError;

 import sun.tools.java.ClassDefinition;

 import sun.tools.java.ClassNotFound;

 /**

  * RemoteType represents any non-special interface which inherits

  * from java.rmi.Remote.

  * <p>

  * The static forRemote(...) method must be used to obtain an instance, and will

  * return null if the ClassDefinition is non-conforming.

  * @author      Bryan Atsatt

  */

 public class RemoteType extends InterfaceType {

     //_____________________________________________________________________

     // Public Interfaces

     //_____________________________________________________________________

     /**

      * Create an RemoteType for the given class.

      *

      * If the class is not a properly formed or if some other error occurs, the

      * return value will be null, and errors will have been reported to the

      * supplied BatchEnvironment.

      */

     public static RemoteType forRemote(ClassDefinition classDef,

                                        ContextStack stack,

                                        boolean quiet) {

         if (stack.anyErrors()) return null;

         boolean doPop = false;

         RemoteType result = null;

         try {

             // Do we already have it?

             sun.tools.java.Type theType = classDef.getType();

             Type existing = getType(theType,stack);

             if (existing != null) {

                 if (!(existing instanceof RemoteType)) return null; // False hit.

                                 // Yep, so return it...

                 return (RemoteType) existing;

             }

             // Could this be a remote type?

             if (couldBeRemote(quiet,stack,classDef)) {

                 // Yes, so check it...

                 RemoteType it = new RemoteType(stack,classDef);

                 putType(theType,it,stack);

                 stack.push(it);

                 doPop = true;

                 if (it.initialize(quiet,stack)) {

                     stack.pop(true);

                     result = it;

                 } else {

                     removeType(theType,stack);

                     stack.pop(false);

                 }

             }

         } catch (CompilerError e) {

             if (doPop) stack.pop(false);

         }

         return result;

     }

     /**

      * Return a string describing this type.

      */

     public String getTypeDescription () {

         return "Remote interface";

     }

     //_____________________________________________________________________

     // Internal/Subclass Interfaces

     //_____________________________________________________________________

     /**

      * Create a RemoteType instance for the given class.  The resulting

      * object is not yet completely initialized.

      */

     protected RemoteType(ContextStack stack, ClassDefinition classDef) {

         super(stack,classDef,TYPE_REMOTE | TM_INTERFACE | TM_COMPOUND);

     }

     /**

      * Create a RemoteType instance for the given class.  The resulting

      * object is not yet completely initialized.

      */

     protected RemoteType(ContextStack stack, ClassDefinition classDef, int typeCode) {

         super(stack,classDef,typeCode);

     }

     //_____________________________________________________________________

     // Internal Interfaces

     //_____________________________________________________________________

     private static boolean couldBeRemote (boolean quiet, ContextStack stack,

                                           ClassDefinition classDef) {

         boolean result = false;

         BatchEnvironment env = stack.getEnv();

         try {

             if (!classDef.isInterface()) {

                 failedConstraint(16,quiet,stack,classDef.getName());

             } else {

                 result = env.defRemote.implementedBy(env,classDef.getClassDeclaration());

                 if (!result) failedConstraint(1,quiet,stack,classDef.getName());

             }

         } catch (ClassNotFound e) {

             classNotFound(stack,e);

         }

         return result;

     }

     /**

      * Initialize this instance.

      */

     private boolean initialize (boolean quiet,ContextStack stack) {

         boolean result = false;

         // Go check it out and gather up the info we need...

         Vector directInterfaces = new Vector();

         Vector directMethods = new Vector();

         Vector directConstants = new Vector();

         if (isConformingRemoteInterface(directInterfaces,

                                         directMethods,

                                         directConstants,

                                         quiet,

                                         stack)){

             // We're ok, so pass 'em up...

             result = initialize(directInterfaces,directMethods,directConstants,stack,quiet);

         }

         return result;

     }

     /**

      * Check to ensure that the interface and all it's methods and arguments

      * conforms to the RMI/IDL java subset for remote interfaces as defined

      * by the "Java to IDL Mapping" specification, section 4.

      * @param directInterfaces All directly implmented interfaces will be

      *   added to this list.

      * @param directMethods All directly implemented methods (other than

      *  constructors and initializers) will be added to this list.

      * @param directConstants All constants defined by theInterface will be

      *  added to this list.

      * @param quiet True if should not report constraint failures.

      * @return true if constraints satisfied, false otherwise.

      */

     private boolean isConformingRemoteInterface (       Vector directInterfaces,

                                                         Vector directMethods,

                                                         Vector directConstants,

                                                         boolean quiet,

                                                         ContextStack stack) {

         ClassDefinition theInterface = getClassDefinition();

         try {

             // Get all remote interfaces...

             if (addRemoteInterfaces(directInterfaces,false,stack) == null ) {

                 return false;

             }

             // Make sure all constants are conforming...

             if (!addAllMembers(directConstants,true,quiet,stack)) {

                 return false;

             }

             // Now, collect up all methods...

             if (addAllMethods(theInterface,directMethods,true,quiet,stack) == null) {

                 // Failed a constraint check...

                 return false;

             }

             // Now walk 'em, ensuring each is a valid remote method...

             boolean methodsConform = true;

             for (int i = 0; i < directMethods.size(); i++) {

                 if (! isConformingRemoteMethod((Method) directMethods.elementAt(i),quiet)) {

                     methodsConform = false;

                 }

             }

             if (!methodsConform) {

                 return false;

             }

         } catch (ClassNotFound e) {

             classNotFound(stack,e);

             return false;

         }

         return true;

     }

 }