com.prowidesoftware.swift.model.mt.mt1xx.MT102 Maven / Gradle / Ivy
Show all versions of pw-swift-core Show documentation
/*
* Copyright 2006-2023 Prowide
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.prowidesoftware.swift.model.mt.mt1xx;
import com.prowidesoftware.Generated;
import java.io.Serializable;
import java.util.ArrayList;
import java.util.List;
import java.util.Collections;
import org.apache.commons.lang3.StringUtils;
import com.prowidesoftware.swift.model.*;
import com.prowidesoftware.swift.internal.*;
import com.prowidesoftware.swift.internal.SequenceStyle.Type;
import com.prowidesoftware.swift.model.field.*;
import com.prowidesoftware.swift.model.mt.AbstractMT;
import com.prowidesoftware.swift.utils.Lib;
import java.io.File;
import java.io.InputStream;
import java.io.IOException;
/**
* MT 102 - Multiple Customer Credit Transfer.
*
*
* SWIFT MT102 (ISO 15022) message structure:
*
-
Sequence A (M)
- Field 20 (M)
- Field 23 (M)
- Field 51 A (O)
- Field 50 A,F,K (O)
- Field 52 A,B,C (O)
- Field 26 T (O)
- Field 77 B (O)
- Field 71 A (O)
- Field 36 (O)
-
Sequence B (M) (repetitive)
- Field 21 (M)
- Field 32 B (M)
- Field 50 A,F,K (O)
- Field 52 A,B,C (O)
- Field 57 A,C (O)
- Field 59 A,F,NONE (M)
- Field 70 (O)
- Field 26 T (O)
- Field 77 B (O)
- Field 33 B (O)
- Field 71 A (O)
- Field 71 F (O) (repetitive)
- Field 71 G (O)
- Field 36 (O)
-
Sequence C (M)
- Field 32 A (M)
- Field 19 (O)
- Field 71 G (O)
- Field 13 C (O) (repetitive)
- Field 53 A,C (O)
- Field 54 A (O)
- Field 72 (O)
*
*
* This source code is specific to release SRU 2023
*
* For additional resources check https://www.prowidesoftware.com/resources
*/
@Generated
public class MT102 extends AbstractMT implements Serializable {
/**
* Constant identifying the SRU to which this class belongs to.
*/
public static final int SRU = 2023;
private static final long serialVersionUID = 1L;
private static final java.util.logging.Logger log = java.util.logging.Logger.getLogger(MT102.class.getName());
/**
* Constant for MT name, this is part of the classname, after MT.
*/
public static final String NAME = "102";
/**
* Creates an MT102 initialized with the parameter SwiftMessage.
* @param m swift message with the MT102 content
*/
public MT102(final SwiftMessage m) {
super(m);
sanityCheck(m);
}
/**
* Creates an MT102 initialized with the parameter MtSwiftMessage.
* @param m swift message with the MT102 content, the parameter can not be null
* @see #MT102(String)
*/
public MT102(final MtSwiftMessage m) {
this(m.message());
}
/**
* Creates an MT102 initialized with the parameter MtSwiftMessage.
*
* @param m swift message with the MT102 content
* @return the created object or null if the parameter is null
* @see #MT102(String)
* @since 7.7
*/
public static MT102 parse(final MtSwiftMessage m) {
if (m == null) {
return null;
}
return new MT102(m);
}
/**
* Creates and initializes a new MT102 input message setting TEST BICS as sender and receiver.
* All mandatory header attributes are completed with default values.
*
* @since 7.6
*/
public MT102() {
this(BIC.TEST8, BIC.TEST8);
}
/**
* Creates and initializes a new MT102 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,
*
* @param sender the sender address as a bic8, bic11 or full logical terminal consisting of 12 characters
* @param receiver the receiver address as a bic8, bic11 or full logical terminal consisting of 12 characters
* @since 7.7
*/
public MT102(final String sender, final String receiver) {
super(102, sender, receiver);
}
/**
* Creates a new MT102 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.
*
* @param fin a string with the MT message in its FIN swift format
* @since 7.7
*/
public MT102(final String fin) {
super();
if (fin != null) {
final SwiftMessage parsed = read(fin);
if (parsed != null) {
super.m = parsed;
sanityCheck(parsed);
}
}
}
private void sanityCheck(final SwiftMessage param) {
if (param.isServiceMessage()) {
log.warning("Creating an MT102 object from FIN content with a Service Message. Check if the MT102 you are intended to read is prepended with and ACK.");
} else if (!StringUtils.equals(param.getType(), "102")) {
log.warning("Creating an MT102 object from FIN content with message type "+param.getType());
}
}
/**
* Creates a new MT102 by parsing a String with the message content in its swift FIN format.
* If the fin parameter cannot be parsed, the returned MT102 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.
*
* @param fin a string with the MT message in its FIN swift format. fin may be null in which case this method returns null
* @return a new instance of MT102 or null if fin is null
* @since 7.7
*/
public static MT102 parse(final String fin) {
if (fin == null) {
return null;
}
return new MT102(fin);
}
/**
* Creates a new MT102 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.
*
* @param stream an input stream in UTF-8 encoding with the MT message in its FIN swift format.
* @throws IOException if the stream data cannot be read
* @since 7.7
*/
public MT102(final InputStream stream) throws IOException {
this(Lib.readStream(stream));
}
/**
* Creates a new MT102 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.
*
* @param stream an input stream in UTF-8 encoding with the MT message in its FIN swift format.
* @return a new instance of MT102 or null if stream is null or the message cannot be parsed
* @throws IOException if the stream data cannot be read
* @since 7.7
*/
public static MT102 parse(final InputStream stream) throws IOException {
if (stream == null) {
return null;
}
return new MT102(stream);
}
/**
* Creates a new MT102 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.
*
* @param file a file with the MT message in its FIN swift format.
* @throws IOException if the file content cannot be read
* @since 7.7
*/
public MT102(final File file) throws IOException {
this(Lib.readFile(file));
}
/**
* Creates a new MT102 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.
*
* @param file a file with the MT message in its FIN swift format.
* @return a new instance of MT102 or null if; file is null, does not exist, can't be read, is not a file or the message cannot be parsed
* @throws IOException if the file content cannot be read
* @since 7.7
*/
public static MT102 parse(final File file) throws IOException {
if (file == null) {
return null;
}
return new MT102(file);
}
/**
* Returns this MT number.
* @return the message type number of this MT
* @since 6.4
*/
@Override
public String getMessageType() {
return "102";
}
/**
* Add all tags from block to the end of the block4.
*
* @param block to append
* @return this object to allow method chaining
* @since 7.6
*/
@Override
public MT102 append(final SwiftTagListBlock block) {
super.append(block);
return this;
}
/**
* Add all tags to the end of the block4.
*
* @param tags to append
* @return this object to allow method chaining
* @since 7.6
*/
@Override
public MT102 append(final Tag... tags) {
super.append(tags);
return this;
}
/**
* Add all the fields to the end of the block4.
*
* @param fields to append
* @return this object to allow method chaining
* @since 7.6
*/
@Override
public MT102 append(final Field... fields) {
super.append(fields);
return this;
}
/**
* Creates an MT102 messages from its JSON representation.
*
* For generic conversion of JSON into the corresponding MT instance
* see {@link AbstractMT#fromJson(String)}
*
* @param json a JSON representation of an MT102 message
* @return a new instance of MT102
* @since 7.10.3
*/
public static MT102 fromJson(final String json) {
return (MT102) AbstractMT.fromJson(json);
}
/**
* Iterates through block4 fields and return the first one whose name matches 20,
* or null if none is found.
* The first occurrence of field 20 at MT102 is expected to be the only one.
*
* @return a Field20 object or null if the field is not found
* @see SwiftTagListBlock#getTagByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public Field20 getField20() {
final Tag t = tag("20");
if (t != null) {
return new Field20(t.getValue());
} else {
return null;
}
}
/**
* Iterates through block4 fields and return the first one whose name matches 23,
* or null if none is found.
* The first occurrence of field 23 at MT102 is expected to be the only one.
*
* @return a Field23 object or null if the field is not found
* @see SwiftTagListBlock#getTagByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public Field23 getField23() {
final Tag t = tag("23");
if (t != null) {
return new Field23(t.getValue());
} else {
return null;
}
}
/**
* Iterates through block4 fields and return the first one whose name matches 51A,
* or null if none is found.
* The first occurrence of field 51A at MT102 is expected to be the only one.
*
* @return a Field51A object or null if the field is not found
* @see SwiftTagListBlock#getTagByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public Field51A getField51A() {
final Tag t = tag("51A");
if (t != null) {
return new Field51A(t.getValue());
} else {
return null;
}
}
/**
* Iterates through block4 fields and return the first one whose name matches 32A,
* or null if none is found.
* The first occurrence of field 32A at MT102 is expected to be the only one.
*
* @return a Field32A object or null if the field is not found
* @see SwiftTagListBlock#getTagByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public Field32A getField32A() {
final Tag t = tag("32A");
if (t != null) {
return new Field32A(t.getValue());
} else {
return null;
}
}
/**
* Iterates through block4 fields and return the first one whose name matches 19,
* or null if none is found.
* The first occurrence of field 19 at MT102 is expected to be the only one.
*
* @return a Field19 object or null if the field is not found
* @see SwiftTagListBlock#getTagByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public Field19 getField19() {
final Tag t = tag("19");
if (t != null) {
return new Field19(t.getValue());
} else {
return null;
}
}
/**
* Iterates through block4 fields and return the first one whose name matches 53A,
* or null if none is found.
* The first occurrence of field 53A at MT102 is expected to be the only one.
*
* @return a Field53A object or null if the field is not found
* @see SwiftTagListBlock#getTagByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public Field53A getField53A() {
final Tag t = tag("53A");
if (t != null) {
return new Field53A(t.getValue());
} else {
return null;
}
}
/**
* Iterates through block4 fields and return the first one whose name matches 53C,
* or null if none is found.
* The first occurrence of field 53C at MT102 is expected to be the only one.
*
* @return a Field53C object or null if the field is not found
* @see SwiftTagListBlock#getTagByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public Field53C getField53C() {
final Tag t = tag("53C");
if (t != null) {
return new Field53C(t.getValue());
} else {
return null;
}
}
/**
* Iterates through block4 fields and return the first one whose name matches 54A,
* or null if none is found.
* The first occurrence of field 54A at MT102 is expected to be the only one.
*
* @return a Field54A object or null if the field is not found
* @see SwiftTagListBlock#getTagByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public Field54A getField54A() {
final Tag t = tag("54A");
if (t != null) {
return new Field54A(t.getValue());
} else {
return null;
}
}
/**
* Iterates through block4 fields and return the first one whose name matches 72,
* or null if none is found.
* The first occurrence of field 72 at MT102 is expected to be the only one.
*
* @return a Field72 object or null if the field is not found
* @see SwiftTagListBlock#getTagByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public Field72 getField72() {
final Tag t = tag("72");
if (t != null) {
return new Field72(t.getValue());
} else {
return null;
}
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 21,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 21 at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field21 objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField21() {
final List result = new ArrayList<>();
final Tag[] tags = tags("21");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field21(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 32B,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 32B at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field32B objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField32B() {
final List result = new ArrayList<>();
final Tag[] tags = tags("32B");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field32B(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 50A,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 50A at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field50A objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField50A() {
final List result = new ArrayList<>();
final Tag[] tags = tags("50A");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field50A(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 50F,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 50F at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field50F objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField50F() {
final List result = new ArrayList<>();
final Tag[] tags = tags("50F");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field50F(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 50K,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 50K at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field50K objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField50K() {
final List result = new ArrayList<>();
final Tag[] tags = tags("50K");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field50K(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 52A,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 52A at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field52A objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField52A() {
final List result = new ArrayList<>();
final Tag[] tags = tags("52A");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field52A(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 52B,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 52B at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field52B objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField52B() {
final List result = new ArrayList<>();
final Tag[] tags = tags("52B");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field52B(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 52C,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 52C at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field52C objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField52C() {
final List result = new ArrayList<>();
final Tag[] tags = tags("52C");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field52C(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 57A,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 57A at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field57A objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField57A() {
final List result = new ArrayList<>();
final Tag[] tags = tags("57A");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field57A(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 57C,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 57C at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field57C objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField57C() {
final List result = new ArrayList<>();
final Tag[] tags = tags("57C");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field57C(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 59A,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 59A at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field59A objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField59A() {
final List result = new ArrayList<>();
final Tag[] tags = tags("59A");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field59A(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 59F,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 59F at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field59F objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField59F() {
final List result = new ArrayList<>();
final Tag[] tags = tags("59F");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field59F(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 59,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 59 at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field59 objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField59() {
final List result = new ArrayList<>();
final Tag[] tags = tags("59");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field59(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 70,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 70 at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field70 objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField70() {
final List result = new ArrayList<>();
final Tag[] tags = tags("70");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field70(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 26T,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 26T at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field26T objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField26T() {
final List result = new ArrayList<>();
final Tag[] tags = tags("26T");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field26T(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 77B,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 77B at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field77B objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField77B() {
final List result = new ArrayList<>();
final Tag[] tags = tags("77B");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field77B(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 33B,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 33B at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field33B objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField33B() {
final List result = new ArrayList<>();
final Tag[] tags = tags("33B");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field33B(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 71A,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 71A at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field71A objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField71A() {
final List result = new ArrayList<>();
final Tag[] tags = tags("71A");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field71A(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 71F,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 71F at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field71F objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField71F() {
final List result = new ArrayList<>();
final Tag[] tags = tags("71F");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field71F(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 71G,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 71G at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field71G objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField71G() {
final List result = new ArrayList<>();
final Tag[] tags = tags("71G");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field71G(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 36,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 36 at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field36 objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField36() {
final List result = new ArrayList<>();
final Tag[] tags = tags("36");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field36(tag.getValue()));
}
}
return result;
}
/**
* Iterates through block4 fields and return all occurrences of fields whose names matches 13C,
* or Collections.emptyList() if none is found.
* Multiple occurrences of field 13C at MT102 are expected at one sequence or across several sequences.
*
* @return a List of Field13C objects or Collections.emptyList() if none is not found
* @see SwiftTagListBlock#getTagsByName(String)
* @throws IllegalStateException if SwiftMessage object is not initialized
*/
public List getField13C() {
final List result = new ArrayList<>();
final Tag[] tags = tags("13C");
if (tags != null && tags.length > 0) {
for (Tag tag : tags) {
result.add(new Field13C(tag.getValue()));
}
}
return result;
}
/**
* Class to model Sequence "A" in MT 102.
*/
public static class SequenceA extends SwiftTagListBlock {
private static final long serialVersionUID = 1L;
/**
* Constructs an empty sequence.
*/
private SequenceA() {
super(new ArrayList<>());
}
/**
* Creates a sequence with the given content.
* @see SwiftTagListBlock
*/
private SequenceA(final SwiftTagListBlock content) {
super(content.getTags());
}
/**
* First mandatory tag name of the sequence: "20" .
* Array format is for cases when more than one letter options is allowed
*/
public static final String[] START = { "20" } ;
/**
* Last mandatory tag name of the sequence: "23"
* Array format is for cases when more than one letter options is allowed
*/
protected static final String[] END = { "23" };
/**
* List of optional tags after the last mandatory tag.
*/
protected static final String[] TAIL = new String[]{ "51A", "50A", "50F", "50K", "52A", "52B", "52C", "26T", "77B", "71A", "36" };
/**
* Same as {@link #newInstance(int, int, Tag...)} using zero for the indexes.
* @param tags the list of tags to set as sequence content
* @return a new instance of the sequence, initialized with the parameter tags
*/
@SequenceStyle(Type.GENERATED_FIXED_WITH_OPTIONAL_TAIL)
public static SequenceA newInstance(final Tag... tags) {
return newInstance(0, 0, tags);
}
/**
* Creates a sequence with starting and ending tags set to the indicated tags in from the
* {@link #START} and {@link #END} lists of mandatory fields, and with the content between
* the starting and ending tag initialized with the given optional tags.
*
* @param start a zero-based index within the list of mandatory starting tags in the sequence
* @param end a zero-based index within the list of mandatory ending tags in the sequence
* @param tags the list of tags to set as sequence content
* @return a new instance of the sequence, initialized with the parameter tags
*/
@SequenceStyle(Type.GENERATED_FIXED_WITH_OPTIONAL_TAIL)
public static SequenceA newInstance(final int start, final int end, final Tag... tags) {
final SequenceA result = new SequenceA();
result.append(new Tag(START[start], ""));
if (tags != null && tags.length > 0) {
for (final Tag t : tags) {
result.append(t);
}
}
result.append(new Tag(END[end], ""));
return result;
}
}
/**
* Get the single occurrence of SequenceA delimited by leading tag and end, with an optional tail.
* The presence of this method indicates that this sequence can occur only once according to the Standard.
* If block 4 is empty this method returns null.
*
* @return the found sequence or an empty sequence if none is found
* @see SwiftTagListBlock#getSubBlockDelimitedWithOptionalTail(String[], String[], String[])
*/
@SequenceStyle(Type.GENERATED_FIXED_WITH_OPTIONAL_TAIL)
public SequenceA getSequenceA() {
return getSequenceA(super.getSwiftMessageNotNullOrException().getBlock4());
}
/**
* Get the single occurrence of SequenceA delimited by leading tag and end, with an optional tail.
* The presence of this method indicates that this sequence can occur only once according to the Standard.
* If block 4 is empty this method returns null.
*
* @see SwiftTagListBlock#getSubBlockDelimitedWithOptionalTail(String[], String[], String[])
* @param parentSequence a not null parent sequence to find SequenceA within it
* @return the found sequence or an empty sequence if none is found, or null if the parent sequence is null or empty
* @since 7.7
*/
@SequenceStyle(Type.GENERATED_FIXED_WITH_OPTIONAL_TAIL)
public SequenceA getSequenceA(SwiftTagListBlock parentSequence) {
if (parentSequence != null && !parentSequence.isEmpty()) {
final SwiftTagListBlock content = parentSequence.getSubBlockDelimitedWithOptionalTail(SequenceA.START, SequenceA.END, SequenceA.TAIL);
if (log.isLoggable(java.util.logging.Level.FINE)) {
if (content == null) {
log.fine("content for sequence SequenceA: is null");
} else {
log.fine("content for sequence SequenceA: "+content.tagNamesList());
}
}
if (content == null) {
return new SequenceA();
} else {
return new SequenceA(content);
}
}
return null;
}
/**
* Class to model Sequence "B" in MT 102.
*/
public static class SequenceB extends SwiftTagListBlock {
private static final long serialVersionUID = 1L;
/**
* Constructs an empty sequence.
*/
private SequenceB() {
super(new ArrayList<>());
}
/**
* Creates a sequence with the given content.
* @see SwiftTagListBlock
*/
private SequenceB(final SwiftTagListBlock content) {
super(content.getTags());
}
/**
* First mandatory tag name of the sequence: "21" .
* Array format is for cases when more than one letter options is allowed
*/
public static final String[] START = { "21" } ;
/**
* Last mandatory tag name of the sequence: "59A", "59F", "59"
* Array format is for cases when more than one letter options is allowed
*/
protected static final String[] END = { "59A", "59F", "59" };
/**
* List of optional tags after the last mandatory tag.
*/
protected static final String[] TAIL = new String[]{ "70", "26T", "77B", "33B", "71A", "71F", "71G", "36" };
/**
* Same as {@link #newInstance(int, int, Tag...)} using zero for the indexes.
* @param tags the list of tags to set as sequence content
* @return a new instance of the sequence, initialized with the parameter tags
*/
@SequenceStyle(Type.GENERATED_FIXED_WITH_OPTIONAL_TAIL)
public static SequenceB newInstance(final Tag... tags) {
return newInstance(0, 0, tags);
}
/**
* Creates a sequence with starting and ending tags set to the indicated tags in from the
* {@link #START} and {@link #END} lists of mandatory fields, and with the content between
* the starting and ending tag initialized with the given optional tags.
*
* @param start a zero-based index within the list of mandatory starting tags in the sequence
* @param end a zero-based index within the list of mandatory ending tags in the sequence
* @param tags the list of tags to set as sequence content
* @return a new instance of the sequence, initialized with the parameter tags
*/
@SequenceStyle(Type.GENERATED_FIXED_WITH_OPTIONAL_TAIL)
public static SequenceB newInstance(final int start, final int end, final Tag... tags) {
final SequenceB result = new SequenceB();
result.append(new Tag(START[start], ""));
if (tags != null && tags.length > 0) {
for (final Tag t : tags) {
result.append(t);
}
}
result.append(new Tag(END[end], ""));
return result;
}
}
/**
* Get the list of SequenceB delimited by leading tag and end, with an optional tail.
* The presence of this method indicates that this sequence can occur more than once according to the Standard.
* If message is empty or no sequences are found an empty list is returned.
*
* @return the found sequences or an empty list if none is found
* @see SwiftTagListBlock#getSubBlocksDelimitedWithOptionalTail(String[], String[], String[])
*/
@SequenceStyle(Type.GENERATED_FIXED_WITH_OPTIONAL_TAIL)
public List getSequenceBList() {
return getSequenceBList(super.getSwiftMessageNotNullOrException().getBlock4());
}
/**
* Get the list of SequenceB delimited by leading tag and end, with an optional tail.
* The presence of this method indicates that this sequence can occur more than once according to the Standard.
* If message is empty or no sequences are found an empty list is returned.
*
* @see SwiftTagListBlock#getSubBlocksDelimitedWithOptionalTail(String[], String[], String[])
* @param parentSequence a not null parent sequence to find SequenceB within it
* @return the found sequences or an empty list if none is found or parent sequence is null
* @since 7.7
*/
@SequenceStyle(Type.GENERATED_FIXED_WITH_OPTIONAL_TAIL)
public static List getSequenceBList(final SwiftTagListBlock parentSequence) {
if (parentSequence != null) {
final List blocks = parentSequence.getSubBlocksDelimitedWithOptionalTail(SequenceB.START, SequenceB.END, SequenceB.TAIL);
if (blocks != null && !blocks.isEmpty()) {
final List result = new ArrayList<>(blocks.size());
for (final SwiftTagListBlock b : blocks) {
result.add(new SequenceB(b));
}
return result;
}
}
return Collections.emptyList();
}
/**
* Class to model Sequence "C" in MT 102.
*/
public static class SequenceC extends SwiftTagListBlock {
private static final long serialVersionUID = 1L;
/**
* Constructs an empty sequence.
*/
private SequenceC() {
super(new ArrayList<>());
}
/**
* Creates a sequence with the given content.
* @see SwiftTagListBlock
*/
private SequenceC(final SwiftTagListBlock content) {
super(content.getTags());
}
}
/**
* Get the single occurrence of SequenceC slicing head or tail of the tags with delimiter ${s.getTagNames().get(0)}.
* The presence of this method indicates that this sequence can occur only once according to the Standard.
* NOTE: if the tag delimiter is not found this method returns null.
*
* @return the found sequence, an empty sequence if none is found, or null if the delimiter is not found
*/
@SequenceStyle(Type.GENERATED_SLICE) // SliceHeurisitcCodeGenerator [tagnames=[32A], type=END_OF_MESSAGE, delimiterIncludedInSequence=true ]
public SequenceC getSequenceC() {
return getSequenceC(super.getSwiftMessageNotNullOrException().getBlock4());
}
/**
* Get the single occurrence of SequenceC slicing head or tail of the tags with delimiter ${s.getTagNames().get(0)}.
* The presence of this method indicates that this sequence can occur only once according to the Standard.
* NOTE: if the tag delimiter is not found this method returns null.
*
* @param parentSequence a not null parent sequence to find SequenceC within it
* @return the found sequence, an empty sequence if none is found, or null if the parent sequences is null or the delimiter is not found
* @since 7.7
*/
@SequenceStyle(Type.GENERATED_SLICE) // SliceHeurisitcCodeGenerator [tagnames=[32A], type=END_OF_MESSAGE, delimiterIncludedInSequence=true ]
public SequenceC getSequenceC(SwiftTagListBlock parentSequence) {
if (parentSequence != null && !parentSequence.isEmpty()) {
// sequence is tail of message
final SwiftTagListBlock content = parentSequence.getSubBlockAfterLast("32A", true);
if (content == null) {
return null;
}
return new SequenceC(content);
}
return null;
}
}