POJO Configuration Properties (Sun POJO Service Engine User's Guide)

Sun POJO Service Engine User's Guide

POJO Configuration Properties

When you create a POJO service consumer or provider, with or without binding, you need to configure certain properties so the POJO framework and optionally the WSDL documents can be generated correctly. The following topics describe the properties you need to configure. Note that these do not include specific binding component properties, which you need to configure if you are using bindings. For more information about these properties, see the user's guide for the specific binding component you are using.

POJO Service Provider Properties

The following tables list and describe the properties you can configure when creating a new POJO service. These properties appear on the Name and Location page of the New POJO Service Wizard and on the Advanced Properties Editor, which is accessed from the Name and Location page.

Table 1 POJO Service Provider Name and Location Properties


Property	Description
Class Name	A unique name for the Java class to create for the POJO service.
Location	The location in the project structure to create the Java class and package.
Package	A unique Java package name for the class.
Method Name	The name of the method that represents the operation. This will be automatically generated in the Java class.
Input Argument Type	The input type for the operation. This represents the parameter type for the operation method. Select one of the following values: String (`java.lang.string`) Source (`javax.xml.transform.Source`) Normalized Message (`javax.jbi.messaging.NormalizedMessage`) Node (`org.w3c.dom.Node`) Document Message Exchange (`javax.jbi.messaging.MessageExchange`)
Return Type	The output type for the operation. This represents the return type for the operation method. Select one of the following values: String (`java.lang.string`) Source (`javax.xml.transform.Source`) Normalized Message (`javax.jbi.messaging.NormalizedMessage`) Node (`org.w3c.dom.Node`) Document Void

Table 2 POJO Service Provider Advanced Properties


Property	Description
Endpoint Name	The name of the POJO provider's endpoint.
Interface Name	The local interface name for the POJO provider. If this property is left blank, it defaults to the class name with “Interface” appended. For example, `MyPojoInterface`.
Interface Namespace	Additional interface namespaces for the POJO provider.
Service Name	The local service name for the POJO provider. If this property is left blank, it defaults to the class name with “Service” appended. For example, `MyPojoService`.
Service Namespace	The namespace of the JBI service. If this property is left blank, the default namespace will be an HTTP URL with the package name of class reversed and the endpoint name as the path. For example, if the package is `org.glassfish.openesb.pojo` and the endpoint name is MyPojoProvider, the URL will be `http://pojo.openesb.glassfish.org/MyPojoProvider/`.
Output Message Type Name	The WSDL message type for output messages for a return type of String, Node, or Source if the consuming JBI component expects the WSDL 1.1 wrapper message to contain these attributes.
Output Message Type Namespace	The namespace of the output message type specified above.

POJO Service Properties for Binding

The following table lists and describes the properties you can configure when creating a new POJO service provider or consumer with a binding component. These properties appear on the Name and Location page of the New POJO Service for Binding Wizard and the POJO SE Binding Service Consumer Wizard.

Table 3 Name and Location Properties for Binding


Property	Description
File Name	A unique name for the binding WSDL document for the POJO service.
Location	The name of the node in the project structure in which to create the WSDL document.
Folder	The name of the folder under the above node in which to create the WSDL document.
Target Namespace	The target namespace for the binding WSDL document.
Binding	The type of binding component to use for the POJO service. This determines the template for the WSDL document.
Type	The type of binding. Note that for some binding components, only a subset of their types is supported.

POJO Service Consumer Properties

The following table lists and describes the properties you can configure when creating a new POJO service consumer. These properties appear on the POJO SE Service Consumer Wizard.

Table 4 POJO Consumer Wizard Properties


Property	Description
Choose Consumer From WSDL	An indicator of whether to create the consumer endpoint from an existing WSDL document. You can specify a local path and filename or the URL for the WSDL document.
Select From File	The path and file name of the local WSDL document to use. Pressing the Tab key after entering this value populates the interface and operation fields.
Select From URL	The URL to the remote WSDL document to use. Pressing the Tab key after entering a URL populates the interface and operation fields.
Interface Name	The name of the consumer interface.
Interface Namespace	The namespace for the consumer interface.
Operation	The type of binding operation for the consumer.
Operation Namespace	The namespace for the binding operation.
Invoke Pattern	An indicator of whether to invoke the consumer synchronously or asynchronously. Select the appropriate checkbox. Both options may not be available for some operations.
Invoke Input Type	The input type for the operation. This represents the parameter type for the operation method. Select one of the following values: String (`java.lang.string`) Source (`javax.xml.transform.Source`) Normalized Message (`javax.jbi.messaging.NormalizedMessage`) Node (`org.w3c.dom.Node`) Document Message Exchange (`javax.jbi.messaging.MessageExchange`)
Return Type	The output type for the operation. This represents the return type for the operation method. Select one of the following values: String (`java.lang.string`) Source (`javax.xml.transform.Source`) Normalized Message (`javax.jbi.messaging.NormalizedMessage`) Node (`org.w3c.dom.Node`) Document Void
Invoke From Method	The method from which the consumer is invoked. When you drag and drop the POJO Consumer from the Palette into a Java method, that method name is automatically populated here.