Package org.apache.axis.wsdl.fromJava
Class Emitter
java.lang.Object
org.apache.axis.wsdl.fromJava.Emitter
This class emits WSDL from Java classes. It is used by the ?WSDL
Axis browser function and Java2WSDL commandline utility.
See Java2WSDL and Java2WSDLFactory for more information.
- Author:
- Glen Daniels (gdaniels@apache.org), Rich Scheuerle (scheu@us.ibm.com)
-
Field Summary
FieldsModifier and TypeFieldDescriptionprotected static org.apache.commons.logging.LogField logstatic final intField MODE_ALLstatic final intDEPRECATED - Indicates style=wrapped use=literalstatic final intDEPRECATED - Indicates style=document use=literalstatic final intField MODE_IMPLEMENTATIONstatic final intField MODE_INTERFACEstatic final intDEPRECATED - Indicates style=rpc use=encodedprotected static TypeMappingField standardTypesprotected TypesField types -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected javax.wsdl.DefinitionBuild a Definition from the input wsdl file or create a new Definitionprotected ElementcreateDocumentationElement(String documentation) Create a documentation elementprotected QNamecreateMessageName(javax.wsdl.Definition def, String methodName) Method createMessageNameprotected TypescreateTypes(javax.wsdl.Definition def) Build a Types object and load the input wsdl typesemit(int mode) Generates a WSDL document for a givenClass.voidGenerates a complete WSDL document for a givenClassvoidGenerates a WSDL document for a givenClass.voidGenerates WSDL documents for a givenClassemitToString(int mode) Generates a String containing the WSDL for a givenClass.Returns a vector of methods to exportReturns the String representation of the binding namegetCls()Returns theClassto exportDeprecated.Use getTypeMappingRegistry insteadReturns the service descriptionReturn list of methods that should not be exportedClass[]Return the list of extra classes that the emitter will produce WSDL for.Returns the implementationClassif setReturns the implementation namespacejavax.wsdl.DefinitionGet implementation WSDLDefinitionfor the current configuration parametersReturns the String representation of the interface import location URLGet the name of the input WSDLReturns the interface namespacejavax.wsdl.DefinitionGet a interface WSDLDefinitionfor the current configuration parametersReturns the String representation of the service endpoint URLintgetMode()Deprecated.(use getStyle and getUse)get the packagename to namespace mapReturns the String representation of the portType nameReturn the type qname to java type mappingprotected QNamegetRequestQName(OperationDesc oper) Method getRequestQNameprotected QNameMethod getResponseQNameMethod getServiceDescReturns the String representation of the service element nameReturns the String representation of the service port nameReturns the soapAction option valueReturn the list of classes which stop inhertance searchesgetStyle()getStyleReturns the target service nameReturns theTypeMappingused by the servicegetUse()getUsebooleanIndicates if the emitter will search classes for inherited methodsReturn the version messagejavax.wsdl.DefinitiongetWSDL()Get a Full WSDLDefinitionfor the current configuration parametersprotected voidinit(int mode) Invoked prior to building a definition to ensure parms and data are set up.protected voidprettyDocumentToFile(Document doc, String filename) Write a prettified document to a file.voidsetAllowedMethods(String text) Add a list of methods to exportvoidsetAllowedMethods(Vector allowedMethods) Add a Vector of methods to exportvoidsetBindingName(String bindingName) Set the String representation of the binding namevoidSets theClassto exportvoidSets theClassto exportvoidsetClsSmart(Class cls, String location) Sets theClassto export.voidDeprecated.Use setTypeMappingRegistry insteadvoidsetDescription(String description) Set the service descriptionvoidsetDisallowedMethods(String text) Add a list of methods NOT to exportvoidsetDisallowedMethods(Vector disallowedMethods) Add a list of methods NOT to exportvoidsetEmitAllTypes(boolean emitAllTypes) voidsetExtraClasses(Class[] extraClasses) Provide a list of classes which the emitter will produce WSDL type definitions for.voidsetExtraClasses(String text) Provide a comma or space seperated list of classes which the emitter will produce WSDL type definitions for.voidsetImplCls(Class implCls) Sets the implementationClassvoidsetImplCls(String className) Sets the implementationClassvoidSet the implementation namespacevoidsetImportUrl(String importUrl) Set the String representation of the interface location URL for importingvoidsetInputSchema(String inputSchema) Set the name of the input schemavoidsetInputWSDL(String inputWSDL) Set the name of the input WSDLvoidSet the interface namespacevoidsetLocationUrl(String locationUrl) Set the String representation of the service endpoint URLvoidsetMode(int mode) Deprecated.(use setStyle and setUse)voidsetNamespaceMap(Map map) Set the packagename to namespace map with the given mapvoidsetPortTypeName(String portTypeName) Set the String representation of the portType namevoidsetServiceDesc(ServiceDesc serviceDesc) Method setServiceDescvoidsetServiceElementName(String serviceElementName) Set the String representation of the service element namevoidsetServicePortName(String servicePortName) Set the String representation of the service port namevoidsetSoapAction(String value) Sets the soapAction option valuevoidsetStopClasses(String text) Add a list of classes (fully qualified) that will stop the traversal of the inheritance tree if encounter in method or complex type generationvoidsetStopClasses(ArrayList stopClasses) Adds a list of classes (fully qualified) that will stop the traversal of the inheritance tree if encounter in method or complex type generationvoidsetStylevoidsetStylevoidsetTargetService(String targetService) Set the target service namevoidSets theTypeMappingused by the servicevoidSet the TypeMappingRegistry for this Emitter.voidsetUsevoidsetUsevoidsetUseInheritedMethods(boolean useInheritedMethods) Turn on or off inherited method WSDL generation.voidsetVersionMessage(String versionMessage) Set the version message that appears at the top of the WSDL If not set, we use the default version message.protected javax.wsdl.BindingwriteBinding(javax.wsdl.Definition def, boolean add) Create the binding.protected javax.wsdl.BindingOperationwriteBindingOperation(javax.wsdl.Definition def, javax.wsdl.Binding binding, javax.wsdl.Operation oper, OperationDesc desc) Create a Binding Operationprotected voidwriteDefinitions(javax.wsdl.Definition def, String tns) Create the definition header information.protected javax.wsdl.MessagewriteFaultMessage(javax.wsdl.Definition def, FaultDesc exception) Create a Fault Messageprotected voidwriteImport(javax.wsdl.Definition def, String tns, String loc) Create and add an importprotected voidwriteMessages(javax.wsdl.Definition def, javax.wsdl.Operation oper, OperationDesc desc, javax.wsdl.BindingOperation bindingOper) Create a Messageprotected javax.wsdl.BindingOperationwriteOperation(javax.wsdl.Definition def, javax.wsdl.Binding binding, OperationDesc desc) Create a OperationwritePartToMessage(javax.wsdl.Definition def, javax.wsdl.Message msg, boolean request, ParameterDesc param) Create a Partprotected voidwritePortType(javax.wsdl.Definition def, javax.wsdl.Binding binding) Create a PortTypeprotected javax.wsdl.MessagewriteRequestMessage(javax.wsdl.Definition def, OperationDesc oper, javax.wsdl.BindingOperation bindop) Create a Request Messageprotected javax.wsdl.MessagewriteResponseMessage(javax.wsdl.Definition def, OperationDesc desc, javax.wsdl.BindingOperation bindop) Create a Response Messageprotected voidwriteService(javax.wsdl.Definition def, javax.wsdl.Binding binding) Create the service.protected javax.wsdl.extensions.ExtensibilityElementwriteSOAPBody(QName operQName) Method writeSOAPBodyprotected javax.wsdl.extensions.soap.SOAPFaultwriteSOAPFault(FaultDesc faultDesc) Method writeSOAPFaultprotected javax.wsdl.extensions.soap.SOAPHeaderwriteSOAPHeader(ParameterDesc p, QName messageQName, String partName) Create a SOAPHeader elementwriteWrapperPart(javax.wsdl.Definition def, javax.wsdl.Message msg, OperationDesc oper, boolean request) Write out the schema definition for a WRAPPED operation request or response.
-
Field Details
-
log
protected static org.apache.commons.logging.Log logField log -
MODE_ALL
public static final int MODE_ALLField MODE_ALL- See Also:
-
MODE_INTERFACE
public static final int MODE_INTERFACEField MODE_INTERFACE- See Also:
-
MODE_IMPLEMENTATION
public static final int MODE_IMPLEMENTATIONField MODE_IMPLEMENTATION- See Also:
-
types
Field types -
MODE_RPC
public static final int MODE_RPCDEPRECATED - Indicates style=rpc use=encoded- See Also:
-
MODE_DOCUMENT
public static final int MODE_DOCUMENTDEPRECATED - Indicates style=document use=literal- See Also:
-
MODE_DOC_WRAPPED
public static final int MODE_DOC_WRAPPEDDEPRECATED - Indicates style=wrapped use=literal- See Also:
-
standardTypes
Field standardTypes
-
-
Constructor Details
-
Emitter
public Emitter()Construct Emitter. Set the contextual information using set* methods Invoke emit to emit the code
-
-
Method Details
-
emit
public void emit(String filename1, String filename2) throws IOException, javax.wsdl.WSDLException, SAXException, ParserConfigurationException Generates WSDL documents for a givenClass- Parameters:
filename1- interface WSDLfilename2- implementation WSDL- Throws:
IOExceptionjavax.wsdl.WSDLExceptionSAXExceptionParserConfigurationException
-
emit
public void emit(String filename) throws IOException, javax.wsdl.WSDLException, SAXException, ParserConfigurationException Generates a complete WSDL document for a givenClass- Parameters:
filename- WSDL- Throws:
IOExceptionjavax.wsdl.WSDLExceptionSAXExceptionParserConfigurationException
-
emit
public Document emit(int mode) throws IOException, javax.wsdl.WSDLException, SAXException, ParserConfigurationException Generates a WSDL document for a givenClass. The WSDL generated is controlled by the mode parameter mode 0: All mode 1: Interface mode 2: Implementation- Parameters:
mode- generation mode - all, interface, implementation- Returns:
- Document
- Throws:
IOExceptionjavax.wsdl.WSDLExceptionSAXExceptionParserConfigurationException
-
emitToString
public String emitToString(int mode) throws IOException, javax.wsdl.WSDLException, SAXException, ParserConfigurationException Generates a String containing the WSDL for a givenClass. The WSDL generated is controlled by the mode parameter mode 0: All mode 1: Interface mode 2: Implementation- Parameters:
mode- generation mode - all, interface, implementation- Returns:
- String
- Throws:
IOExceptionjavax.wsdl.WSDLExceptionSAXExceptionParserConfigurationException
-
emit
public void emit(String filename, int mode) throws IOException, javax.wsdl.WSDLException, SAXException, ParserConfigurationException Generates a WSDL document for a givenClass. The WSDL generated is controlled by the mode parameter mode 0: All mode 1: Interface mode 2: Implementation- Parameters:
filename- WSDLmode- generation mode - all, interface, implementation- Throws:
IOExceptionjavax.wsdl.WSDLExceptionSAXExceptionParserConfigurationException
-
getWSDL
public javax.wsdl.Definition getWSDL() throws IOException, javax.wsdl.WSDLException, SAXException, ParserConfigurationExceptionGet a Full WSDLDefinitionfor the current configuration parameters- Returns:
- WSDL
Definition - Throws:
IOExceptionjavax.wsdl.WSDLExceptionSAXExceptionParserConfigurationException
-
getIntfWSDL
public javax.wsdl.Definition getIntfWSDL() throws IOException, javax.wsdl.WSDLException, SAXException, ParserConfigurationExceptionGet a interface WSDLDefinitionfor the current configuration parameters- Returns:
- WSDL
Definition - Throws:
IOExceptionjavax.wsdl.WSDLExceptionSAXExceptionParserConfigurationException
-
getImplWSDL
public javax.wsdl.Definition getImplWSDL() throws IOException, javax.wsdl.WSDLException, SAXException, ParserConfigurationExceptionGet implementation WSDLDefinitionfor the current configuration parameters- Returns:
- WSDL
Definition - Throws:
IOExceptionjavax.wsdl.WSDLExceptionSAXExceptionParserConfigurationException
-
init
protected void init(int mode) Invoked prior to building a definition to ensure parms and data are set up.- Parameters:
mode-
-
createDefinition
protected javax.wsdl.Definition createDefinition() throws javax.wsdl.WSDLException, SAXException, IOException, ParserConfigurationExceptionBuild a Definition from the input wsdl file or create a new Definition- Returns:
- WSDL Definition
- Throws:
javax.wsdl.WSDLExceptionSAXExceptionIOExceptionParserConfigurationException
-
createTypes
protected Types createTypes(javax.wsdl.Definition def) throws IOException, javax.wsdl.WSDLException, SAXException, ParserConfigurationException Build a Types object and load the input wsdl types- Parameters:
def- Corresponding wsdl Definition- Returns:
- Types object
- Throws:
IOExceptionjavax.wsdl.WSDLExceptionSAXExceptionParserConfigurationException
-
createDocumentationElement
Create a documentation element- Parameters:
documentation-- Returns:
-
writeDefinitions
Create the definition header information.- Parameters:
def-Definitiontns- target namespace
-
writeImport
Create and add an import- Parameters:
def-Definitiontns- target namespaceloc- target location
-
writeBinding
protected javax.wsdl.Binding writeBinding(javax.wsdl.Definition def, boolean add) Create the binding.- Parameters:
def-Definitionadd- true if binding should be added to the def- Returns:
-
writeService
protected void writeService(javax.wsdl.Definition def, javax.wsdl.Binding binding) Create the service.- Parameters:
def-binding-
-
writePortType
protected void writePortType(javax.wsdl.Definition def, javax.wsdl.Binding binding) throws javax.wsdl.WSDLException, AxisFault Create a PortType- Parameters:
def-binding-- Throws:
javax.wsdl.WSDLExceptionAxisFault
-
writeMessages
protected void writeMessages(javax.wsdl.Definition def, javax.wsdl.Operation oper, OperationDesc desc, javax.wsdl.BindingOperation bindingOper) throws javax.wsdl.WSDLException, AxisFault Create a Message- Parameters:
def- Definition, the WSDL definitionoper- Operation, the wsdl operationdesc- OperationDesc, the Operation DescriptionbindingOper- BindingOperation, corresponding Binding Operation- Throws:
javax.wsdl.WSDLExceptionAxisFault
-
writeOperation
protected javax.wsdl.BindingOperation writeOperation(javax.wsdl.Definition def, javax.wsdl.Binding binding, OperationDesc desc) Create a Operation- Parameters:
def-binding-desc-- Returns:
-
writeBindingOperation
protected javax.wsdl.BindingOperation writeBindingOperation(javax.wsdl.Definition def, javax.wsdl.Binding binding, javax.wsdl.Operation oper, OperationDesc desc) Create a Binding Operation- Parameters:
def-binding-oper-desc-- Returns:
-
writeSOAPHeader
protected javax.wsdl.extensions.soap.SOAPHeader writeSOAPHeader(ParameterDesc p, QName messageQName, String partName) Create a SOAPHeader element -
writeSOAPBody
Method writeSOAPBody- Parameters:
operQName-- Returns:
-
writeSOAPFault
Method writeSOAPFault- Parameters:
faultDesc-- Returns:
-
writeRequestMessage
protected javax.wsdl.Message writeRequestMessage(javax.wsdl.Definition def, OperationDesc oper, javax.wsdl.BindingOperation bindop) throws javax.wsdl.WSDLException, AxisFault Create a Request Message- Parameters:
def-oper-- Returns:
- Throws:
javax.wsdl.WSDLExceptionAxisFault
-
getRequestQName
Method getRequestQName- Parameters:
oper-- Returns:
-
getResponseQName
Method getResponseQName- Parameters:
oper-- Returns:
-
writeWrapperPart
public String writeWrapperPart(javax.wsdl.Definition def, javax.wsdl.Message msg, OperationDesc oper, boolean request) throws AxisFault Write out the schema definition for a WRAPPED operation request or response.- Parameters:
def-msg-oper-request-- Returns:
- the name of the part the was written
- Throws:
AxisFault
-
writeResponseMessage
protected javax.wsdl.Message writeResponseMessage(javax.wsdl.Definition def, OperationDesc desc, javax.wsdl.BindingOperation bindop) throws javax.wsdl.WSDLException, AxisFault Create a Response Message- Parameters:
def-desc-- Returns:
- Throws:
javax.wsdl.WSDLExceptionAxisFault
-
writeFaultMessage
protected javax.wsdl.Message writeFaultMessage(javax.wsdl.Definition def, FaultDesc exception) throws javax.wsdl.WSDLException, AxisFault Create a Fault Message- Parameters:
def-exception- (an ExceptionRep object)- Returns:
- Throws:
javax.wsdl.WSDLExceptionAxisFault
-
writePartToMessage
public String writePartToMessage(javax.wsdl.Definition def, javax.wsdl.Message msg, boolean request, ParameterDesc param) throws javax.wsdl.WSDLException, AxisFault Create a Part- Parameters:
def-msg-request- message is for a requestparam- ParamRep object- Returns:
- The parameter name added or null
- Throws:
javax.wsdl.WSDLExceptionAxisFault
-
createMessageName
Method createMessageName- Parameters:
def-methodName-- Returns:
-
prettyDocumentToFile
Write a prettified document to a file.- Parameters:
doc- the Document to writefilename- the name of the file to be written- Throws:
IOException- various file i/o exceptions
-
getCls
Returns theClassto export- Returns:
- the
Classto export
-
setCls
Sets theClassto export- Parameters:
cls- theClassto export
-
setClsSmart
Sets theClassto export.- Parameters:
cls- theClassto exportlocation-
-
setCls
Sets theClassto export- Parameters:
className- the name of theClassto export- Throws:
ClassNotFoundException
-
getImplCls
Returns the implementationClassif set- Returns:
- the implementation Class or null
-
setImplCls
Sets the implementationClass- Parameters:
implCls- theClassto export
-
setImplCls
Sets the implementationClass- Parameters:
className- the name of the implementationClass
-
getIntfNamespace
Returns the interface namespace- Returns:
- interface target namespace
-
setIntfNamespace
Set the interface namespace- Parameters:
ns- interface target namespace
-
getImplNamespace
Returns the implementation namespace- Returns:
- implementation target namespace
-
setImplNamespace
Set the implementation namespace- Parameters:
ns- implementation target namespace
-
getAllowedMethods
Returns a vector of methods to export- Returns:
- a space separated list of methods to export
-
setAllowedMethods
Add a list of methods to export- Parameters:
text-
-
setAllowedMethods
Add a Vector of methods to export- Parameters:
allowedMethods- a vector of methods to export
-
getUseInheritedMethods
public boolean getUseInheritedMethods()Indicates if the emitter will search classes for inherited methods- Returns:
-
setUseInheritedMethods
public void setUseInheritedMethods(boolean useInheritedMethods) Turn on or off inherited method WSDL generation.- Parameters:
useInheritedMethods-
-
setDisallowedMethods
Add a list of methods NOT to export- Parameters:
disallowedMethods- vector of method name strings
-
setDisallowedMethods
Add a list of methods NOT to export- Parameters:
text- space separated list of method names
-
getDisallowedMethods
Return list of methods that should not be exported- Returns:
-
setStopClasses
Adds a list of classes (fully qualified) that will stop the traversal of the inheritance tree if encounter in method or complex type generation- Parameters:
stopClasses- vector of class name strings
-
setStopClasses
Add a list of classes (fully qualified) that will stop the traversal of the inheritance tree if encounter in method or complex type generation- Parameters:
text- space separated list of class names
-
getStopClasses
Return the list of classes which stop inhertance searches- Returns:
-
getNamespaceMap
get the packagename to namespace map- Returns:
Map
-
setNamespaceMap
Set the packagename to namespace map with the given map- Parameters:
map- packagename/namespaceMap
-
getInputWSDL
Get the name of the input WSDL- Returns:
- name of the input wsdl or null
-
setInputWSDL
Set the name of the input WSDL- Parameters:
inputWSDL- the name of the input WSDL
-
getInputSchema
- Returns:
- the name of the input schema, or null
-
setInputSchema
Set the name of the input schema- Parameters:
inputSchema- the name of the input schema
-
getLocationUrl
Returns the String representation of the service endpoint URL- Returns:
- String representation of the service endpoint URL
-
setLocationUrl
Set the String representation of the service endpoint URL- Parameters:
locationUrl- the String representation of the service endpoint URL
-
getImportUrl
Returns the String representation of the interface import location URL- Returns:
- String representation of the interface import location URL
-
setImportUrl
Set the String representation of the interface location URL for importing- Parameters:
importUrl- the String representation of the interface location URL for importing
-
getServicePortName
Returns the String representation of the service port name- Returns:
- String representation of the service port name
-
setServicePortName
Set the String representation of the service port name- Parameters:
servicePortName- the String representation of the service port name
-
getServiceElementName
Returns the String representation of the service element name- Returns:
- String representation of the service element name
-
setServiceElementName
Set the String representation of the service element name- Parameters:
serviceElementName- the String representation of the service element name
-
getPortTypeName
Returns the String representation of the portType name- Returns:
- String representation of the portType name
-
setPortTypeName
Set the String representation of the portType name- Parameters:
portTypeName- the String representation of the portType name
-
getBindingName
Returns the String representation of the binding name- Returns:
- String representation of the binding name
-
setBindingName
Set the String representation of the binding name- Parameters:
bindingName- the String representation of the binding name
-
getTargetService
Returns the target service name- Returns:
- the target service name
-
setTargetService
Set the target service name- Parameters:
targetService- the target service name
-
getDescription
Returns the service description- Returns:
- service description String
-
setDescription
Set the service description- Parameters:
description- service description String
-
getSoapAction
Returns the soapAction option value- Returns:
- the String DEFAULT, NONE or OPERATION
-
setSoapAction
Sets the soapAction option value- Parameters:
value- must be DEFAULT, NONE, or OPERATION
-
getTypeMapping
Returns theTypeMappingused by the service- Returns:
- the
TypeMappingused by the service
-
setTypeMapping
Sets theTypeMappingused by the service- Parameters:
tm- theTypeMappingused by the service
-
getDefaultTypeMapping
Deprecated.Use getTypeMappingRegistry insteadReturns thedefaultTypeMappingused by the service- Returns:
- the
defaultTypeMappingused by the service
-
setDefaultTypeMapping
Deprecated.Use setTypeMappingRegistry insteadSets thedefaultTypeMappingused by the service- Parameters:
tm- thedefaultTypeMappingused by the service
-
setTypeMappingRegistry
Set the TypeMappingRegistry for this Emitter. -
getStyle
getStyle- Returns:
- Style setting (Style.RPC, Style.DOCUMENT, Style.WRAPPED, etc.)
-
setStyle
setStyle- Parameters:
value- String representing a style ("document", "rpc", "wrapped") Note that the case of the string is not important. "document" and "DOCUMENT" are both treated as document style. If the value is not a know style, the default setting is used. See org.apache.axis.constants.Style for a description of the interaction between Style/Use
NOTE: If style is specified as "wrapped", use is set to literal.
-
setStyle
setStyle- Parameters:
value- Style setting
-
getUse
getUse- Returns:
- Use setting (Use.ENCODED, Use.LITERAL)
-
setUse
setUse- Parameters:
value- String representing a use ("literal", "encoded") Note that the case of the string is not important. "literal" and "LITERAL" are both treated as literal use. If the value is not a know use, the default setting is used. See org.apache.axis.constants.Style for a description of the interaction between Style/Use
-
setUse
setUse- Parameters:
value- Use setting
-
setMode
public void setMode(int mode) Deprecated.(use setStyle and setUse)setMode (sets style and use)- Parameters:
mode-
-
getMode
public int getMode()Deprecated.(use getStyle and getUse)getMode (gets the mode based on the style setting)- Returns:
- returns the mode (-1 if invalid)
-
getServiceDesc
Method getServiceDesc- Returns:
-
setServiceDesc
Method setServiceDesc- Parameters:
serviceDesc-
-
getExtraClasses
Return the list of extra classes that the emitter will produce WSDL for.- Returns:
-
setExtraClasses
Provide a list of classes which the emitter will produce WSDL type definitions for.- Parameters:
extraClasses-
-
setExtraClasses
Provide a comma or space seperated list of classes which the emitter will produce WSDL type definitions for. The classes will be added to the current list.- Parameters:
text-- Throws:
ClassNotFoundException
-
setEmitAllTypes
public void setEmitAllTypes(boolean emitAllTypes) -
getVersionMessage
Return the version message- Returns:
- message or null if emitter will use the default
-
setVersionMessage
Set the version message that appears at the top of the WSDL If not set, we use the default version message. If set to an empty string, no version message will be emitted- Parameters:
versionMessage- the message to emit
-
getQName2ClassMap
Return the type qname to java type mapping- Returns:
- mapping of type qname to its corresponding java type
-