Tuesday, March 10, 2015

IDLTypeException

com.sun.corba.se.impl.presentation.rmi.IDLTypeException

IDLTypeException is described in the javadoc comments as:

Checked exception containing information about an an IDL type validation.

Where is this exception thrown?

Following, is a list of exception messages cross-referenced to the source code responsible for throwing them. Click on the method link to view the code and see how the exception is thrown.

How is this exception thrown?

The following sub-sections identify where this exception is thrown, and how (or why) the code is throwing the exception.

Any source code quoted in this section is subject to the Java Research License unless stated otherwise.

com.sun.corba.se.impl.presentation.rmi.IDLTypesUtil.validateConstants(Class)

/**
     * Implements 1.2.3 #6
     */
private void validateConstants(final Class c) throws IDLTypeException {
    Field[] fields = null;
    try {
        fields = (Field[]) java.security.AccessController.doPrivileged(new java.security.PrivilegedExceptionAction() {

            public java.lang.Object run() throws Exception {
                return c.getFields();
            }
        });
    } catch (java.security.PrivilegedActionException pae) {
        IDLTypeException ite = new IDLTypeException();
        ite.initCause(pae);
        throw ite;
    }
    for (int i = 0; i < fields.length; i++) {
        Field next = fields[i];
        Class fieldType = next.getType();
        if ((fieldType != java.lang.String.class) && !isPrimitive(fieldType)) {
            String msg = 'Constant field '' + next.getName() + '' in class '' + next.getDeclaringClass().getName() + '' has invalid type' ' + next.getType() + ''. Constants' + ' in RMI/IIOP interfaces can only have primitive' + ' types and java.lang.String types.';
            throw new IDLTypeException(msg);
        }
    }
    return;
}

Source: "Java SE Downloads: Java SE 6 JDK Source Code", at: http://www.oracle.com/technetwork/java/javase/downloads/index.html

com.sun.corba.se.impl.presentation.rmi.IDLTypesUtil.validateDirectInterfaces(Class)

/**
     * Implements Section 1.2.3, #5.
     */
private void validateDirectInterfaces(Class c) throws IDLTypeException {
    Class[] directInterfaces = c.getInterfaces();
    if (directInterfaces.length < 2) {
        return;
    }
    Set allMethodNames = new HashSet();
    Set currentMethodNames = new HashSet();
    for (int i = 0; i < directInterfaces.length; i++) {
        Class next = directInterfaces[i];
        Method[] methods = next.getMethods();
        currentMethodNames.clear();
        for (int m = 0; m < methods.length; m++) {
            currentMethodNames.add(methods[m].getName());
        }
        for (Iterator iter = currentMethodNames.iterator(); iter.hasNext(); ) {
            String methodName = (String) iter.next();
            if (allMethodNames.contains(methodName)) {
                String msg = 'Class ' + c + ' inherits method ' + methodName + ' from multiple direct interfaces.';
                throw new IDLTypeException(msg);
            } else {
                allMethodNames.add(methodName);
            }
        }
    }
    return;
}

Source: "Java SE Downloads: Java SE 6 JDK Source Code", at: http://www.oracle.com/technetwork/java/javase/downloads/index.html

com.sun.corba.se.impl.presentation.rmi.IDLTypesUtil.validateExceptions(Method)

/**
     * Implements 1.2.3 #2 and #4
     */
private void validateExceptions(Method method) throws IDLTypeException {
    Class[] exceptions = method.getExceptionTypes();
    boolean declaresRemoteExceptionOrSuperClass = false;
    for (int eIndex = 0; eIndex < exceptions.length; eIndex++) {
        Class exception = exceptions[eIndex];
        if (isRemoteExceptionOrSuperClass(exception)) {
            declaresRemoteExceptionOrSuperClass = true;
            break;
        }
    }
    if (!declaresRemoteExceptionOrSuperClass) {
        String msg = 'Method '' + method + '' must throw at least one ' + 'exception of type java.rmi.RemoteException or one of its ' + 'super-classes';
        throw new IDLTypeException(msg);
    }
    for (int eIndex = 0; eIndex < exceptions.length; eIndex++) {
        Class exception = exceptions[eIndex];
        if (isCheckedException(exception) && !isValue(exception) && !isRemoteException(exception)) {
            String msg = 'Exception '' + exception + '' on method '' + method + '' is not a allowed RMI/IIOP exception type';
            throw new IDLTypeException(msg);
        }
    }
    return;
}

Source: "Java SE Downloads: Java SE 6 JDK Source Code", at: http://www.oracle.com/technetwork/java/javase/downloads/index.html

com.sun.corba.se.impl.presentation.rmi.IDLTypesUtil.validateRemoteInterface(Class)

/**
     * Validate a class to ensure it conforms to the rules for a
     * Java RMI/IIOP interface.
     * @throws IDLTypeException if not a valid RMI/IIOP interface.
     */
public void validateRemoteInterface(Class c) throws IDLTypeException {
    if (c == null) {
        throw new IllegalArgumentException();
    }
    if (!c.isInterface()) {
        String msg = 'Class ' + c + ' must be a java interface.';
        throw new IDLTypeException(msg);
    }
    if (!java.rmi.Remote.class.isAssignableFrom(c)) {
        String msg = 'Class ' + c + ' must extend java.rmi.Remote, ' + 'either directly or indirectly.';
        throw new IDLTypeException(msg);
    }
    Method[] methods = c.getMethods();
    for (int i = 0; i < methods.length; i++) {
        Method next = methods[i];
        validateExceptions(next);
    }
    validateConstants(c);
    return;
}

Source: "Java SE Downloads: Java SE 6 JDK Source Code", at: http://www.oracle.com/technetwork/java/javase/downloads/index.html

No comments:

Post a Comment