HL7 MLLP Connector Reference
MLLP Listener Configuration
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Name |
String |
Name for this configuration. Connectors reference the configuration with this name. |
x |
|
Connection |
Connection types that can be provided to this configuration. |
x |
||
Expiration Policy |
Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. This does not mean that the instance expires at the exact moment that it becomes eligible. Mule purges the instances when appropriate. |
MLLP Listener Connection Type
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Delimiter |
String |
Character code that separates MLLP messages. By default, MLLP uses |
x |
|
TLS Configuration |
Uses SSLServerSocket instead of plain TCPServerSocket for accepting new SSL connections. |
|||
Port |
Number |
Connection’s port number. |
x |
|
Host |
String |
Connection’s host name. |
x |
|
Reconnection |
Configures a reconnection strategy to use when a connector operation fails to connect to an external server. |
|||
Send Buffer Size |
Number |
Size of the buffer used when sending data, in bytes. This is set on the socket. |
||
Receive Buffer Size |
Number |
Size of the buffer used when receiving data, in bytes. This is set on the socket. |
||
Client Timeout |
Number |
SO_TIMEOUT value on the socket, which indicates the amount of time, in milliseconds, that the socket waits in a blocking operation before it fails. A value of |
0 |
|
Reuse Address |
Boolean |
If |
true |
|
Send TCP With No Delay |
Boolean |
If |
true |
|
Linger |
Number |
SO_LINGER value, in milliseconds, which indicates how long the socket takes to close so that remaining data is transmitted correctly. |
||
Keep Alive |
Boolean |
If |
false |
|
Fail On Unresolved Host |
Boolean |
Whether the socket fails during its creation if the host set on the endpoint can’t be resolved. Set this value to |
true |
|
Connection Count |
Number |
Number of connections accepted at one time. This value can be an integer or DataWeave expression. An empty value, negative value, or value of |
||
Server Timeout |
Number |
SO_TIMEOUT value when the socket is used as a server. This is the timeout that applies to the accept operation. A value of |
||
Receive Backlog |
Number |
Maximum queue length for incoming connections. |
50 |
Request Configuration
Configuration for requester sockets.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Name |
String |
Name for this configuration. Connectors reference the configuration with this name. |
x |
|
Connection |
Connection types that can be provided to this configuration. |
x |
||
Expiration Policy |
Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. This does not mean that the instance expires at the exact moment that it becomes eligible. Mule purges the instances when appropriate. |
MLLP Requester Connection Type
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Local Address Settings |
Address that a socket should bind to. |
|||
TLS Configuration |
Configuration for TLS, which can be used from both the client and server sides. |
|||
Port |
Number |
Connection’s port number. |
x |
|
Host |
String |
Connection’s host name. |
x |
|
Reconnection |
Configures a reconnection strategy to use when a connector operation fails to connect to an external server. |
|||
Pooling Profile |
Characteristics of the connection pool. |
|||
Send Buffer Size |
Number |
Size of the buffer used when sending data, in bytes. This is set on the socket. |
||
Receive Buffer Size |
Number |
Size of the buffer used when receiving data, in bytes. This is set on the socket. |
||
Client Timeout |
Number |
SO_TIMEOUT value on sockets. This indicates the amount of time, in milliseconds, that the socket waits in a blocking operation before failing. A value of |
0 |
|
Reuse Address |
Boolean |
If |
true |
|
Send TCP With No Delay |
Boolean |
If |
true |
|
Linger |
Number |
SO_LINGER value, which indicates how long, in milliseconds, the socket takes to close so that any remaining data is transmitted correctly. |
||
Keep Alive |
Boolean |
If |
false |
|
Fail On Unresolved Host |
Boolean |
If |
true |
|
Connection Timeout |
Number |
Number of milliseconds to wait until an outbound connection to a remote server is successfully created. Defaults to 30 seconds. |
30000 |
Sources
MLLP Listener
<mllp:mllp-listener>
Listens for the socket connections of the given protocol in the configured host and port. When a new connection is received, this source schedules a socket worker to handle the communication for that connection.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Output Mime Type |
String |
MIME type of the payload that this operation outputs. |
||
Output Encoding |
String |
Encoding for the payload that this operation outputs. |
||
Primary Node Only |
Boolean |
Whether this source executes only on the primary node when running in a cluster. |
||
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Redelivery Policy |
Configures the redelivery policy for executing requests that generate errors. You can add a redelivery policy to any source in a flow. |
|||
Reconnection Strategy |
Reconnection strategy to use. |
Operations
Send
<mllp:send>
Sends the data using the client associated with the MLLP Requester connection.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Content |
Binary |
Data to serialize and send through the socket. |
|
|
Reconnection Strategy |
Reconnection strategy to use. |
Object Types
CRL File
Specifies the location of the certification revocation list (CRL) file.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Path |
String |
Path to the CRL file. |
Custom OCSP Responder
Configures a custom OCSP responder for certification revocation checks.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Url |
String |
URL of the OCSP responder. |
||
Cert Alias |
String |
Alias of the signing certificate for the OCSP response. If specified, the alias must be in the truststore. |
Expiration Policy
Configures an expiration policy strategy.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Max Idle Time |
Number |
Configures the maximum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. |
||
Time Unit |
Enumeration, one of:
|
Time unit for the Max Idle Time field. |
Immutable Socket Attributes
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Host Address |
String |
Address of the host where the requests are sent. |
||
Host Name |
String |
Name of the host where the requests are sent. |
||
Local Certificates |
Array of Any |
SSL local certificates. If the socket is not an SSL socket, this value is null. |
||
Peer Certificates |
Array of Any |
SSL peer certificates. If the socket is not an SSL socket, this value is null. |
||
Port |
Number |
Port to which the requests are sent. |
Keystore
Configures the keystore for the TLS protocol. The keystore you generate contains a private key and a public certificate.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Path |
String |
Path to the keystore. Mule resolves the path relative to the current classpath and file system. |
||
Type |
String |
Type of keystore. |
||
Alias |
String |
Alias of the key to use when the keystore contains multiple private keys. By default, Mule uses the first key in the file. |
||
Key Password |
String |
Password used to protect the private key. |
||
Password |
String |
Password used to protect the keystore. |
||
Algorithm |
String |
Algorithm used by the keystore. |
Pooling Profile
Configures the pooling profile characteristics.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Max Active |
Number |
Maximum number of Mule components that are active in a session at one time. When set to a negative value, there is no limit to the number of Mule components that are active at one time. When this value is exceeded, the pool is considered exhausted. |
||
Max Idle |
Number |
Maximum number of Mule components that can sit idle in the pool at any time. When set to a negative value, there is no limit. |
||
Max Wait |
Number |
Number of milliseconds to wait for a pooled component to become available when the pool is exhausted and the Exhausted Action is set to |
||
Min Eviction Millis |
Number |
Minimum amount of time that an object can sit idle in the pool before it’s eligible for eviction. When set to a negative value, no objects are evicted from the pool due to idle time alone. |
||
Eviction Check Interval Millis |
Number |
Number of milliseconds between runs of the object evictor. When set to a negative value, no object evictor is executed. |
||
Exhausted Action |
Enumeration, one of:
|
Behavior of the Mule component pool when the pool is exhausted. Possible values are:
|
||
Initialization Policy |
Enumeration, one of:
|
Determines how components in a pool should be initialized. Possible values are:
|
||
Disabled |
Boolean |
If |
Reconnect
Configures a standard reconnection strategy, which specifies how often to reconnect and how many reconnection attempts the connector source or operation can make.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Frequency |
Number |
How often to reconnect, in milliseconds. |
||
Blocking |
Boolean |
If |
||
Count |
Number |
How many reconnection attempts to make. |
Reconnect Forever
Configures a forever reconnection strategy by which the connector source or operation attempts to reconnect at a specified frequency for as long as the Mule app runs.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Frequency |
Number |
How often to reconnect, in milliseconds. |
||
Blocking |
Boolean |
If |
Reconnection
Configures a reconnection strategy for an operation.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Fails Deployment |
Boolean |
What to do if, when an app is deployed, a connectivity test does not pass after exhausting the associated reconnection strategy:
|
||
Reconnection Strategy |
Reconnection strategy to use. |
Redelivery Policy
Configures the redelivery policy for executing requests that generate errors. You can add a redelivery policy to any source in a flow.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Max Redelivery Count |
Number |
Maximum number of times that a redelivered request can be processed unsuccessfully before returning a |
||
Use Secure Hash |
Boolean |
If |
||
Message Digest Algorithm |
String |
Secure hashing algorithm to use if the Use Secure Hash field is |
||
Id Expression |
String |
One or more expressions that determine when a message was redelivered. This field can be set only if the Use Secure Hash field is |
||
Object Store |
ObjectStore |
Configures the object store that stores the redelivery counter for each message. |
Repeatable File Store Stream
Configures the repeatable file-store streaming strategy by which Mule runtime keeps a portion of the stream content in memory. If the stream content is larger than the configured buffer size, Mule backs up the buffer’s content to disk and then clears the memory.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Max In Memory Size |
Number |
Maximum amount of memory that the stream can use for data. If the amount of memory exceeds this value, Mule buffers the content to disk. To optimize performance:
|
||
Buffer Unit |
Enumeration, one of:
|
Unit for the Max In Memory Size field. |
Repeatable In Memory Stream
Configures the in-memory streaming strategy by which the request fails if the data exceeds the maximum buffer size. Always run performance tests to find the optimal buffer size for your specific use case.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Initial Buffer Size |
Number |
Initial amount of memory to allocate to the data stream. If the streamed data exceeds this value, the buffer expands by Buffer Size Increment, with an upper limit of the Max In Memory Size value. |
||
Buffer Size Increment |
Number |
Amount by which the buffer size expands if it exceeds its initial size. Setting a value of |
||
Max Buffer Size |
Number |
Maximum size of the buffer. If the buffer size exceeds this value, Mule raises a |
||
Buffer Unit |
Enumeration, one of:
|
Unit for the Initial Buffer Size, Buffer Size Increment, and Max Buffer Size fields. |
Socket Connection Settings
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Port |
Number |
Connection’s port number. |
x |
|
Host |
String |
Connection’s host name. |
x |
Standard Revocation Check
Configures standard revocation checks for TLS certificates.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Only End Entities |
Boolean |
Which elements to verify in the certificate chain:
|
||
Prefer Crls |
Boolean |
How to check certificate validity:
|
||
No Fallback |
Boolean |
Whether to use the secondary method to check certificate validity:
|
||
Soft Fail |
Boolean |
What to do if the revocation server can’t be reached or is busy:
|
TLS
Configures TLS to provide secure communications for the Mule app.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Enabled Protocols |
String |
Comma-separated list of protocols enabled for this context. |
||
Enabled Cipher Suites |
String |
Comma-separated list of cipher suites enabled for this context. |
||
Trust Store |
Configures the TLS truststore. |
|||
Key Store |
Configures the TLS keystore. |
|||
Revocation Check |
Configures a revocation checking mechanism. |
Truststore
Configures the truststore for TLS.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Path |
String |
Path to the truststore. Mule resolves the path relative to the current classpath and file system. |
||
Password |
String |
Password used to protect the truststore. |
||
Type |
String |
Type of truststore. |
||
Algorithm |
String |
Encryption algorithm that the truststore uses. |
||
Insecure |
Boolean |
If |