All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.prowidesoftware.swift.model.mt.mt7xx.MT767 Maven / Gradle / Ivy

There is a newer version: SRU2023-10.1.16
Show newest version
/*
 * 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.mt7xx;



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 767 - Amendment to a Demand Guarantee / Standby Letter of Credit.
 *
 * 

* SWIFT MT767 (ISO 15022) message structure: *

  • Sequence A - General Information (M)
    • Field 15 A (M)
    • Field 27 (M)
    • Field 21 (M)
    • Field 22 A (M)
    • Field 23 S (O)
    • Field 72 Z (O)
    • Field 23 X (O)
  • Sequence B - Undertaking Details (M)
    • Field 15 B (M)
    • Field 20 (M)
    • Field 26 E (M)
    • Field 30 (M)
    • Field 52 A,D (M)
    • Field 23 (O)
    • Field 32 B (O)
    • Field 33 B (O)
    • Field 23 B (O)
    • Field 31 E (O)
    • Field 35 G (O)
    • Field 59 A,NONE (O)
    • Field 77 U (O)
    • Field 24 E (O)
    • Field 24 G (O)
  • Sequence C - Local Undertaking Details (O)
    • Field 15 C (M)
    • Field 32 B (O)
    • Field 33 B (O)
    • Field 23 B (O)
    • Field 31 E (O)
    • Field 35 G (O)
    • Field 59 (O)
    • Field 77 L (O)
    • Field 24 E (O)
    • Field 24 G (O)
* *

* This source code is specific to release SRU 2023 *

* For additional resources check https://www.prowidesoftware.com/resources */ @Generated public class MT767 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(MT767.class.getName()); /** * Constant for MT name, this is part of the classname, after MT. */ public static final String NAME = "767"; /** * Creates an MT767 initialized with the parameter SwiftMessage. * @param m swift message with the MT767 content */ public MT767(final SwiftMessage m) { super(m); sanityCheck(m); } /** * Creates an MT767 initialized with the parameter MtSwiftMessage. * @param m swift message with the MT767 content, the parameter can not be null * @see #MT767(String) */ public MT767(final MtSwiftMessage m) { this(m.message()); } /** * Creates an MT767 initialized with the parameter MtSwiftMessage. * * @param m swift message with the MT767 content * @return the created object or null if the parameter is null * @see #MT767(String) * @since 7.7 */ public static MT767 parse(final MtSwiftMessage m) { if (m == null) { return null; } return new MT767(m); } /** * Creates and initializes a new MT767 input message setting TEST BICS as sender and receiver. * All mandatory header attributes are completed with default values. * * @since 7.6 */ public MT767() { this(BIC.TEST8, BIC.TEST8); } /** * Creates and initializes a new MT767 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 MT767(final String sender, final String receiver) { super(767, sender, receiver); } /** * Creates a new MT767 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 MT767(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 MT767 object from FIN content with a Service Message. Check if the MT767 you are intended to read is prepended with and ACK."); } else if (!StringUtils.equals(param.getType(), "767")) { log.warning("Creating an MT767 object from FIN content with message type "+param.getType()); } } /** * Creates a new MT767 by parsing a String with the message content in its swift FIN format. * If the fin parameter cannot be parsed, the returned MT767 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 MT767 or null if fin is null * @since 7.7 */ public static MT767 parse(final String fin) { if (fin == null) { return null; } return new MT767(fin); } /** * Creates a new MT767 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 MT767(final InputStream stream) throws IOException { this(Lib.readStream(stream)); } /** * Creates a new MT767 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 MT767 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 MT767 parse(final InputStream stream) throws IOException { if (stream == null) { return null; } return new MT767(stream); } /** * Creates a new MT767 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 MT767(final File file) throws IOException { this(Lib.readFile(file)); } /** * Creates a new MT767 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 MT767 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 MT767 parse(final File file) throws IOException { if (file == null) { return null; } return new MT767(file); } /** * Returns this MT number. * @return the message type number of this MT * @since 6.4 */ @Override public String getMessageType() { return "767"; } /** * 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 MT767 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 MT767 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 MT767 append(final Field... fields) { super.append(fields); return this; } /** * Creates an MT767 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 MT767 message * @return a new instance of MT767 * @since 7.10.3 */ public static MT767 fromJson(final String json) { return (MT767) AbstractMT.fromJson(json); } /** * Iterates through block4 fields and return the first one whose name matches 15A, * or null if none is found. * The first occurrence of field 15A at MT767 is expected to be the only one. * * @return a Field15A object or null if the field is not found * @see SwiftTagListBlock#getTagByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public Field15A getField15A() { final Tag t = tag("15A"); if (t != null) { return new Field15A(t.getValue()); } else { return null; } } /** * Iterates through block4 fields and return the first one whose name matches 27, * or null if none is found. * The first occurrence of field 27 at MT767 is expected to be the only one. * * @return a Field27 object or null if the field is not found * @see SwiftTagListBlock#getTagByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public Field27 getField27() { final Tag t = tag("27"); if (t != null) { return new Field27(t.getValue()); } else { return null; } } /** * Iterates through block4 fields and return the first one whose name matches 21, * or null if none is found. * The first occurrence of field 21 at MT767 is expected to be the only one. * * @return a Field21 object or null if the field is not found * @see SwiftTagListBlock#getTagByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public Field21 getField21() { final Tag t = tag("21"); if (t != null) { return new Field21(t.getValue()); } else { return null; } } /** * Iterates through block4 fields and return the first one whose name matches 22A, * or null if none is found. * The first occurrence of field 22A at MT767 is expected to be the only one. * * @return a Field22A object or null if the field is not found * @see SwiftTagListBlock#getTagByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public Field22A getField22A() { final Tag t = tag("22A"); if (t != null) { return new Field22A(t.getValue()); } else { return null; } } /** * Iterates through block4 fields and return the first one whose name matches 23S, * or null if none is found. * The first occurrence of field 23S at MT767 is expected to be the only one. * * @return a Field23S object or null if the field is not found * @see SwiftTagListBlock#getTagByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public Field23S getField23S() { final Tag t = tag("23S"); if (t != null) { return new Field23S(t.getValue()); } else { return null; } } /** * Iterates through block4 fields and return the first one whose name matches 72Z, * or null if none is found. * The first occurrence of field 72Z at MT767 is expected to be the only one. * * @return a Field72Z object or null if the field is not found * @see SwiftTagListBlock#getTagByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public Field72Z getField72Z() { final Tag t = tag("72Z"); if (t != null) { return new Field72Z(t.getValue()); } else { return null; } } /** * Iterates through block4 fields and return the first one whose name matches 23X, * or null if none is found. * The first occurrence of field 23X at MT767 is expected to be the only one. * * @return a Field23X object or null if the field is not found * @see SwiftTagListBlock#getTagByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public Field23X getField23X() { final Tag t = tag("23X"); if (t != null) { return new Field23X(t.getValue()); } else { return null; } } /** * Iterates through block4 fields and return the first one whose name matches 15B, * or null if none is found. * The first occurrence of field 15B at MT767 is expected to be the only one. * * @return a Field15B object or null if the field is not found * @see SwiftTagListBlock#getTagByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public Field15B getField15B() { final Tag t = tag("15B"); if (t != null) { return new Field15B(t.getValue()); } else { return null; } } /** * 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 MT767 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 26E, * or null if none is found. * The first occurrence of field 26E at MT767 is expected to be the only one. * * @return a Field26E object or null if the field is not found * @see SwiftTagListBlock#getTagByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public Field26E getField26E() { final Tag t = tag("26E"); if (t != null) { return new Field26E(t.getValue()); } else { return null; } } /** * Iterates through block4 fields and return the first one whose name matches 30, * or null if none is found. * The first occurrence of field 30 at MT767 is expected to be the only one. * * @return a Field30 object or null if the field is not found * @see SwiftTagListBlock#getTagByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public Field30 getField30() { final Tag t = tag("30"); if (t != null) { return new Field30(t.getValue()); } else { return null; } } /** * Iterates through block4 fields and return the first one whose name matches 52A, * or null if none is found. * The first occurrence of field 52A at MT767 is expected to be the only one. * * @return a Field52A object or null if the field is not found * @see SwiftTagListBlock#getTagByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public Field52A getField52A() { final Tag t = tag("52A"); if (t != null) { return new Field52A(t.getValue()); } else { return null; } } /** * Iterates through block4 fields and return the first one whose name matches 52D, * or null if none is found. * The first occurrence of field 52D at MT767 is expected to be the only one. * * @return a Field52D object or null if the field is not found * @see SwiftTagListBlock#getTagByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public Field52D getField52D() { final Tag t = tag("52D"); if (t != null) { return new Field52D(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 MT767 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 59A, * or null if none is found. * The first occurrence of field 59A at MT767 is expected to be the only one. * * @return a Field59A object or null if the field is not found * @see SwiftTagListBlock#getTagByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public Field59A getField59A() { final Tag t = tag("59A"); if (t != null) { return new Field59A(t.getValue()); } else { return null; } } /** * Iterates through block4 fields and return the first one whose name matches 77U, * or null if none is found. * The first occurrence of field 77U at MT767 is expected to be the only one. * * @return a Field77U object or null if the field is not found * @see SwiftTagListBlock#getTagByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public Field77U getField77U() { final Tag t = tag("77U"); if (t != null) { return new Field77U(t.getValue()); } else { return null; } } /** * Iterates through block4 fields and return the first one whose name matches 15C, * or null if none is found. * The first occurrence of field 15C at MT767 is expected to be the only one. * * @return a Field15C object or null if the field is not found * @see SwiftTagListBlock#getTagByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public Field15C getField15C() { final Tag t = tag("15C"); if (t != null) { return new Field15C(t.getValue()); } else { return null; } } /** * Iterates through block4 fields and return the first one whose name matches 77L, * or null if none is found. * The first occurrence of field 77L at MT767 is expected to be the only one. * * @return a Field77L object or null if the field is not found * @see SwiftTagListBlock#getTagByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public Field77L getField77L() { final Tag t = tag("77L"); if (t != null) { return new Field77L(t.getValue()); } else { return null; } } /** * 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 MT767 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 33B, * or Collections.emptyList() if none is found. * Multiple occurrences of field 33B at MT767 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 23B, * or Collections.emptyList() if none is found. * Multiple occurrences of field 23B at MT767 are expected at one sequence or across several sequences. * * @return a List of Field23B objects or Collections.emptyList() if none is not found * @see SwiftTagListBlock#getTagsByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public List getField23B() { final List result = new ArrayList<>(); final Tag[] tags = tags("23B"); if (tags != null && tags.length > 0) { for (Tag tag : tags) { result.add(new Field23B(tag.getValue())); } } return result; } /** * Iterates through block4 fields and return all occurrences of fields whose names matches 31E, * or Collections.emptyList() if none is found. * Multiple occurrences of field 31E at MT767 are expected at one sequence or across several sequences. * * @return a List of Field31E objects or Collections.emptyList() if none is not found * @see SwiftTagListBlock#getTagsByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public List getField31E() { final List result = new ArrayList<>(); final Tag[] tags = tags("31E"); if (tags != null && tags.length > 0) { for (Tag tag : tags) { result.add(new Field31E(tag.getValue())); } } return result; } /** * Iterates through block4 fields and return all occurrences of fields whose names matches 35G, * or Collections.emptyList() if none is found. * Multiple occurrences of field 35G at MT767 are expected at one sequence or across several sequences. * * @return a List of Field35G objects or Collections.emptyList() if none is not found * @see SwiftTagListBlock#getTagsByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public List getField35G() { final List result = new ArrayList<>(); final Tag[] tags = tags("35G"); if (tags != null && tags.length > 0) { for (Tag tag : tags) { result.add(new Field35G(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 MT767 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 24E, * or Collections.emptyList() if none is found. * Multiple occurrences of field 24E at MT767 are expected at one sequence or across several sequences. * * @return a List of Field24E objects or Collections.emptyList() if none is not found * @see SwiftTagListBlock#getTagsByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public List getField24E() { final List result = new ArrayList<>(); final Tag[] tags = tags("24E"); if (tags != null && tags.length > 0) { for (Tag tag : tags) { result.add(new Field24E(tag.getValue())); } } return result; } /** * Iterates through block4 fields and return all occurrences of fields whose names matches 24G, * or Collections.emptyList() if none is found. * Multiple occurrences of field 24G at MT767 are expected at one sequence or across several sequences. * * @return a List of Field24G objects or Collections.emptyList() if none is not found * @see SwiftTagListBlock#getTagsByName(String) * @throws IllegalStateException if SwiftMessage object is not initialized */ public List getField24G() { final List result = new ArrayList<>(); final Tag[] tags = tags("24G"); if (tags != null && tags.length > 0) { for (Tag tag : tags) { result.add(new Field24G(tag.getValue())); } } return result; } /** * Class to model Sequence "A" in MT 767. */ @SequenceStyle(Type.SPLIT_BY_15) 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()); } public static final Tag START_TAG = Field15A.emptyTag(); /** * Creates a new instance of this sequence with the given tags inside. * @param tags may be null, an empty sequence containing only start and end sequence tags will be returned * @return a new instance of the sequence, initialized with the parameter tags * @since 7.7 */ @SequenceStyle(Type.SPLIT_BY_15) public static SequenceA newInstance(final Tag... tags) { final SequenceA result = new SequenceA(); result.append(START_TAG); if (tags != null && tags.length > 0) { for (final Tag t : tags) { result.append(t); } } return result; } /** * Create an empty $sequenceClassname. * This method is intended to avoid disambiguation for the newInstance() with variable list of blocks or tags * @return a new instance of the sequence * @since 7.7 */ public static SequenceA newInstance() { final SequenceA result = new SequenceA(); result.append(START_TAG); return result; } /** * Create a new instance of $sequenceClassname and add the contents of all sequences given inside. * Mainly intended to create a sequence by adding subsequences * @param sequences a list of blocks to set as the new sequence content * @return a new instance of the sequence, initialized with the parameter sequences content * @since 7.7 */ public static SequenceA newInstance(final SwiftTagListBlock... sequences) { final SequenceA result = new SequenceA(); result.append(START_TAG); if (sequences != null && sequences.length > 0) { for (final SwiftTagListBlock s : sequences) { result.addTags(s.getTags()); } } return result; } } /** * Get the single occurrence of SequenceA using field field 15 as sequence boundary. * The presence of this method indicates that this sequence can occur only once according to the Standard. * * @since 7.7 * @return a new sequence that may be empty, never returns null */ @SequenceStyle(Type.SPLIT_BY_15) public SequenceA getSequenceA() { return getSequenceA(super.getSwiftMessageNotNullOrException().getBlock4()); } /** * Get the single occurrence of SequenceA using field field 15 as sequence boundary. * The presence of this method indicates that this sequence can occur only once according to the Standard. * * @param parentSequence a not null parent sequence to find SequenceA within it * @return the found sequence or an empty sequence if none is found, never returns null * @since 7.7 */ @SequenceStyle(Type.SPLIT_BY_15) public SequenceA getSequenceA(SwiftTagListBlock parentSequence) { final java.util.Map map = SwiftMessageUtils.splitByField15(parentSequence); if (map.containsKey("A")) { return new SequenceA(map.get("A")); } return new SequenceA(); } /** * Class to model Sequence "B" in MT 767. */ @SequenceStyle(Type.SPLIT_BY_15) 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()); } public static final Tag START_TAG = Field15B.emptyTag(); /** * Creates a new instance of this sequence with the given tags inside. * @param tags may be null, an empty sequence containing only start and end sequence tags will be returned * @return a new instance of the sequence, initialized with the parameter tags * @since 7.7 */ @SequenceStyle(Type.SPLIT_BY_15) public static SequenceB newInstance(final Tag... tags) { final SequenceB result = new SequenceB(); result.append(START_TAG); if (tags != null && tags.length > 0) { for (final Tag t : tags) { result.append(t); } } return result; } /** * Create an empty $sequenceClassname. * This method is intended to avoid disambiguation for the newInstance() with variable list of blocks or tags * @return a new instance of the sequence * @since 7.7 */ public static SequenceB newInstance() { final SequenceB result = new SequenceB(); result.append(START_TAG); return result; } /** * Create a new instance of $sequenceClassname and add the contents of all sequences given inside. * Mainly intended to create a sequence by adding subsequences * @param sequences a list of blocks to set as the new sequence content * @return a new instance of the sequence, initialized with the parameter sequences content * @since 7.7 */ public static SequenceB newInstance(final SwiftTagListBlock... sequences) { final SequenceB result = new SequenceB(); result.append(START_TAG); if (sequences != null && sequences.length > 0) { for (final SwiftTagListBlock s : sequences) { result.addTags(s.getTags()); } } return result; } } /** * Get the single occurrence of SequenceB using field field 15 as sequence boundary. * The presence of this method indicates that this sequence can occur only once according to the Standard. * * @since 7.7 * @return a new sequence that may be empty, never returns null */ @SequenceStyle(Type.SPLIT_BY_15) public SequenceB getSequenceB() { return getSequenceB(super.getSwiftMessageNotNullOrException().getBlock4()); } /** * Get the single occurrence of SequenceB using field field 15 as sequence boundary. * The presence of this method indicates that this sequence can occur only once according to the Standard. * * @param parentSequence a not null parent sequence to find SequenceB within it * @return the found sequence or an empty sequence if none is found, never returns null * @since 7.7 */ @SequenceStyle(Type.SPLIT_BY_15) public SequenceB getSequenceB(SwiftTagListBlock parentSequence) { final java.util.Map map = SwiftMessageUtils.splitByField15(parentSequence); if (map.containsKey("B")) { return new SequenceB(map.get("B")); } return new SequenceB(); } /** * Class to model Sequence "C" in MT 767. */ @SequenceStyle(Type.SPLIT_BY_15) 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()); } public static final Tag START_TAG = Field15C.emptyTag(); /** * Creates a new instance of this sequence with the given tags inside. * @param tags may be null, an empty sequence containing only start and end sequence tags will be returned * @return a new instance of the sequence, initialized with the parameter tags * @since 7.7 */ @SequenceStyle(Type.SPLIT_BY_15) public static SequenceC newInstance(final Tag... tags) { final SequenceC result = new SequenceC(); result.append(START_TAG); if (tags != null && tags.length > 0) { for (final Tag t : tags) { result.append(t); } } return result; } /** * Create an empty $sequenceClassname. * This method is intended to avoid disambiguation for the newInstance() with variable list of blocks or tags * @return a new instance of the sequence * @since 7.7 */ public static SequenceC newInstance() { final SequenceC result = new SequenceC(); result.append(START_TAG); return result; } /** * Create a new instance of $sequenceClassname and add the contents of all sequences given inside. * Mainly intended to create a sequence by adding subsequences * @param sequences a list of blocks to set as the new sequence content * @return a new instance of the sequence, initialized with the parameter sequences content * @since 7.7 */ public static SequenceC newInstance(final SwiftTagListBlock... sequences) { final SequenceC result = new SequenceC(); result.append(START_TAG); if (sequences != null && sequences.length > 0) { for (final SwiftTagListBlock s : sequences) { result.addTags(s.getTags()); } } return result; } } /** * Get the single occurrence of SequenceC using field field 15 as sequence boundary. * The presence of this method indicates that this sequence can occur only once according to the Standard. * * @since 7.7 * @return a new sequence that may be empty, never returns null */ @SequenceStyle(Type.SPLIT_BY_15) public SequenceC getSequenceC() { return getSequenceC(super.getSwiftMessageNotNullOrException().getBlock4()); } /** * Get the single occurrence of SequenceC using field field 15 as sequence boundary. * The presence of this method indicates that this sequence can occur only once according to the Standard. * * @param parentSequence a not null parent sequence to find SequenceC within it * @return the found sequence or an empty sequence if none is found, never returns null * @since 7.7 */ @SequenceStyle(Type.SPLIT_BY_15) public SequenceC getSequenceC(SwiftTagListBlock parentSequence) { final java.util.Map map = SwiftMessageUtils.splitByField15(parentSequence); if (map.containsKey("C")) { return new SequenceC(map.get("C")); } return new SequenceC(); } }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy