Class MT029

  • All Implemented Interfaces:
    JsonSerializable, java.io.Serializable

    @Generated
    public class MT029
    extends AbstractMT
    implements java.io.Serializable
    MT 029 - FINCopy Message Status Report.

    SWIFT MT029 (ISO 15022) message structure:

    • Field 202 (M)
    • Field 203 (M)
    • Field 177 (O) (repetitive)
    • Field 103 (O)
    • Field 343 (O)
    • Field 533 (O)
    • Field 106 (O) (repetitive)

    This source code is specific to release SRU 2022

    For additional resources check https://www.prowidesoftware.com/resources

    See Also:
    Serialized Form
    • Field Detail

      • SRU

        public static final int SRU
        Constant identifying the SRU to which this class belongs to.
        See Also:
        Constant Field Values
      • NAME

        public static final java.lang.String NAME
        Constant for MT name, this is part of the classname, after MT.
        See Also:
        Constant Field Values
    • Constructor Detail

      • MT029

        public MT029​(SwiftMessage m)
        Creates an MT029 initialized with the parameter SwiftMessage.
        Parameters:
        m - swift message with the MT029 content
      • MT029

        public MT029​(MtSwiftMessage m)
        Creates an MT029 initialized with the parameter MtSwiftMessage.
        Parameters:
        m - swift message with the MT029 content, the parameter can not be null
        See Also:
        MT029(String)
      • MT029

        public MT029()
        Creates and initializes a new MT029 input message setting TEST BICS as sender and receiver. All mandatory header attributes are completed with default values.
        Since:
        7.6
      • MT029

        public MT029​(java.lang.String sender,
                     java.lang.String receiver)
        Creates and initializes a new MT029 input message from sender to receiver. All mandatory header attributes are completed with default values. In particular the sender and receiver addresses will be filled with proper default LT identifier and branch codes if not provided,
        Parameters:
        sender - the sender address as a bic8, bic11 or full logical terminal consisting of 12 characters
        receiver - the receiver address as a bic8, bic11 or full logical terminal consisting of 12 characters
        Since:
        7.7
      • MT029

        public MT029​(java.lang.String fin)
        Creates a new MT029 by parsing a String with the message content in its swift FIN format. If the fin parameter is null or the message cannot be parsed, the internal message object will be initialized (blocks will be created) but empty. If the string contains multiple messages, only the first one will be parsed.
        Parameters:
        fin - a string with the MT message in its FIN swift format
        Since:
        7.7
      • MT029

        public MT029​(java.io.InputStream stream)
              throws java.io.IOException
        Creates a new MT029 by parsing a input stream with the message content in its swift FIN format, using "UTF-8" as encoding. If the message content is null or cannot be parsed, the internal message object will be initialized (blocks will be created) but empty. If the stream contains multiple messages, only the first one will be parsed.
        Parameters:
        stream - an input stream in UTF-8 encoding with the MT message in its FIN swift format.
        Throws:
        java.io.IOException - if the stream data cannot be read
        Since:
        7.7
      • MT029

        public MT029​(java.io.File file)
              throws java.io.IOException
        Creates a new MT029 by parsing a file with the message content in its swift FIN format. If the file content is null or cannot be parsed as a message, the internal message object will be initialized (blocks will be created) but empty. If the file contains multiple messages, only the first one will be parsed.
        Parameters:
        file - a file with the MT message in its FIN swift format.
        Throws:
        java.io.IOException - if the file content cannot be read
        Since:
        7.7
    • Method Detail

      • parse

        public static MT029 parse​(MtSwiftMessage m)
        Creates an MT029 initialized with the parameter MtSwiftMessage.
        Parameters:
        m - swift message with the MT029 content
        Returns:
        the created object or null if the parameter is null
        Since:
        7.7
        See Also:
        MT029(String)
      • parse

        public static MT029 parse​(java.lang.String fin)
        Creates a new MT029 by parsing a String with the message content in its swift FIN format. If the fin parameter cannot be parsed, the returned MT029 will have its internal message object initialized (blocks will be created) but empty. If the string contains multiple messages, only the first one will be parsed.
        Parameters:
        fin - a string with the MT message in its FIN swift format. fin may be null in which case this method returns null
        Returns:
        a new instance of MT029 or null if fin is null
        Since:
        7.7
      • parse

        public static MT029 parse​(java.io.InputStream stream)
                           throws java.io.IOException
        Creates a new MT029 by parsing a input stream with the message content in its swift FIN format, using "UTF-8" as encoding. If the stream contains multiple messages, only the first one will be parsed.
        Parameters:
        stream - an input stream in UTF-8 encoding with the MT message in its FIN swift format.
        Returns:
        a new instance of MT029 or null if stream is null or the message cannot be parsed
        Throws:
        java.io.IOException - if the stream data cannot be read
        Since:
        7.7
      • parse

        public static MT029 parse​(java.io.File file)
                           throws java.io.IOException
        Creates a new MT029 by parsing a file with the message content in its swift FIN format. If the file contains multiple messages, only the first one will be parsed.
        Parameters:
        file - a file with the MT message in its FIN swift format.
        Returns:
        a new instance of MT029 or null if; file is null, does not exist, can't be read, is not a file or the message cannot be parsed
        Throws:
        java.io.IOException - if the file content cannot be read
        Since:
        7.7
      • getMessageType

        public java.lang.String getMessageType()
        Returns this MT number.
        Specified by:
        getMessageType in class AbstractMT
        Returns:
        the message type number of this MT
        Since:
        6.4
      • append

        public MT029 append​(SwiftTagListBlock block)
        Add all tags from block to the end of the block4.
        Overrides:
        append in class AbstractMT
        Parameters:
        block - to append
        Returns:
        this object to allow method chaining
        Since:
        7.6
      • append

        public MT029 append​(Tag... tags)
        Add all tags to the end of the block4.
        Overrides:
        append in class AbstractMT
        Parameters:
        tags - to append
        Returns:
        this object to allow method chaining
        Since:
        7.6
      • append

        public MT029 append​(Field... fields)
        Add all the fields to the end of the block4.
        Overrides:
        append in class AbstractMT
        Parameters:
        fields - to append
        Returns:
        this object to allow method chaining
        Since:
        7.6
      • fromJson

        public static MT029 fromJson​(java.lang.String json)
        Creates an MT029 messages from its JSON representation.

        For generic conversion of JSON into the corresponding MT instance see AbstractMT.fromJson(String)

        Parameters:
        json - a JSON representation of an MT029 message
        Returns:
        a new instance of MT029
        Since:
        7.10.3
      • getField202

        public Field202 getField202()
        Iterates through block4 fields and return the first one whose name matches 202, or null if none is found. The first occurrence of field 202 at MT029 is expected to be the only one.
        Returns:
        a Field202 object or null if the field is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagByName(String)
      • getField203

        public Field203 getField203()
        Iterates through block4 fields and return the first one whose name matches 203, or null if none is found. The first occurrence of field 203 at MT029 is expected to be the only one.
        Returns:
        a Field203 object or null if the field is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagByName(String)
      • getField103

        public Field103 getField103()
        Iterates through block4 fields and return the first one whose name matches 103, or null if none is found. The first occurrence of field 103 at MT029 is expected to be the only one.
        Returns:
        a Field103 object or null if the field is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagByName(String)
      • getField343

        public Field343 getField343()
        Iterates through block4 fields and return the first one whose name matches 343, or null if none is found. The first occurrence of field 343 at MT029 is expected to be the only one.
        Returns:
        a Field343 object or null if the field is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagByName(String)
      • getField533

        public Field533 getField533()
        Iterates through block4 fields and return the first one whose name matches 533, or null if none is found. The first occurrence of field 533 at MT029 is expected to be the only one.
        Returns:
        a Field533 object or null if the field is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagByName(String)
      • getField177

        public java.util.List<Field177> getField177()
        Iterates through block4 fields and return all occurrences of fields whose names matches 177, or Collections.emptyList() if none is found. Multiple occurrences of field 177 at MT029 are expected at one sequence or across several sequences.
        Returns:
        a List of Field177 objects or Collections.emptyList() if none is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagsByName(String)
      • getField106

        public java.util.List<Field106> getField106()
        Iterates through block4 fields and return all occurrences of fields whose names matches 106, or Collections.emptyList() if none is found. Multiple occurrences of field 106 at MT029 are expected at one sequence or across several sequences.
        Returns:
        a List of Field106 objects or Collections.emptyList() if none is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagsByName(String)