Este paquete provee funcionalidad para parsear el fichero de mensaje SWIFT populando objetos Java (Message Model).

De esta manera el desarrollador puede concentrarse en el manejo de los datos sin tener que lidear con los detalles de bajo nivel de los ficheros SWIFT.

El parser realiza las validaciones de sintáxis mínimas necesarias para poder obtener los datos del mensaje. La validación completa de mensajes (estructura, semántica, etc...) es una problemática independiente y no cubierta por el algoritmo de parseo.

Considerando el siguiente ejemplo de mensaje SWIFT (se agregan saltos de línea extra por motivos de formateo de página):

{1:F01BANKDEFMAXXX2039063581}{2:O1031609050901BANKDEFXAXXX89549829458949811609N}
{3:{108:00750532785315}}{4:
:20:007505327853
:23B:CRED
:32A:050902JPY3520000,
:33B:JPY3520000,
:50K:EUROXXXEI
:52A:FEBXXXM1
:53A:MHCXXXJT
:54A:FOOBICXX
:59:/13212312
RECEIVER NAME S.A
:70:FUTURES
:71A:SHA
:71F:EUR12,00
:71F:EUR2,34
-} 

Asumiendo que el literal del mensaje se encuentra en la variable "fin", el siguiente código parsea el contenido del mensaje creando como resultado un objeto SwiftMessage:

SwiftMessage m = (new SwiftParser()).parse(fin);
String val32a = m.getBlock4().getTagValue("32A"); //valor de un campo simple
String[] list71 = m.getBlock4().getTagValues("71F"); //valor de un campo repetido

La variable "val32a" contendrá el valor "050902JPY3520000,".
Y "list71" contendrá la lista de Strings con los valores "EUR12,00" y "EUR2,34".

SwiftTagListBlock internamente utiliza un List para acumular los campos encontrados en un bloque. Esta lista preserva el orden de los campos encontrados en el mensaje y provee API para manipular y obtener los mismos.

La implementación principal se encuentra en la clase SwiftParser, pero la forma más simple de utilizar esta funcionalidad es mediante el API de servicios de conversión:

SwiftMessage m = (new ConversionService()).getMessageFromFIN(fin);

Algunos mensajes SWIFT contienen otros mensajes adosados como información extra. Por ejemplo:

• El mensaje original adjunto a un mensaje de ACK.
• El mensaje obtenido como Retrieval Response, adosado al bloque 4 en un MT 021 (Retrieval Response)
• El mensaje adosado al campo 270 en un MT 056 (LT History Report)

Por motivos de performance y simplicidad del modelo estos mensajes adjuntos no son inicialmente parseados y se guardan en el modelo como literales String, utilizando los objetos del modelo denominados UnparsedTextsList y que pueden ser seteados como información adicional para mensajes, bloques o campos.

Se brindan métodos del API para obtener estos objetos, sobre los cuales se pueden hacer llamadas subsecuentes al parser. Se puede pensar este mecanismo como parseo "lazy" de mensajes adjuntos.

Cómo puedo parsear y obtener componentes internos de los campos?

El parser de mensajes inicialmente no realiza parseo interno de campos. Por ejemplo para el campo ":32A:050902JPY3520000," el objeto Tag contendrá como value el String "050902JPY3520000,". Sin embargo puede utilizarse las clases específicas de modelado de MTs y campos para esto, por ejemplo:

SwiftMessage m = (new SwiftParser()).parse(fin);
Field32A f = new Field32A(m.getBlock4().getTagValue("32A"));
Calendar date = f.getComponent1AsCalendar();
BigDecimal amount = new BigDecimal(f.getComponent3AsNumber().doubleValue());