com.poscoict.glueframework.message.layout

Interface GlueMessageLayout

All Known Implementing Classes:

GlueAbstractFixedLengthMessageLayout, GlueDBMessageLayout, GlueXmlMessageLayout

public interface GlueMessageLayout

Message를 Create 및 parsing를 처리하기 위한 Interface Class. Layout을 XML, DB등으로 여러 형태로 처리가능함

Method Summary

Modifier and Type	Method and Description
GlueMessageDefinition	getAttributes(String messageId) 해당 Msg Layout의 Attribute 정보를 추출하는 Method 처음 호출시 Attribute의 정보를 Cache에 저장하고, 재 호출시 Cache를 통해 정보를 추출하여 제공
GlueMessage	makeMessageParsing(GlueMessageDefinition messageDefinition, String message) Message Layout 항목 정보에 따 Message를 파싱하여 GlueMessage 객체에 담는다.
String	makeMessageString(GlueMessageDefinition messageDefinition, GlueMessage message) Message Layout에 따라 해당 Message를 생성한다.

Method Detail

makeMessageString

String makeMessageString(GlueMessageDefinition messageDefinition,
                         GlueMessage message)

Message Layout에 따라 해당 Message를 생성한다.

 [Message Byte 생성 규칙]
 1. Data Type : String
    DataType : STRING, CHAR, VARCHAR2 모두 동일하게 String으로 간주
    String Data가 Layout의 Length보다 작을때 : Length만큼 오른쪽 공백 추가
    String Data가 Layout의 Length보다 클때 : Length만큼 왼쪽 기준으로 자름
    단, String이 Null, ""(zero Length) 일 경우 : Length만큼 공백 생성
    단, String을 Byte Length 생성시 String 중간절삭일 경우 깨진 String 그대로 처리함.
    예) 123한(Length:4) : 123?
    
 2. Data Type : Number
    1) Truncate처리
    2) 오른쪽 Shift
    3) Cut
       Number Data가 Layout의 Length보다 작을때 : Length만큼 왼쪽으로 '0' 추가
       예) -123(Length:5) : -0123
       Number Data가 Layout의 Length보다 클때 : Length만큼 왼쪽 기준으로 자름
    단, '-', '.'도 1 Byte로 간주한다.
    단, Number가 Null, ""(zero Length) 일 경우 : Length만큼 공백 생성
    
 3. Data Type : Date
    Date객체에서 해당 Length에 맞춰 값을 가져옴.
    [지원하는 Date Type]
      Length(14) : yyyyMMddHHmmss
      Length(12) : yyyyMMddHHmm
      Length(10) : yyyyMMddHH
      Length(8) : yyyyMMdd
      Length(6) : yyyyMM
      Length(4) : yyyy
      단, Date가 Null, ""(zero Length) 일 경우 : Length만큼 공백 생성
 

Parameters:

messageDefinition - Message Layout의 Attribute항목 List

message - GlueMessage 객체

Returns:

생성된 Message 문자열

makeMessageParsing

GlueMessage makeMessageParsing(GlueMessageDefinition messageDefinition,
                               String message)
                        throws GlueMessageParserException

Message Layout 항목 정보에 따 Message를 파싱하여 GlueMessage 객체에 담는다.

 [Message Byte 파싱 규칙]
 1. Data Type : String
    -DataType : STRING, CHAR, VARCHAR2 모두 동일하게 String으로 간주
    -String Data를 자른후 Rigth Trim처리하여 Message 객체에 저장
    단, String 파싱시 String 중간 절삭이 될 경우 깨진상태로 생성.
    예) 123한글1 : 앞 String(Length:4) -> 123?
                  뒤 String(Length:4) -> ?글1    
    단, Message 공백시 -> ""(Empty String)
    
 2. Data Type : Number
    1) Cut
       단, '-', '.'도 1 Byte로 간주한다.   
    2) Right Trim
    3) 왼쪽으로 Shift
    4) Number 생성후 Message 객체에 저장
    단, Number일때 잘못된 파싱으로 String 중간 절삭시 Exception처리
    단, Message 공백시 -> null(Default)
    
    Number Message 공백시 처리 Option
    1) Message 값이 Zero -> null
    2) Message 값이 Space -> Zero
    3) 1,2 동시
       Message 값이 Zero -> null
       Message 값이 Space -> Zero
    
 3. Data Type : Date
    1) Length만큼 Cut
    2) Date Type에 맞춰 Date 객체 생성후 Message 객체에 저장
    [지원하는 Date Type]
      Length(14) : yyyyMMddHHmmss
      Length(12) : yyyyMMddHHmm
      Length(10) : yyyyMMddHH
      Length(8) : yyyyMMdd
      Length(6) : yyyyMM
      Length(4) : yyyy
      단, Date일때 잘못된 파싱으로 String 중간 절삭시 Exception처리
      단, Message 공백시 -> null
 

Parameters:

messageDefinition - Object

message - Message 문자열

Returns:

GlueMessage

Throws:

GlueMessageParserException

getAttributes

GlueMessageDefinition getAttributes(String messageId)
                             throws GlueMessageDefinitionException

해당 Msg Layout의 Attribute 정보를 추출하는 Method 처음 호출시 Attribute의 정보를 Cache에 저장하고, 재 호출시 Cache를 통해 정보를 추출하여 제공

Parameters:

messageId - Message ID

Returns:

GlueMessageDefinition

Throws:

GlueMessageDefinitionException