AbstractMX (Prowide Core API Reference)

java.lang.Object
- com.prowidesoftware.swift.model.AbstractMessage
- - com.prowidesoftware.swift.model.mx.AbstractMX

All Implemented Interfaces:

JsonSerializable, IDocument
```
public abstract class AbstractMX
extends AbstractMessage
implements IDocument, JsonSerializable
```
Base class for specific MX messages.
IMPORTANT: An MX message is conformed by a set of optional headers and a message payload or document with the actual specific MX message. The name of the envelope element that binds a Header to the message to which it applies is implementation/network specific and not part of the scope of this model.
This class provides the base container model for MX messages including an attribute for the header. Further it supports both versions for the header; the SWIFT Application Header (legacy) and the ISO Business Application Header.
Subclasses in Prowide Integrator SDK implement the Document portion of each specific MX message type.
Serialization of this model into XML text can be done for the with or without the header portion. When the header is set and included into the serialization, the container root element must be provided.

Since:

7.6

See Also:

AbstractMT

Constructor Summary

Constructors
Modifier Constructor and Description

protected AbstractMX()

protected AbstractMX(BusinessHeader businessHeader)

Constructors
Modifier	Constructor and Description
`protected`	`AbstractMX()`
`protected`	`AbstractMX(BusinessHeader businessHeader)`

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`java.lang.String`	`document()` Get this message document as an XML string.
`java.lang.String`	`document(java.lang.String prefix, boolean includeXMLDeclaration)` Get this message document as an XML string.
`org.w3c.dom.Element`	`element()`
`static AbstractMX`	`fromJson(java.lang.String json)` Creates an MX messages from its JSON representation.
`protected static <T> T`	`fromJson(java.lang.String json, java.lang.Class<T> classOfT)` Used by subclasses to implement JSON deserialization.
`BusinessHeader`	`getBusinessHeader()`
`abstract java.lang.String`	`getBusinessProcess()` get the Alphabetic code in four positions (fixed length) identifying the Business Process
`abstract java.lang.Class[]`	`getClasses()` Get the classes associated with this message
`abstract int`	`getFunctionality()` Get the code identifying the Message Functionality
`MxId`	`getMxId()` Returns the MX message identification. Composed by the business process, functionality, variant and version.
`abstract java.lang.String`	`getNamespace()` Get the XML namespace of the message
`abstract int`	`getVariant()` Get the Message variant
`abstract int`	`getVersion()` Get the message version
`java.lang.String`	`header()` Get this message business header as an XML string.
`java.lang.String`	`header(java.lang.String prefix, boolean includeXMLDeclaration)` Get this message business header as an XML string.
`java.lang.String`	`message()` Get this message document as an XML string (headers not included).
`java.lang.String`	`message(java.lang.String rootElement)` Same as `message(String)` with includeXMLDeclaration set to true
`protected static java.lang.String`	`message(java.lang.String namespace, AbstractMX obj, java.lang.Class[] classes, java.lang.String prefix, boolean includeXMLDeclaration)`
`java.lang.String`	`message(java.lang.String rootElement, boolean includeXMLDeclaration)` Get this message as an XML string.
`static AbstractMX`	`parse(java.io.File file, MxId id)` Parses a file content into a specific instance of Mx.
`static AbstractMX`	`parse(java.lang.String xml, MxId id)` Parses the XML string containing the Document element of an MX message into a specific instance of MX message object.
`protected static AbstractMX`	`read(java.lang.Class<? extends AbstractMX> targetClass, java.lang.String xml, java.lang.Class[] classes)`
`void`	`setBusinessHeader(BusinessHeader businessHeader)`
`java.lang.String`	`toJson()` Get a JSON representation of this MX message.
`void`	`write(java.io.File file)` Writes the message document content into a file in XML format (headers not included).
`void`	`write(java.io.OutputStream stream)` Writes the message document content into a file in XML format, encoding content in UTF-8 (headers not included).
`javax.xml.transform.Source`	`xmlSource()` Convenience method to get this message XML as javax.xml.transform.Source.

Methods inherited from class com.prowidesoftware.swift.model.AbstractMessage
getMessageStandardType, isMT, isMX

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - AbstractMX
```
protected AbstractMX()
```
  - AbstractMX
```
protected AbstractMX(BusinessHeader businessHeader)
```
- Method Detail
  - message
```
protected static java.lang.String message(java.lang.String namespace,
                                          AbstractMX obj,
                                          java.lang.Class[] classes,
                                          java.lang.String prefix,
                                          boolean includeXMLDeclaration)
```
  - read
```
protected static AbstractMX read(java.lang.Class<? extends AbstractMX> targetClass,
                                 java.lang.String xml,
                                 java.lang.Class[] classes)
```
  - getClasses
```
public abstract java.lang.Class[] getClasses()
```
    Get the classes associated with this message
    
    Since:
    
    7.7
  - getNamespace
```
public abstract java.lang.String getNamespace()
```
    Get the XML namespace of the message
    
    Since:
    
    7.7
  - getBusinessProcess
```
public abstract java.lang.String getBusinessProcess()
```
    get the Alphabetic code in four positions (fixed length) identifying the Business Process
    
    Returns:
    
    the business process of the implementing class
    
    Since:
    
    7.7
  - getFunctionality
```
public abstract int getFunctionality()
```
    Get the code identifying the Message Functionality
    
    Returns:
    
    the set functionality or null if not set
    
    Since:
    
    7.7
  - getVariant
```
public abstract int getVariant()
```
    Get the Message variant
    
    Returns:
    
    the set variant or null if not set
    
    Since:
    
    7.7
  - getVersion
```
public abstract int getVersion()
```
    Get the message version
    
    Returns:
    
    the set vesion or null if not set
    
    Since:
    
    7.7
  - message
```
public java.lang.String message()
```
    Get this message document as an XML string (headers not included). The XML will include the XML declaration, the corresponding namespace and a "Doc" prefix for the namespace.
    
    Since:
    
    7.7
    
    See Also:
    
    message(String, boolean)
  - message
```
public java.lang.String message(java.lang.String rootElement,
                                boolean includeXMLDeclaration)
```
    Get this message as an XML string.
    If the business header is set, the created XML will include both the header and the document elements, under a default root element.
    If the header is not present, the created XMl will only include the document.
    Both header and document are generated with namespace declaration and default prefixes.
    IMPORTANT: The name of the envelope element that binds a Header to the message to which it applies is implementation/network specific. The header root element ‘AppHdr’ and the ISO 20022 MessageDefinition root element ‘Document’ must always be sibling elements in any XML document, with the AppHdr element preceding the Document element.
    
    Parameters:
    
    rootElement - optional specification of the root element
    
    Returns:
    
    created XML
    
    Since:
    
    7.8
  - message
```
public java.lang.String message(java.lang.String rootElement)
```
    Same as message(String) with includeXMLDeclaration set to true
    
    Since:
    
    7.8
  - header
```
public java.lang.String header()
```
    Get this message business header as an XML string.
    The XML will not include the XML declaration, and will include de namespace as default (without prefix).
    
    Returns:
    
    the serialized header or null if header is not set
    
    Since:
    
    7.8
    
    See Also:
    
    header(String, boolean)
  - header
```
public java.lang.String header(java.lang.String prefix,
                               boolean includeXMLDeclaration)
```
    Get this message business header as an XML string.
    
    Parameters:
    
    prefix - optional prefix for namespace (empty by default)
    
    includeXMLDeclaration - true to include the XML declaration (false by default)
    
    Returns:
    
    header serialized into XML string or null if neither header version is present
    
    Since:
    
    7.8
    
    See Also:
    
    BusinessHeader.xml(String, boolean)
  - document
```
public java.lang.String document()
```
    Get this message document as an XML string. Same as message()
    
    Since:
    
    7.8
  - document
```
public java.lang.String document(java.lang.String prefix,
                                 boolean includeXMLDeclaration)
```
    Get this message document as an XML string.
    
    Parameters:
    
    prefix - optional prefix for namespace (empty by default)
    
    includeXMLDeclaration - true to include the XML declaration (false by default)
    
    Returns:
    
    document serialized into XML string or null if errors occur during serialization
    
    Since:
    
    7.8
  - xmlSource
```
public javax.xml.transform.Source xmlSource()
```
    Convenience method to get this message XML as javax.xml.transform.Source. Notice this method will return only the document element of the message (headers not included).
    
    Returns:
    
    null if message() returns null or StreamSource in other case
    
    Since:
    
    7.7
    
    See Also:
    
    message()
  - write
```
public void write(java.io.File file)
           throws java.io.IOException
```
    Writes the message document content into a file in XML format (headers not included).
    
    Parameters:
    
    file - a not null file to write, if it does not exists, it will be created
    
    Throws:
    
    java.io.IOException
    
    Since:
    
    7.7
  - write
```
public void write(java.io.OutputStream stream)
           throws java.io.IOException
```
    Writes the message document content into a file in XML format, encoding content in UTF-8 (headers not included).
    
    Parameters:
    
    stream - a non null stream to write
    
    Throws:
    
    java.io.IOException - if the stream cannot be written
    
    Since:
    
    7.7
  - getBusinessHeader
```
public BusinessHeader getBusinessHeader()
```
    Returns:
    
    the business header or null if not set
    
    Since:
    
    7.7
  - setBusinessHeader
```
public void setBusinessHeader(BusinessHeader businessHeader)
```
    Parameters:
    
    businessHeader - the header to set
    
    Since:
    
    7.8
  - getMxId
```
public MxId getMxId()
```
    Returns the MX message identification.
    Composed by the business process, functionality, variant and version.
    
    Returns:
    
    the constructed message id
    
    Since:
    
    7.7
  - element
```
public org.w3c.dom.Element element()
```
  - parse
```
public static AbstractMX parse(java.lang.String xml,
                               MxId id)
```
    Parses the XML string containing the Document element of an MX message into a specific instance of MX message object.
    If the string is empty, does not contain an MX document, the message type cannot be detected or an error occur reading and parsing the message content; this method returns null.
    The implementation detects the message type and uses reflection to call the parser in the specific Mx subclass.
    IMPORTANT: For the moment this is supported only in Prowide Integrator. To parse XML into the generic MxNode structure, or to parse business headers check MxParser
    
    Parameters:
    
    xml - string a string containing the Document of an MX message in XML format
    
    id - optional parameter to indicate the specific MX type to create; autodetected from namespace if null.
    
    Returns:
    
    parser message or null if string content could not be parsed into an Mx
    
    Since:
    
    7.8.4
  - parse
```
public static AbstractMX parse(java.io.File file,
                               MxId id)
                        throws java.io.IOException
```
    Parses a file content into a specific instance of Mx.
    IMPORTANT: For the moment this is supported only in Prowide Integrator. To parse XML into the generic MxNode structure, or to parse business headers check MxParser
    
    Parameters:
    
    file - a file containing a swift MX message
    
    id - optional parameter to indicate the specific MX type to create; autodetected from namespace if null.
    
    Returns:
    
    parser message or null if file content could not be parsed
    
    Throws:
    
    java.io.IOException - if the file cannot be written
    
    Since:
    
    7.8.4
    
    See Also:
    
    parse(String, MxId)
  - toJson
```
public java.lang.String toJson()
```
    Get a JSON representation of this MX message.
    
    Specified by:
    
    toJson in interface JsonSerializable
    
    Since:
    
    7.10.3
  - fromJson
```
protected static <T> T fromJson(java.lang.String json,
                                java.lang.Class<T> classOfT)
```
    Used by subclasses to implement JSON deserialization.
    
    Parameters:
    
    json - a JSON representation of an MX message
    
    classOfT - the specific MX subclass
    
    Returns:
    
    a specific deserialized MX message object
    
    Since:
    
    7.10.3
  - fromJson
```
public static AbstractMX fromJson(java.lang.String json)
```
    Creates an MX messages from its JSON representation.
    
    Parameters:
    
    json - a JSON representation of an MX message
    
    Returns:
    
    a specific deserialized MX message object, for example MxPain00100108
    
    Since:
    
    7.10.3

Class AbstractMX

Constructor Summary

Method Summary

Methods inherited from class com.prowidesoftware.swift.model.AbstractMessage

Methods inherited from class java.lang.Object

Constructor Detail

AbstractMX

AbstractMX

Method Detail

message

read

getClasses

getNamespace

getBusinessProcess

getFunctionality

getVariant

getVersion

message

message

message

header

header

document

document

xmlSource

write

write

getBusinessHeader

setBusinessHeader

getMxId

element

parse

parse

toJson

fromJson

fromJson