org.apache.axis.wsdl.fromJava
Class Types

java.lang.Object
  |
  +--org.apache.axis.wsdl.fromJava.Types

public class Types
extends java.lang.Object

Description:

This class is used to recursively serializes a Java Class into an XML Schema representation. It has utility methods to create a schema node, assosiate namespaces to the various types

Author:
unascribed

Field Summary
protected static org.apache.commons.logging.Log log
           
 
Constructor Summary
Types(javax.wsdl.Definition def, TypeMapping tm, TypeMapping defaultTM, Namespaces namespaces, java.lang.String targetNamespace, java.util.List stopClasses)
          This class serailizes a Class to XML Schema.
 
Method Summary
 org.w3c.dom.Element createAttributeElement(java.lang.String elementName, java.lang.String elementType, boolean nullable, org.w3c.dom.Document docHolder)
          Create Attribute Element with a given name and type
 org.w3c.dom.Element createElement(java.lang.String elementName)
          Create a DOM Element in this context
 org.w3c.dom.Element createElement(java.lang.String elementName, java.lang.String elementType, boolean nullable, boolean omittable, org.w3c.dom.Document docHolder)
          Create Element with a given name and type
static java.lang.String getLocalNameFromFullName(java.lang.String full)
          Utility method to get the local class name from a fully qualified java class name
 Namespaces getNamespaces()
          Return the namespaces object for the current context
static java.lang.String getPackageNameFromFullName(java.lang.String full)
          Utility method to get the package name from a fully qualified java class name
 java.util.List getStopClasses()
          Return the list of classes that we should not emit WSDL for.
 QName getTypeQName(java.lang.Class javaType)
          Return the QName of the specified javaType
 void insertTypesFragment(org.w3c.dom.Document doc)
          Inserts the type fragment into the given wsdl document
 boolean isAcceptableAsAttribute(java.lang.Class type)
          Is the given class acceptable as an attribute
protected  boolean isBeanCompatible(java.lang.Class javaType, boolean issueErrors)
          isBeanCompatible
static boolean isEnumClass(java.lang.Class cls)
          Returns true if indicated type matches the JAX-RPC enumeration class.
 boolean isNullable(java.lang.Class type)
          Determines if the field is nullable.
 void loadInputTypes(java.lang.String inputWSDL)
          Load the types from the input wsdl file.
 QName writeElementForPart(java.lang.Class type, QName qname)
          Write out an element referenced by a part element attribute.
 void writeSchemaElement(QName qName, org.w3c.dom.Element element)
          Write out the given Element into the appropriate schema node.
 java.lang.String writeType(java.lang.Class type)
          Write a schema representation for the given Class.
 java.lang.String writeType(java.lang.Class type, QName qName)
          Write a schema representation for the given Class.
 QName writeTypeForPart(java.lang.Class type, QName qname)
          Write out a type referenced by a part type attribute.
 boolean writeWrapperForPart(QName wrapper, java.lang.String name, QName type)
          Write wrapper for part.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

log

protected static org.apache.commons.logging.Log log
Constructor Detail

Types

public Types(javax.wsdl.Definition def,
             TypeMapping tm,
             TypeMapping defaultTM,
             Namespaces namespaces,
             java.lang.String targetNamespace,
             java.util.List stopClasses)
This class serailizes a Class to XML Schema. The constructor provides the context for the streamed node within the WSDL document
Parameters:
def - WSDL Definition Element to declare namespaces
tm - TypeMappingRegistry to handle known types
defaultTM - default TM
namespaces - user defined or autogenerated namespace and prefix maps
targetNamespace - targetNamespace of the document
Method Detail

getNamespaces

public Namespaces getNamespaces()
Return the namespaces object for the current context

loadInputTypes

public void loadInputTypes(java.lang.String inputWSDL)
                    throws java.io.IOException,
                           javax.wsdl.WSDLException
Load the types from the input wsdl file.
Parameters:
inputWSDL - file or URL

writeTypeForPart

public QName writeTypeForPart(java.lang.Class type,
                              QName qname)
                       throws AxisFault
Write out a type referenced by a part type attribute.
Parameters:
type - Class to generate the XML Schema info for
qname - QName of the type. If null, qname is defaulted from the class.
Returns:
the QName of the generated Schema type, null if void, if the Class type cannot be converted to a schema type then xsd:anytype is returned.

writeElementForPart

public QName writeElementForPart(java.lang.Class type,
                                 QName qname)
                          throws AxisFault
Write out an element referenced by a part element attribute.
Parameters:
type - Class to generate the XML Schema info for
qname - QName of the element. If null, qname is defaulted from the class.
Returns:
the QName of the generated Schema type, null if no element

writeWrapperForPart

public boolean writeWrapperForPart(QName wrapper,
                                   java.lang.String name,
                                   QName type)
                            throws AxisFault
Write wrapper for part.
Parameters:
wrapper - QName of the wrapper element
name - is the name of an element to add to the wrapper element.
type - is the QName of the type of the element.
Returns:
true if the wrapperQName was created, false if it already exists.

getTypeQName

public QName getTypeQName(java.lang.Class javaType)
Return the QName of the specified javaType
Parameters:
javaType - input javaType Class
Returns:
QName

getPackageNameFromFullName

public static java.lang.String getPackageNameFromFullName(java.lang.String full)
Utility method to get the package name from a fully qualified java class name
Parameters:
full - input class name
Returns:
package name

getLocalNameFromFullName

public static java.lang.String getLocalNameFromFullName(java.lang.String full)
Utility method to get the local class name from a fully qualified java class name
Parameters:
full - input class name
Returns:
package name

writeSchemaElement

public void writeSchemaElement(QName qName,
                               org.w3c.dom.Element element)
Write out the given Element into the appropriate schema node. If need be create the schema node as well
Parameters:
qName - qName to get the namespace of the schema node
element - the Element to append to the Schema node

writeType

public java.lang.String writeType(java.lang.Class type)
                           throws AxisFault
Write a schema representation for the given Class. Recurse through all the public fields as well as fields represented by java bean compliant accessor methods. Then return the qualified string representation of the generated type
Parameters:
type - Class for which to generate schema
Returns:
a prefixed string for the schema type

writeType

public java.lang.String writeType(java.lang.Class type,
                                  QName qName)
                           throws AxisFault
Write a schema representation for the given Class. Recurse through all the public fields as well as fields represented by java bean compliant accessor methods. Then return the qualified string representation of the generated type
Parameters:
type - Class for which to generate schema
qName - of the type to write
Returns:
a prefixed string for the schema type or null if problems occur

isEnumClass

public static boolean isEnumClass(java.lang.Class cls)
Returns true if indicated type matches the JAX-RPC enumeration class. Note: supports JSR 101 version 0.6 Public Draft

createElement

public org.w3c.dom.Element createElement(java.lang.String elementName,
                                         java.lang.String elementType,
                                         boolean nullable,
                                         boolean omittable,
                                         org.w3c.dom.Document docHolder)
Create Element with a given name and type
Parameters:
elementName - the name of the created element
elementType - schema type representation of the element
nullable - nullable attribute of the element
Returns:
the created Element

createAttributeElement

public org.w3c.dom.Element createAttributeElement(java.lang.String elementName,
                                                  java.lang.String elementType,
                                                  boolean nullable,
                                                  org.w3c.dom.Document docHolder)
Create Attribute Element with a given name and type
Parameters:
elementName - the name of the created element
elementType - schema type representation of the element
nullable - nullable attribute of the element
Returns:
the created Element

isAcceptableAsAttribute

public boolean isAcceptableAsAttribute(java.lang.Class type)
Is the given class acceptable as an attribute
Parameters:
type - input Class
Returns:
true if the type is a simple, enum type or extends SimpleType

isNullable

public boolean isNullable(java.lang.Class type)
Determines if the field is nullable. All non-primitives except for byte[] are nillable.
Parameters:
type - input Class
Returns:
true if nullable

insertTypesFragment

public void insertTypesFragment(org.w3c.dom.Document doc)
Inserts the type fragment into the given wsdl document
Parameters:
doc -  

getStopClasses

public java.util.List getStopClasses()
Return the list of classes that we should not emit WSDL for.

createElement

public org.w3c.dom.Element createElement(java.lang.String elementName)
Create a DOM Element in this context

isBeanCompatible

protected boolean isBeanCompatible(java.lang.Class javaType,
                                   boolean issueErrors)
isBeanCompatible
Parameters:
javaType - Class
issueErrors - if true, issue messages if not compatible Returns true if it appears that this class is a bean and can be mapped to a complexType


Copyright © 2002 Apache XML Project. All Rights Reserved.