com.wm.app.b2b.client

Class JSONClient

java.lang.Object

com.wm.app.b2b.client.BaseContext

com.wm.app.b2b.client.Context

com.wm.app.b2b.client.JSONClient

public class JSONClient
extends Context

Extends Context with invoke and invokeThreaded methods that accept JSON text. The character encoding used when serializing and deserializing the JSON text defaults to "UTF-8". Call the setEncoding(JSON_ENCODING) method prior to calling the invoke or invokeThreaded methods to use a different encoding.

Note: JSONClient requires that the SoftwareAG_directory/common/lib/glassfish/gf-jackson-core-asl.jar is present in the classpath. Without gf-jackson-core-asl.jar, JSONClient cannot parse JSON responses.

Field Summary

Fields inherited from class com.wm.app.b2b.client.Context

CONTENT_TYPE_HTML, CONTXT0003, CONTXT0004, CONTXT0005, CONTXT0006, CONTXT0007, CONTXT0008, CONTXT0009, DISCONNECT_MSG, HTTP_HEADER_CONTENT_TYPE, HTTP_OK_RESPONSE_CODE, PING_FAILED_MSG, PING_SERVER_MSG, TIME_OUT_MSG, TRY_PING_MSG, UNKNOWN_HOST_MSG, UNNOWN_PARTNER_MSG

Fields inherited from class com.wm.app.b2b.client.BaseContext

NO_SSL, RPC_BIN, RPC_IDAT, RPC_XML, SSL_128, SSL_40

Constructor Summary

Constructors

Constructor and Description
JSONClient() Creates a JSONClient.

Method Summary

Modifier and Type	Method and Description
IDataJSONCoder.JSON_ENCODING	getEncoding()
java.lang.String	invoke(java.lang.String ifc, java.lang.String svc, java.lang.String jsonData) Invokes a service on an Integration Server.
InvokeThread	invokeThreaded(NSName svcName, java.lang.String jsonData) Calls invoke asynchronously and returns an InvokeThread.
InvokeThread	invokeThreaded(java.lang.String ifc, java.lang.String svc, java.lang.String jsonData) Calls invoke asynchronously and returns an InvokeThread.
void	setEncoding(IDataJSONCoder.JSON_ENCODING encoding) Sets the character encoding used when serializing and deserializing the JSON text.

Methods inherited from class com.wm.app.b2b.client.Context

appletSetup, cleanUpConnection, connect, connect, connect, connect, disconnect, disconnect, fakeConnect, getCookies, getCookiesAsArray, getNamespace, getQuery, invoke, invoke, invoke, invoke, invoke, invoke, invokeThreaded, invokeThreaded, setCookie

Methods inherited from class com.wm.app.b2b.client.BaseContext

getSSLSupport, isClusteredEnv, isConnected, isSecure, isUseJSSE, setAllowRedir, setAuthentication, setFixedUri, setProxy, setRetryServer, setSecure, setSecureProxy, setSSLCertificates, setSSLCertificates, setSSLCertificates, setUseJSSE

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JSONClient

public JSONClient()

Creates a JSONClient.

Method Detail

setEncoding

public void setEncoding(IDataJSONCoder.JSON_ENCODING encoding)

Sets the character encoding used when serializing and deserializing the JSON text. Defaults to "UTF-8". To use a different character set, call this method prior to calling an invoke method.

Parameters:

encoding - The possible values are:

• JSON_ENCODING.UTF8 - UTF-8
• JSON_ENCODING.UTF16_BE - UTF-16 big endian
• JSON_ENCODING.UTF16_LE - UTF-16 little endian
• JSON_ENCODING.UTF32_BE - UTF-32 big endian
• JSON_ENCODING.UTF32_LE - UTF-32 little endian

getEncoding

public IDataJSONCoder.JSON_ENCODING getEncoding()

Returns:

The character encoding in use. See #setEncoding(JSON_ENCODING).

invoke

public java.lang.String invoke(java.lang.String ifc,
                               java.lang.String svc,
                               java.lang.String jsonData)
                        throws ServiceException

Invokes a service on an Integration Server. Prior to calling this method, use one of the connect methods to connect to an Integration Server.

Parameters:

ifc - The interface of the service to invoke.

svc - The name of the service to invoke.

jsonData - A string holding JSON text containing the input to the service being invoked.

Returns:

A string holding JSON text containing the output from the invoked service.

Throws:

ServiceException - If this JSONClient is not connected to an Integration Server or if the server threw an Exception while processing this request.

invokeThreaded

public InvokeThread invokeThreaded(NSName svcName,
                                   java.lang.String jsonData)

Calls invoke asynchronously and returns an InvokeThread. The getJSONData method can then be called on the returned InvokeThread to retrieve the results of the service invocation.

Parameters:

svcName - namespace name of the service to invoke

jsonData - input data for the service

Returns:

an InvokeThread. Call InvokeThread#getJSONData() to get the results of the service invocation.

See Also:

#invoke(String, String, String)}

invokeThreaded

public InvokeThread invokeThreaded(java.lang.String ifc,
                                   java.lang.String svc,
                                   java.lang.String jsonData)

Calls invoke asynchronously and returns an InvokeThread. The getJSONData method can then be called on the returned InvokeThread to retrieve the results of the service invocation.

Parameters:

ifc - interface name of the service to invoke

svc - service to invoke

jsonData - input data for the service

Returns:

an InvokeThread. Call InvokeThread#getJSONData() to get the results of the service invocation.

See Also:

#invoke(String, String, String)}