FileDocCategorySizeDatePackage
JavaSkelWriter.javaAPI DocApache Axis 1.420152Sat Apr 22 18:57:28 BST 2006org.apache.axis.wsdl.toJava

JavaSkelWriter

public class JavaSkelWriter extends JavaClassWriter
This is Wsdl2java's skeleton writer. It writes the Skeleton.java file which contains the Skeleton class.

Fields Summary
private org.apache.axis.wsdl.symbolTable.BindingEntry
bEntry
Field bEntry
private javax.wsdl.Binding
binding
Field binding
private org.apache.axis.wsdl.symbolTable.SymbolTable
symbolTable
Field symbolTable
Constructors Summary
protected JavaSkelWriter(Emitter emitter, org.apache.axis.wsdl.symbolTable.BindingEntry bEntry, org.apache.axis.wsdl.symbolTable.SymbolTable symbolTable)
Constructor.

param
emitter
param
bEntry
param
symbolTable


        super(emitter, bEntry.getName() + "Skeleton", "skeleton");

        this.bEntry = bEntry;
        this.binding = bEntry.getBinding();
        this.symbolTable = symbolTable;
Methods Summary
protected java.lang.StringgetImplementsText()
Returns "implements , org.apache.axis.wsdl.Skeleton ".

return


        return "implements "
                + bEntry.getDynamicVar(JavaBindingWriter.INTERFACE_NAME)
                + ", org.apache.axis.wsdl.Skeleton ";
protected voidwriteFileBody(java.io.PrintWriter pw)
Write the body of the binding's stub file.

param
pw
throws
IOException


        String portTypeName =
                (String) bEntry.getDynamicVar(JavaBindingWriter.INTERFACE_NAME);
        String implType = portTypeName + " impl";

        // Declare private impl and skeleton base delegates
        pw.println("    private " + implType + ";");
        pw.println(
                "    private static java.util.Map _myOperations = new java.util.Hashtable();");
        pw.println(
                "    private static java.util.Collection _myOperationsList = new java.util.ArrayList();");
        pw.println();
        pw.println("    /**");
        pw.println(
                "    * Returns List of OperationDesc objects with this name");
        pw.println("    */");
        pw.println(
                "    public static java.util.List getOperationDescByName(java.lang.String methodName) {");
        pw.println(
                "        return (java.util.List)_myOperations.get(methodName);");
        pw.println("    }");
        pw.println();
        pw.println("    /**");
        pw.println("    * Returns Collection of OperationDescs");
        pw.println("    */");
        pw.println(
                "    public static java.util.Collection getOperationDescs() {");
        pw.println("        return _myOperationsList;");
        pw.println("    }");
        pw.println();

        // Initialize operation parameter names
        pw.println("    static {");
        pw.println("        org.apache.axis.description.OperationDesc _oper;");
        pw.println("        org.apache.axis.description.FaultDesc _fault;");
        pw.println(
                "        org.apache.axis.description.ParameterDesc [] _params;");

        List operations = binding.getBindingOperations();

        for (int i = 0; i < operations.size(); ++i) {
            BindingOperation bindingOper = (BindingOperation) operations.get(i);
            Operation operation = bindingOper.getOperation();
            OperationType type = operation.getStyle();

            // These operation types are not supported.  The signature
            // will be a string stating that fact.
            if ((OperationType.NOTIFICATION.equals(type))
                    || (OperationType.SOLICIT_RESPONSE.equals(type))) {
                continue;
            }

            Parameters parameters =
                    bEntry.getParameters(bindingOper.getOperation());

            if (parameters != null) {

                // The invoked java name of the bindingOper is stored.
                String opName = bindingOper.getOperation().getName();
                String javaOpName = Utils.xmlNameToJava(opName);

                pw.println(
                        "        _params = new org.apache.axis.description.ParameterDesc [] {");

                for (int j = 0; j < parameters.list.size(); j++) {
                    Parameter p = (Parameter) parameters.list.get(j);
                    String modeStr;

                    switch (p.getMode()) {

                        case Parameter.IN:
                            modeStr =
                                    "org.apache.axis.description.ParameterDesc.IN";
                            break;

                        case Parameter.OUT:
                            modeStr =
                                    "org.apache.axis.description.ParameterDesc.OUT";
                            break;

                        case Parameter.INOUT:
                            modeStr =
                                    "org.apache.axis.description.ParameterDesc.INOUT";
                            break;

                        default :
                            throw new IOException(
                                    Messages.getMessage(
                                            "badParmMode00",
                                            (new Byte(p.getMode())).toString()));
                    }

                    // Get the QNames representing the parameter name and type
                    QName paramName = p.getQName();
                    QName paramType = Utils.getXSIType(p);

                    // Is this parameter a header?
                    String inHeader = p.isInHeader()
                            ? "true"
                            : "false";
                    String outHeader = p.isOutHeader()
                            ? "true"
                            : "false";

                    pw.println(
                            "            "
                            + "new org.apache.axis.description.ParameterDesc("
                            + Utils.getNewQNameWithLastLocalPart(paramName) + ", " + modeStr + ", "
                            + Utils.getNewQName(paramType) + ", "
                            + Utils.getParameterTypeName(p) + ".class" + ", "
                            + inHeader + ", " + outHeader + "), ");
                }

                pw.println("        };");

                // Get the return name QName and type
                QName retName = null;
                QName retType = null;

                if (parameters.returnParam != null) {
                    retName = parameters.returnParam.getQName();
                    retType = Utils.getXSIType(parameters.returnParam);
                }
                
                String returnStr;

                if (retName != null) {
                    returnStr = Utils.getNewQNameWithLastLocalPart(retName);
                } else {
                    returnStr = "null";
                }

                pw.println(
                        "        _oper = new org.apache.axis.description.OperationDesc(\""
                        + javaOpName + "\", _params, " + returnStr + ");");

                if (retType != null) {
                    pw.println("        _oper.setReturnType("
                            + Utils.getNewQName(retType) + ");");

                    if ((parameters.returnParam != null)
                            && parameters.returnParam.isOutHeader()) {
                        pw.println("        _oper.setReturnHeader(true);");
                    }
                }

                // If we need to know the QName (if we have a namespace or
                // the actual method name doesn't match the XML we expect),
                // record it in the OperationDesc
                QName elementQName = Utils.getOperationQName(bindingOper,
                        bEntry, symbolTable);

                if (elementQName != null) {
                    pw.println("        _oper.setElementQName("
                            + Utils.getNewQName(elementQName) + ");");
                }

                // Find the SOAPAction.
                String action = Utils.getOperationSOAPAction(bindingOper);
                if (action != null) {
                    pw.println("        _oper.setSoapAction(\"" + action + "\");");
                }

                pw.println("        _myOperationsList.add(_oper);");
                pw.println("        if (_myOperations.get(\"" + javaOpName
                        + "\") == null) {");
                pw.println("            _myOperations.put(\"" + javaOpName
                        + "\", new java.util.ArrayList());");
                pw.println("        }");
                pw.println("        ((java.util.List)_myOperations.get(\""
                        + javaOpName + "\")).add(_oper);");
            }

            // Now generate FaultDesc
            if (bEntry.getFaults() != null) {
                ArrayList faults =
                        (ArrayList) bEntry.getFaults().get(bindingOper);

                if (faults != null) {

                    // Operation was not created if there were no parameters
                    if (parameters == null) {
                        String opName =
                                bindingOper.getOperation().getName();
                        String javaOpName = Utils.xmlNameToJava(opName);

                        pw.println(
                                "        _oper = "
                                + "new org.apache.axis.description.OperationDesc();");
                        pw.println("        _oper.setName(\"" + javaOpName
                                + "\");");
                    }

                    // Create FaultDesc items for each fault
                    Iterator it = faults.iterator();

                    while (it.hasNext()) {
                        FaultInfo faultInfo = (FaultInfo) it.next();
                        QName faultQName = faultInfo.getQName();
                        QName faultXMLType = faultInfo.getXMLType();
                        String faultName = faultInfo.getName();
                        String className =
                                Utils.getFullExceptionName(faultInfo.getMessage(),
                                        symbolTable);

                        pw.println(
                                "        _fault = "
                                + "new org.apache.axis.description.FaultDesc();");

                        if (faultName != null) {
                            pw.println("        _fault.setName(\"" + faultName
                                    + "\");");
                        }

                        if (faultQName != null) {
                            pw.println("        _fault.setQName("
                                    + Utils.getNewQName(faultQName) + ");");
                        }

                        if (className != null) {
                            pw.println("        _fault.setClassName(\""
                                    + className + "\");");
                        }

                        if (faultXMLType != null) {
                            pw.println("        _fault.setXmlType("
                                    + Utils.getNewQName(faultXMLType)
                                    + ");");
                        }

                        pw.println("        _oper.addFault(_fault);");
                    }
                }
            }
        }

        pw.println("    }");
        pw.println();

        // Skeleton constructors 
        pw.println("    public " + className + "() {");

		// Use custom implementation class if available.
		String implementationClassName = emitter.getImplementationClassName(); 
		if ( implementationClassName == null)
			implementationClassName = bEntry.getName() + "Impl";
        pw.println("        this.impl = new " + implementationClassName + "();");
        pw.println("    }");
        
        pw.println();
        pw.println("    public " + className + "(" + implType + ") {");
        pw.println("        this.impl = impl;");
        pw.println("    }");

        // Now write each of the operation methods
        for (int i = 0; i < operations.size(); ++i) {
            BindingOperation operation = (BindingOperation) operations.get(i);
            Parameters parameters =
                    bEntry.getParameters(operation.getOperation());

            // Get the soapAction from the <soap:operation>
            String soapAction = "";
            Iterator operationExtensibilityIterator =
                    operation.getExtensibilityElements().iterator();

            for (; operationExtensibilityIterator.hasNext();) {
                Object obj = operationExtensibilityIterator.next();

                if (obj instanceof SOAPOperation) {
                    soapAction = ((SOAPOperation) obj).getSoapActionURI();

                    break;
                } else if (obj instanceof UnknownExtensibilityElement) {

                    // TODO: After WSDL4J supports soap12, change this code
                    UnknownExtensibilityElement unkElement =
                            (UnknownExtensibilityElement) obj;
                    QName name =
                            unkElement.getElementType();

                    if (name.getNamespaceURI().equals(Constants.URI_WSDL12_SOAP)
                            && name.getLocalPart().equals("operation")) {
                        if (unkElement.getElement().getAttribute("soapAction")
                                != null) {
                            soapAction = unkElement.getElement().getAttribute(
                                    "soapAction");
                        }
                    }
                }
            }

            // Get the namespace for the operation from the <soap:body>
            // RJB: is this the right thing to do?
            String namespace = "";
            Iterator bindingMsgIterator = null;
            BindingInput input = operation.getBindingInput();
            BindingOutput output;

            if (input != null) {
                bindingMsgIterator =
                        input.getExtensibilityElements().iterator();
            } else {
                output = operation.getBindingOutput();

                if (output != null) {
                    bindingMsgIterator =
                            output.getExtensibilityElements().iterator();
                }
            }

            if (bindingMsgIterator != null) {
                for (; bindingMsgIterator.hasNext();) {
                    Object obj = bindingMsgIterator.next();

                    if (obj instanceof SOAPBody) {
                        namespace = ((SOAPBody) obj).getNamespaceURI();

                        if (namespace == null) {
                            namespace =
                                    symbolTable.getDefinition().getTargetNamespace();
                        }

                        if (namespace == null) {
                            namespace = "";
                        }

                        break;
                    } else if (obj instanceof UnknownExtensibilityElement) {

                        // TODO: After WSDL4J supports soap12, change this code
                        UnknownExtensibilityElement unkElement =
                                (UnknownExtensibilityElement) obj;
                        QName name =
                                unkElement.getElementType();

                        if (name.getNamespaceURI().equals(
                                Constants.URI_WSDL12_SOAP)
                                && name.getLocalPart().equals("body")) {
                            namespace = unkElement.getElement().getAttribute(
                                    "namespace");

                            if (namespace == null) {
                                namespace =
                                        symbolTable.getDefinition().getTargetNamespace();
                            }

                            if (namespace == null) {
                                namespace = "";
                            }

                            break;
                        }
                    }
                }
            }

            Operation ptOperation = operation.getOperation();
            OperationType type = ptOperation.getStyle();

            // These operation types are not supported.  The signature
            // will be a string stating that fact.
            if ((OperationType.NOTIFICATION.equals(type))
                    || (OperationType.SOLICIT_RESPONSE.equals(type))) {
                pw.println(parameters.signature);
                pw.println();
            } else {
                writeOperation(pw, operation, parameters, soapAction,
                        namespace);
            }
        }
protected voidwriteOperation(java.io.PrintWriter pw, javax.wsdl.BindingOperation operation, org.apache.axis.wsdl.symbolTable.Parameters parms, java.lang.String soapAction, java.lang.String namespace)
Write the skeleton code for the given operation.

param
pw
param
operation
param
parms
param
soapAction
param
namespace


        writeComment(pw, operation.getDocumentationElement(), true);

        // The skeleton used to have specialized operation signatures.
        // now the same signature is used as the portType
        pw.println(parms.signature);
        pw.println("    {");

        // Note: The holders are now instantiated by the runtime and passed
        // in as parameters.
        // Call the real implementation
        if (parms.returnParam == null) {
            pw.print("        ");
        } else {
            pw.print("        " + Utils.getParameterTypeName(parms.returnParam)
                    + " ret = ");
        }

        String call = "impl." + Utils.xmlNameToJava(operation.getName())
                + "(";
        boolean needComma = false;

        for (int i = 0; i < parms.list.size(); ++i) {
            if (needComma) {
                call = call + ", ";
            } else {
                needComma = true;
            }

            Parameter p = (Parameter) parms.list.get(i);

            call = call + Utils.xmlNameToJava(p.getName());
        }

        call = call + ")";

        pw.println(call + ";");

        if (parms.returnParam != null) {
            pw.println("        return ret;");
        }

        pw.println("    }");
        pw.println();