com.prowidesoftware.swift.model

Class SwiftMessageUtils

java.lang.Object

com.prowidesoftware.swift.model.SwiftMessageUtils

public class SwiftMessageUtils
extends Object

Utility methods that provide higher level access to SwiftMessage

Since:

6.0

Author:

www.prowidesoftware.com

Constructor Summary

Constructors

Constructor and Description
SwiftMessageUtils()
SwiftMessageUtils(SwiftMessage m)

Method Summary

Methods

Modifier and Type	Method and Description
static String	calculateChecksum(SwiftMessage model) Proprietary checksum for message integrity verification.
List<String>	currencyStrings()
static List<String>	currencyStrings(SwiftMessage m) Mirrors logic on CurrencyContainer.currencyStrings() including all fields
static Map<String,SwiftTagListBlock>	splitByField15(SwiftMessage msg) Split the given message by the field 15, returning the letter option in the field 15 as the key in the map.
static List<SwiftTagListBlock>	splitByField15(SwiftMessage msg, String letterOption) Helper method to retrieve all sequences starting with 15X where X is the letterOption parameter
static Map<String,SwiftTagListBlock>	splitByField15(SwiftTagListBlock block) Split the given block content by the field 15, returning the letter option in the field 15 as the key in the map
static List<SwiftTagListBlock>	splitByField15(SwiftTagListBlock block, String letterOption) Helper method to retrieve all sequences starting with 15X where X is the letterOption parameter.
Calendar	valueDate()
static Calendar	valueDate(SwiftMessage m) Gets the value date of a message. The value date is meaningful and defined by the standard only for a subset of message types.

Methods inherited from class java.lang.Object

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

Constructor Detail

SwiftMessageUtils

public SwiftMessageUtils()

SwiftMessageUtils

public SwiftMessageUtils(SwiftMessage m)

Method Detail

currencyStrings

public List<String> currencyStrings()

currencyStrings

public static List<String> currencyStrings(SwiftMessage m)

Mirrors logic on CurrencyContainer.currencyStrings() including all fields

Parameters:

m -

Returns:

an empty list if none found

valueDate

public Calendar valueDate()

See Also:

valueDate(SwiftMessage)

valueDate

public static Calendar valueDate(SwiftMessage m)

Gets the value date of a message.

The value date is meaningful and defined by the standard only for a subset of message types. In most of the cases it is contained in the date subfield of field 32A (for example MT103) or field 30 (for example MT101).
Notice a lot of messages do not define a value date.
Also a few define several fields as value date, or the value date can be repeated. for those messages the first one is returned as follows:

• For MT450 returns the first value date occurrence of field 32A
• For MT455 returns the value date from field 32A (not from 33[C,D])
• For MT456 returns the first value date occurrence of field 33D
• For MT564 returns the value date from Cash Movements Field 98a with qualifier PAYD (not qualifier VALU)

Parameters:

m - the message where the value date is to be found

Returns:

found date or null if the message does not defines a value date, or if the defined value date field is not present in the message

Since:

7.7

calculateChecksum

public static String calculateChecksum(SwiftMessage model)

Proprietary checksum for message integrity verification. Please notice this is not the SWIFT trailer CHK field.

Parameters:

model -

Returns:

splitByField15

public static Map<String,SwiftTagListBlock> splitByField15(SwiftMessage msg)

Split the given message by the field 15, returning the letter option in the field 15 as the key in the map.

See Also:

splitByField15(SwiftTagListBlock)

splitByField15

public static Map<String,SwiftTagListBlock> splitByField15(SwiftTagListBlock block)

Split the given block content by the field 15, returning the letter option in the field 15 as the key in the map

Parameters:

block - the content to split

Returns:

a map with letter options as keys, and blocks as value

Since:

7.7

splitByField15

public static List<SwiftTagListBlock> splitByField15(SwiftMessage msg,
                                     String letterOption)

Helper method to retrieve all sequences starting with 15X where X is the letterOption parameter

Since:

7.7

See Also:

splitByField15(SwiftTagListBlock, String)

splitByField15

public static List<SwiftTagListBlock> splitByField15(SwiftTagListBlock block,
                                     String letterOption)

Helper method to retrieve all sequences starting with 15X where X is the letterOption parameter. Field 15a is used as a boundary for sequences, so the letter option correspond to a subsequence name.

Parameters:

block - the content to split into subsequences

letterOption - a letter option for the field boundary

Returns:

found subsequences or an empty list if field 15 is not found

Since:

7.7