SwiftParser

java.lang.Object
- com.prowidesoftware.swift.io.parser.SwiftParser

```
public class SwiftParser
extends Object
```
FIN Parser. This implementation now properly supports all system messages (i.e: messages for MT 0xx) and service messages (for example: ACK).
As part of this, the following is now also accepted:
- Block 4 may be a non-text block (for example: {4:{101:xx}{102:xx}})
- Support for unparsed texts (at message, block and tag levels)
- Support for user defined blocks (for example: {S:{T01:xxx}{T02:yyy}})
This is based in the old SwiftParser2, that is now deprecated.
Author:

www.prowidesoftware.com

Field Summary

Fields
Modifier and Type Field and Description

static String EOL
Helper constant with the content of System.getProperty("line.separator", "\n")

Fields
Modifier and Type	Field and Description
`static String`	`EOL` Helper constant with the content of `System.getProperty("line.separator", "\n")`

Constructor Summary

Constructors
Constructor and Description
`SwiftParser()` default constructor. NOTE: If this constructor is called, setReader must be called to use the parser
`SwiftParser(InputStream is)` Constructor with an input stream for parsing a message
`SwiftParser(Reader r)` Constructor with a reader for parsing a message
`SwiftParser(String message)` Constructor with a String for parsing a message

Method Summary

Methods
Modifier and Type	Method and Description
`protected SwiftBlock4`	`block4Consume(SwiftBlock4 b, String s)` Parses a block 4 from an input string.
`protected SwiftBlock`	`consumeBlock()` Consume the next block of the message on the reader.
`protected Tag`	`consumeTag(String buffer, String unparsedText)` Process the input as a tag.
`protected void`	`findBlockStart()` read on the reader until a block start character or EOF is reached.
`List`	`getErrors()` Get a copy of the errors found.
`protected char`	`identifyBlock(String s)` Identify the block to be consumed.
`SwiftMessage`	`message()` Parse a SWIFT message into a data structure
`SwiftMessage`	`parse(String message)` Sets the parameter string as this parser data and returns the parsed object.
`protected String`	`readUntilBlockEnds()` Reads the buffer until end of block is reached.
`void`	`setData(String data)` sets the input data to the received string.
`void`	`setReader(Reader r)` sets the input reader. NOTE: this resets the internal buffer
`protected SwiftTagListBlock`	`tagListBlockConsume(SwiftTagListBlock b, String s)` consumes a tag list block (i.e: block 3, block 5 or user defined block)
`protected int`	`textTagEndBlock4(String s, int start, boolean isTextBlock)` finds the end of a text tag (i.e: ":TAG:VALUE").

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - EOL
```
public static final String EOL
```
    Helper constant with the content of System.getProperty("line.separator", "\n")
- Constructor Detail
  - SwiftParser
```
public SwiftParser()
```
    default constructor.
    NOTE: If this constructor is called, setReader must be called to use the parser
  - SwiftParser
```
public SwiftParser(InputStream is)
```
    Constructor with an input stream for parsing a message
    
    Parameters:
    is - stream to read
  - SwiftParser
```
public SwiftParser(Reader r)
```
    Constructor with a reader for parsing a message
    
    Parameters:
    r - the Reader with the swift message to read
  - SwiftParser
```
public SwiftParser(String message)
```
    Constructor with a String for parsing a message
    
    Parameters:
    message - the String with the swift message to read
- Method Detail
  - block4Consume
```
protected SwiftBlock4 block4Consume(SwiftBlock4 b,
                        String s)
                             throws IOException
```
    Parses a block 4 from an input string. This method supports the two possible formats of a swift block 4:
    - Text mode: this is the common block 4 for categories 1 to 9.
    - Tag mode: this is the same format as for blocks 3 and 5. This format is used by service messages (for example: ACK) and system messages (category 0).
    Parameters:
    b - the block to set up tags into
    s - the block data to process
    
    Returns:
    the processed block (the parameter b)
    
    Throws:
    
    IOException
  - consumeBlock
```
protected SwiftBlock consumeBlock()
                           throws IOException
```
    Consume the next block of the message on the reader. This methods seeks to a block start, then identifies the block and calls the proper method to consume the block type that is coming, not all blocks are parsed in the same manner.
    
    Parameters:
    blockHint -
    
    Returns:
    the next block in the reader or null if none was found (i.e: end of input)
    
    Throws:
    
    IOException - if an error occurred during read
  - consumeTag
```
protected Tag consumeTag(String buffer,
             String unparsedText)
                  throws IOException
```
    Process the input as a tag. That is: split name and value (and possibly unparsed texts).
    The received buffer contains only the pertinent data for the tag (name and value). Trailing [CR][LF] on the text MUST not be present.
    
    Parameters:
    buffer - the buffer containing the tag
    unparsedText - the unparsed text to assign (use null if none is wanted). This single text is fragmented in multiple texts if there are more than one message.
    
    Returns:
    a swift Tag
    
    Throws:
    
    IOException
  - findBlockStart
```
protected void findBlockStart()
                       throws IOException
```
    read on the reader until a block start character or EOF is reached.
    
    Throws:
    
    IOException - if thrown during read
  - getErrors
```
public List getErrors()
```
    Get a copy of the errors found. users can manipulate this copy without affecting the original.
    
    Returns:
    the list of errors found
  - identifyBlock
```
protected char identifyBlock(String s)
```
    Identify the block to be consumed.
    
    Parameters:
    s - the block identifier
    
    Returns:
    the block identifier or a space if the block can not be identified
  - message
```
public SwiftMessage message()
                     throws IOException
```
    Parse a SWIFT message into a data structure
    
    Returns:
    the parsed swift message object
    
    Throws:
    
    IOException
  - parse
```
public SwiftMessage parse(String message)
                   throws IOException
```
    Sets the parameter string as this parser data and returns the parsed object.
    
    Parameters:
    message - the String with the swift message to parse
    
    Returns:
    the parsed swift message object
    
    Throws:
    
    IOException
    Since:
    
    6.0
  - readUntilBlockEnds
```
protected String readUntilBlockEnds()
                             throws IOException
```
    Reads the buffer until end of block is reached. The initial character of the block must be already consumed and the reader has to be ready to consume the first character inside the block
    This method assumes that the starting block character was consumed because that is required in order to identify the start of a block, and call this method which reads until this block ends.
    
    Returns:
    a string with the block contents
    
    Throws:
    
    IOException
  - setData
```
public void setData(String data)
```
    sets the input data to the received string.
    
    Parameters:
    data - the data to use as input
  - setReader
```
public void setReader(Reader r)
```
    sets the input reader.
    NOTE: this resets the internal buffer
    
    Parameters:
    r - the reader to use
  - tagListBlockConsume
```
protected SwiftTagListBlock tagListBlockConsume(SwiftTagListBlock b,
                                    String s)
                                         throws IOException
```
    consumes a tag list block (i.e: block 3, block 5 or user defined block)
    
    Parameters:
    b - the block to set up tags into
    s - the block data to process
    
    Returns:
    the processed block (the parameter b)
    
    Throws:
    
    IOException
  - textTagEndBlock4
```
protected int textTagEndBlock4(String s,
                   int start,
                   boolean isTextBlock)
```
    finds the end of a text tag (i.e: ":TAG:VALUE"). This is used to parse block 4.
    The function search the string looking for the occurrence of any of the sequences:
    - "[LBR]:[X]"
    - "[LBR]}"
    - "[LBR]{"
    - "}"
    where "[LBR]" stands for any of: "[CR]", "[LF]" or "[CR][LF]" and "[X]" is any character other than [CR] and [LF].
    Then considers the end of the tag as NOT containing the found sequence.
    NOTE: the condition "-}" cannot happen because the terminating dash is already removed.
    renamed to state clearly that this search is only used in block4Consume
    Parameters:
    s - the FIN input text
    start - the position to start analysis at
    
    Returns:
    the position where the tag ends (excluding the <CR><LF>)

Class SwiftParser

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

EOL

Constructor Detail

SwiftParser

SwiftParser

SwiftParser

SwiftParser

Method Detail

block4Consume

consumeBlock

consumeTag

findBlockStart

getErrors

identifyBlock

message

parse

readUntilBlockEnds

setData

setReader

tagListBlockConsume

textTagEndBlock4