com.prowidesoftware.swift.model

Class SwiftBlock2Input

java.lang.Object

com.prowidesoftware.swift.model.SwiftBlock

com.prowidesoftware.swift.model.SwiftValueBlock

com.prowidesoftware.swift.model.SwiftBlock2

com.prowidesoftware.swift.model.SwiftBlock2Input

All Implemented Interfaces:

Serializable

public class SwiftBlock2Input
extends SwiftBlock2
implements Serializable

Base class for SWIFT Application Header Block (block 2) for INPUT (to SWIFT).
This block is used to construct messages that are going to be input to the SWIFT network. From the application point of view, it correspond to the SENT messages.

It's value is fixed-length and continuous with no field delimiters. This class contains its elements as individual attributes for easier management of the block value.

This class does not provide explicit API to get the MIR of an outgoing message because it should be created using the session and sequence numbers at header block 1, and this information is not usually generated by the application creating the message but by the SWIFT Alliance interface. Therefore neither SwiftBLock1 or SwiftBlock2Input provide a getter for the MIR.
It also does not provide any API to get the MOR of a sent message because that information will be available only when the message is delivered at destination.

Since:

4.0

Author:

www.prowidesoftware.com

See Also:

MIR, Serialized Form

Field Summary

Fields inherited from class com.prowidesoftware.swift.model.SwiftBlock2

messagePriority, messageType

Fields inherited from class com.prowidesoftware.swift.model.SwiftBlock

blockType, id, input, output, unparsedTexts

Constructor Summary

Constructors

Constructor and Description
SwiftBlock2Input() Default constructor
SwiftBlock2Input(String value) Creates a block 2 output object setting attributes by parsing the string argument containing the blocks value.
SwiftBlock2Input(String messageType, String receiverAddress, String messagePriority, String deliveryMonitoring, String obsolescencePeriod) Constructor for specific values

Method Summary

Methods

Modifier and Type	Method and Description
void	clean() Sets all attributes to null
boolean	equals(Object obj)
String	getBlockValue() Returns the block value
String	getDeliveryMonitoring() Gets the Delivery Monitoring field in block 2 input
String	getMessagePriority() Gets the the message priority field in block 2 input
String	getMessageType() Gets the Message Type (MT) as classified and numbered by SWIFT.
String	getObsolescencePeriod() Gets the obsolescence period field in block 2 input
String	getReceiverAddress() Gets the LT receiver's address field in block 2 input
BIC	getReceiverBIC() Gets the receiver's BIC code from the receiver LT address.
String	getValue() Gets the fixed length block 2 value, as a result of concatenating its individual elements as follow: Message Type + Receivers address + Message Priority + Delivery Monitoring + Obsolescence Period.
int	hashCode()
boolean	isEmpty() Tell if this block is empty or not.
void	setBlockValue(String value) This method should be overwritten by subclasses, calling this method will throw a java.lang.UnsupportedOperationException
void	setDeliveryMonitoring(String deliveryMonitoring) Sets the Delivery Monitoring field is as follows: 1 = Non-Delivery Warning 2 = Delivery Notification 3 = Both valid, Non-Delivery Warning and Delivery Notification This value is optional. If the priority is U, delivery monitoring must be: 1 or 3. If the priority is N, delivery monitoring must be: 2 or not included.
void	setMessagePriority(String messagePriority) Sets the message priority as follows: S = System N = Normal U = Urgent
void	setMessageType(String messageType) Sets the Message Type (MT) as classified and numbered by SWIFT.
void	setObsolescencePeriod(String obsolescencePeriod) Sets the Obsolescence Period. It specifies when a non-delivery notification is generated as follows: Valid for U = 003 (15 minutes) Valid for N = 020 (100 minutes) This value is optional.
void	setReceiver(BIC bic) Creates a full LT address using the parameter BIC code and a default LT identifier.
void	setReceiver(String receiver) Completes if necessary and sets the LT address of the receiver. The receiver addresses will be filled with proper default LT identifier and branch codes if not provided.
void	setReceiverAddress(LogicalTerminalAddress logicalTerminal) Sets the receiver's address.
void	setReceiverAddress(String receiverAddress) Sets the receiver's address. It is fixed at 12 characters; it must have X in position 9 (padded with "X" if no branch is required).
void	setValue(String value) Sets the block's attributes by parsing the string argument containing the blocks value.
String	toJson() intended to be overwritten

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

getName, getNumber, isInput, isOutput, setBlockName, setBlockNumber, toString

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

getValuePart, size

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

getBlockType, getId, getUnparsedTexts, getUnparsedTextsSize, isTagBlock, setBlockType, setId, setInput, setOutput, setUnparsedTexts, unparsedTextAddText, unparsedTextAddText, unparsedTextGetAsMessage, unparsedTextGetText, unparsedTextIsMessage, unparsedTextVerify

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

SwiftBlock2Input

public SwiftBlock2Input()

Default constructor

SwiftBlock2Input

public SwiftBlock2Input(String value)

Creates a block 2 output object setting attributes by parsing the string argument containing the blocks value. This value can be in different flavors because some fields are optional.
Example of supported values:
"I100BANKDEFFXXXXU3003" (21) or "2:I100BANKDEFFXXXXU3003" (23) "I100BANKDEFFXXXXU3" (18) or "2:I100BANKDEFFXXXXU3" (20) "I100BANKDEFFXXXXU" (17) or "2:I100BANKDEFFXXXXU" (19)

Parameters:

value - a string with length between 17 and 23 containing the blocks value

SwiftBlock2Input

public SwiftBlock2Input(String messageType,
                String receiverAddress,
                String messagePriority,
                String deliveryMonitoring,
                String obsolescencePeriod)

Constructor for specific values

Parameters:

messageType - the message type

receiverAddress - the receiver address

messagePriority - the message priority (S=system, U=urgent, N=normal)

deliveryMonitoring - the delivery monitoring option (1 or 3 for U priority, 2 for N priority)

obsolescencePeriod - the obsolescence period, measured in 5 minutes units (3 for priority U, 20 for priority N).
According to SWIFT documentation, this value is ignored by the system

Method Detail

clean

public void clean()

Sets all attributes to null

Overrides:

clean in class SwiftBlock2

Since:

6.4

equals

public boolean equals(Object obj)

Overrides:

equals in class SwiftBlock2

getBlockValue

public String getBlockValue()

Returns the block value

Overrides:

getBlockValue in class SwiftValueBlock

Returns:

N/A

See Also:

getValue()

getDeliveryMonitoring

public String getDeliveryMonitoring()

Gets the Delivery Monitoring field in block 2 input

Returns:

the delivery monitoring

getMessagePriority

public String getMessagePriority()

Gets the the message priority field in block 2 input

Overrides:

getMessagePriority in class SwiftBlock2

Returns:

message priority

getMessageType

public String getMessageType()

Description copied from class: SwiftBlock2

Gets the Message Type (MT) as classified and numbered by SWIFT.

Overrides:

getMessageType in class SwiftBlock2

Returns:

messageType String of 3 character

getObsolescencePeriod

public String getObsolescencePeriod()

Gets the obsolescence period field in block 2 input

Returns:

the obsolescence period

getReceiverAddress

public String getReceiverAddress()

Gets the LT receiver's address field in block 2 input

Returns:

receiver address

getReceiverBIC

public BIC getReceiverBIC()

Gets the receiver's BIC code from the receiver LT address.

Returns:

receiver BIC address

Since:

7.6

See Also:

BIC

getValue

public String getValue()

Gets the fixed length block 2 value, as a result of concatenating its individual elements as follow:
Message Type + Receivers address + Message Priority + Delivery Monitoring + Obsolescence Period.

Overrides:

getValue in class SwiftValueBlock

Returns:

the blocks value as a single string

hashCode

public int hashCode()

Overrides:

hashCode in class SwiftBlock2

isEmpty

public boolean isEmpty()

Tell if this block is empty or not. This block is considered to be empty if all its attributes are set to null.

Overrides:

isEmpty in class SwiftValueBlock

Returns:

true if all fields are null and false in other case

setBlockValue

public void setBlockValue(String value)

Description copied from class: SwiftValueBlock

This method should be overwritten by subclasses, calling this method will throw a java.lang.UnsupportedOperationException

Overrides:

setBlockValue in class SwiftValueBlock

Parameters:

value - unused

See Also:

setValue(String)

setDeliveryMonitoring

public void setDeliveryMonitoring(String deliveryMonitoring)

Sets the Delivery Monitoring field is as follows:
1 = Non-Delivery Warning
2 = Delivery Notification
3 = Both valid, Non-Delivery Warning and Delivery Notification
This value is optional.
If the priority is U, delivery monitoring must be: 1 or 3.
If the priority is N, delivery monitoring must be: 2 or not included.

Parameters:

deliveryMonitoring - String of 1 character containing the Delivery Monitoring field

setMessagePriority

public void setMessagePriority(String messagePriority)

Sets the message priority as follows:
S = System
N = Normal
U = Urgent

Overrides:

setMessagePriority in class SwiftBlock2

Parameters:

messagePriority - String of 1 character

setMessageType

public void setMessageType(String messageType)

Sets the Message Type (MT) as classified and numbered by SWIFT. Three-digit FIN message type, 000 � 999.

Overrides:

setMessageType in class SwiftBlock2

Parameters:

messageType - String of 3 character

setObsolescencePeriod

public void setObsolescencePeriod(String obsolescencePeriod)

Sets the Obsolescence Period.
It specifies when a non-delivery notification is generated as follows:
Valid for U = 003 (15 minutes)
Valid for N = 020 (100 minutes)
This value is optional.

Parameters:

obsolescencePeriod - String of 3 characters containing the Obsolescence Period

setReceiver

public void setReceiver(BIC bic)

Creates a full LT address using the parameter BIC code and a default LT identifier.

Parameters:

bic -

Since:

7.6

See Also:

setReceiverAddress(LogicalTerminalAddress)

setReceiver

public void setReceiver(String receiver)

Completes if necessary and sets the LT address of the receiver.
The receiver addresses will be filled with proper default LT identifier and branch codes if not provided.

Since:

7.6

See Also:

setReceiverAddress(LogicalTerminalAddress)

setReceiverAddress

public void setReceiverAddress(LogicalTerminalAddress logicalTerminal)

Sets the receiver's address.

Parameters:

logicalTerminal -

Since:

7.6

See Also:

LogicalTerminalAddress.getReceiverLogicalTerminalAddress()

setReceiverAddress

public void setReceiverAddress(String receiverAddress)

Sets the receiver's address.
It is fixed at 12 characters; it must have X in position 9 (padded with "X" if no branch is required).

Parameters:

receiverAddress - 12 characters String

setValue

public void setValue(String value)

Sets the block's attributes by parsing the string argument containing the blocks value. This value can be in different flavors because some fields are optional.
Example of supported values:

 "I100BANKDEFFXXXX"      (16) or "2:I100BANKDEFFXXXX"      (18)   // used for service/system messages
 "I100BANKDEFFXXXXU"     (17) or "2:I100BANKDEFFXXXXU"     (19)
 "I100BANKDEFFXXXXU3"    (18) or "2:I100BANKDEFFXXXXU3"    (20)
 "I100BANKDEFFXXXXU3003" (21) or "2:I100BANKDEFFXXXXU3003" (23)
 

Overrides:

setValue in class SwiftValueBlock

Parameters:

value - a string with length between 17 and 23 containing the blocks value

toJson

public String toJson()

Description copied from class: SwiftBlock2

intended to be overwritten

Overrides:

toJson in class SwiftBlock2

Returns:

Since:

7.5