org.mule.modules.jde.internal.connection

Class JDEAtinaConnection

java.lang.Object

org.mule.modules.jde.internal.connection.JDEAtinaConnection

public final class JDEAtinaConnection
extends Object

Represents the active connection between MuleSoft and the JDE Atina Microservice.

This class is responsible for managing the lifecycle of a connection, including establishing, validating, and closing sessions with both JD Edwards Web Services and the Atina Microservice.

Responsibilities

• Initialize and manage an instance of JDEAtinaClient.
• Provide thread-safety through LockFactory for concurrent operations.
• Expose operations for:
  • User authentication and logout
  • Transaction management
  • Invocation of Web Services (WS) and Business Functions (BSFN)
  • Submission and status retrieval of UBEs
  • Retrieval of input/output metadata for JDE operations
• Validate connection health through ConnectionValidationResult.

Error Handling

Specific exceptions such as AuthenticateException, GetWSMetadataException, and JDEAtinaConnectionException are thrown to represent failures during connection and operation execution.

Usage

A single JDEAtinaConnection instance is created by the JDEAtinaConnectionProvider and is shared across connector operations. It ensures proper login/logout to JDE resources and maintains state throughout the lifecycle of the Mule application.

Since:

1.0

See Also:

JDEAtinaConnectionProvider, JDEAtinaClient, JDAtinaConnectorServiceImpl

Constructor Summary

Constructors

Constructor and Description
JDEAtinaConnection(org.mule.runtime.api.lock.LockFactory lockFactory, JDEAtinaWSConnectionProperties jdeAtinaWSConnectionProperties, JDEAtinaMicroserverConnectionProperties jdeAtinaMicroserverConnectionProperties)

Method Summary

Modifier and Type	Method and Description
Map<String,Serializable>	authenticate(String authenticateOperation, Map<String,Object> entityData) Authenticate
void	connect()
void	disconnect()
List<com.jde.jdeserverwp.servicios.TipoDelParametroInput>	getOperationInputMetadata(String wsName, String connectorName) WS Input Metadata
Map<String,String>	getOperationListMetadata(String connectorName) WS Metadata
List<com.jde.jdeserverwp.servicios.TipoDelParametroOutput>	getOperationOutputMetadata(String wsName, String connectorName) WS Output Metadata
void	invalidate()
Map<String,Serializable>	invokeOperation(String wsName, String connectorName, Map<String,Object> entityData) Invoke WS, BSFN, Get Job Status, Submit UBE
boolean	isConnected()
Map<String,Serializable>	logout(Map<String,Object> entityData) Logout
Map<String,Serializable>	transaction(String transactionOperation, Map<String,Object> entityData) Transaction
org.mule.runtime.api.connection.ConnectionValidationResult	validateConnection() Validates the underlying connection to the remote server

Methods inherited from class java.lang.Object

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

Constructor Detail

JDEAtinaConnection

public JDEAtinaConnection(org.mule.runtime.api.lock.LockFactory lockFactory,
                          JDEAtinaWSConnectionProperties jdeAtinaWSConnectionProperties,
                          JDEAtinaMicroserverConnectionProperties jdeAtinaMicroserverConnectionProperties)

Method Detail

connect

public void connect()

disconnect

public void disconnect()

isConnected

public boolean isConnected()

validateConnection

public org.mule.runtime.api.connection.ConnectionValidationResult validateConnection()

Validates the underlying connection to the remote server

Returns:

a ConnectionValidationResult

invalidate

public void invalidate()

authenticate

public Map<String,Serializable> authenticate(String authenticateOperation,
                                             Map<String,Object> entityData)

Authenticate

Parameters:

authenticateOperation - Operation Mode

entityData - Authenticate input parameter List

Returns:

a map containing the fields and values returned by the generic function call

Throws:

AuthenticateException - if an error occurs

transaction

public Map<String,Serializable> transaction(String transactionOperation,
                                            Map<String,Object> entityData)

Transaction

Parameters:

transactionOperation - Operation Mode

entityData - Transaction input parameter List

Returns:

a map containing the fields and values returned by the generic function call

Throws:

AuthenticateException - if an error occurs

logout

public Map<String,Serializable> logout(Map<String,Object> entityData)

Logout

Parameters:

entityData - Authenticate input parameter List

Returns:

a map containing the fields and values returned by the generic function call

Throws:

AuthenticateException - if an error occurs

invokeOperation

public Map<String,Serializable> invokeOperation(String wsName,
                                                String connectorName,
                                                Map<String,Object> entityData)

Invoke WS, BSFN, Get Job Status, Submit UBE

Parameters:

wsName -

connectorName - Mode

entityData - WS input parameter List

Returns:

a map containing the fields and values returned by the WS call

Throws:

AuthenticateException - if an error occurs

getOperationListMetadata

public Map<String,String> getOperationListMetadata(String connectorName)

WS Metadata

Returns:

a map containing the fields and values returned by the WS Metadata call

Throws:

GetWSMetadataException - if an error occurs

getOperationInputMetadata

public List<com.jde.jdeserverwp.servicios.TipoDelParametroInput> getOperationInputMetadata(String wsName,
                                                                                           String connectorName)

WS Input Metadata

Parameters:

wsName - Operation Name

connectorName - Mode

Returns:

a map containing the fields and values returned by the WS Metadata Input call

Throws:

AuthenticateException - if an error occurs

getOperationOutputMetadata

public List<com.jde.jdeserverwp.servicios.TipoDelParametroOutput> getOperationOutputMetadata(String wsName,
                                                                                             String connectorName)
                                                                                      throws GetWSMetadataException

WS Output Metadata

Parameters:

wsName - Operation Name

connectorName - Mode

Returns:

a map containing the fields and values returned by the WS Metadata Input call

Throws:

AuthenticateException - if an error occurs

GetWSMetadataException