예제

본 장에서는 AnyLink TCP 어댑터를 사용한 예제를 설명한다.

1. 개요

사용된 전문은 모두 Fixed Length에 통신헤더(4byte) 방식을 기본으로 한다.

다음은 TCP 기본 거래 구성이다.

figure tcp tutorial 1 info
기본 거래 구성도

다음은 거래 순서를 수행하는 과정에 대한 설명이다.

  1. Sample TCP Client를 통해 요청 입력 전문을 전송한다.

  2. 인바운드 어댑터로 전문 수신 후 서비스 플로우를 수행한다.

  3. 서비스 플로우에서 요청 입력 전문을 요청 출력 전문으로 매핑한다.

  4. 아웃바운드 어댑터를 통해 요청 출력 전문을 Sample TCP Server로 전송한다.

  5. Sample TCP Server에서 응답 입력 전문을 전송한다.

  6. 서비스 플로우에서 응답 입력 전문을 응답 출력 전문으로 매핑한다.

  7. 인바운드 어댑터로 응답 출력 전문을 Sample TCP Client로 전송한다.

 

전문 구성

다음은 예제에서 사용할 전문 구성이다.

  • 요청 입력

    • 헤더 전문

      필드명 설명 타입 크기

      kind_code

      종별코드

      Char

      4

      tx_code

      거래코드

      Char

      4

      date

      날짜

      Char

      8

      id

      아이디

      Char

      10

    • 바디 전문

      필드명 설명 타입 크기

      branch_number

      지점번호

      Number

      3

      teller_number

      담당자번호

      Char

      5

      name

      이름

      Char

      10

      account

      계정

      Char

      12

      data

      데이터

      Char

      50

  • 요청 출력

    • 헤더 전문

      필드명 설명 타입 크기

      tx_code

      거래코드

      Char

      4

      id

      아이디

      Char

      10

    • 바디 전문

      필드명 설명 타입 크기

      name

      이름

      Char

      10

      account

      계정

      Char

      12

      data

      데이터

      Char

      50

  • 응답 입력

    • 헤더 전문

      필드명 설명 타입 크기

      return_code

      응답 코드

      Char

      4

      id

      아이디

      Char

      10

    • 바디 전문

      필드명 설명 타입 크기

      transactionDate

      응답일자

      Char

      8

      transferType

      관리정보

      Char

      4

  • 응답 출력

    • 헤더 전문

      필드명 설명 타입 크기

      kind_code

      종별코드

      Char

      4

      tx_code

      거래코드

      Char

      4

      date

      날짜

      Char

      8

      id

      아이디

      Char

      10

    • 바디 전문

      필드명 설명 타입 크기

      return_code

      응답코드

      Char

      4

      transferType

      관리정보

      Char

      4

2. 어댑터 생성

AnyLink WebAdmin에 로그인한 후 초기 화면에서 [구성관리] > [어댑터]를 선택한 후 어댑터 목록 화면[Add] 버튼을 클릭하면 어댑터 등록 화면이 나타난다. 어댑터 생성에 대한 자세한 내용은 어댑터 설정을 참고한다.

AnyLink WebAdmin의 접속 및 사용법에 관한 자세한 내용은 AnyLink WebAdmin 안내서를 참고한다.

2.1. 인바운드 어댑터 생성

다음은 TCP 인바운드 어댑터를 생성하는 예제이다.

figure create tcp in adapter
인바운드 어댑터 등록 화면
  • 기본정보

    항목 설정값

    어댑터 아이디

    TCP_IN_ADT

    어댑터 이름

    TCP_IN_ADT

    어댑터 종류

    TCP

    설명

    TCP 인바운드 어댑터

    업무시스템

    ANL001

  • [상세설정] 탭

    항목 설정값

    아웃바운드 스레드 풀 아이디

    사용 안함

2.2. 아웃바운드 어댑터 생성

다음은 TCP 아웃바운드 어댑터를 생성하는 예제이다.

figure create tcp out adapter
아웃바운드 어댑터 등록 화면
  • 기본정보

    항목 설정값

    어댑터 아이디

    TCP_OUT_ADT

    어댑터 이름

    TCP_OUT_ADT

    어댑터 종류

    TCP

    설명

    TCP 아웃바운드 어댑터

    업무시스템

    ANL001

  • [상세설정] 탭

    항목 설정값

    아웃바운드 스레드 풀 아이디

    사용 안함

3. 엔드포인트 생성

어댑터 생성이 완료되면 [어댑터] 탭에서 등록된 어댑터를 조회하고, 조회된 어댑터를 클릭하면 어댑터 상세정보 화면으로 이동한다.

[엔드포인트 목록] 탭 아래 [Add] 버튼을 클릭하면 엔드포인트 등록 화면이 나타난다. 엔드포인트 생성에 대한 자세한 설명은 엔드포인트 설정을 참고한다.

3.1. 인바운드 엔드포인트 생성

다음은 TCP 인바운드 엔드포인트를 등록하는 예제이다. 본 예제에서는 [SSL] 탭은 설정하지 않는다.

  • 기본정보

    figure tutorial ep in basic info
    인바운드 엔드포인트 등록 화면 - 기본정보
    항목 설정값

    엔드포인트 아이디

    TCP_IN_EP

    엔드포인트 이름

    TCP_IN_EP

    엔드포인트 상태

    Running

    부팅 초기값

    Running

    통신 방향

    Inbound

    설명

    TCP 인바운드 엔드포인트

  • [연결정보] 탭

    figure tutorial ep in connect info
    인바운드 엔드포인트 등록 화면 - [연결정보]
    항목 설정값

    연결 방식

    Server

    서버연결유지

    No

    포트

    30000

    Idle 타임아웃

    60000

    동기/비동기 여부

    동기

    최대 연결 수

    5

  • [상세설정] 탭

    figure tutorial ep in detail info
    인바운드 엔드포인트 등록 화면 - [상세설정]
    항목 설정값

    거래그룹/거래

    manual.tcp.tcpCase1.tx01 (거래그룹/거래 항목은 직접 입력해도 되고 차후 거래그룹/거래 생성 후 선택하여도 무방하다.)

  • [메시지/장애처리] 탭

    figure tutorial ep in message info
    인바운드 엔드포인트 등록 화면 - [메시지/장애처리]
    항목 설정값

    메시지 길이지정 방식

    헤더에 길이정보 포함

    헤더 종류

    통신 헤더

    헤더 길이

    4

    오프셋

    0

    길이

    4

3.2. 아웃바운드 엔드포인트 생성

다음은 TCP 아웃바운드 엔드포인트를 등록하는 예제이다. 아웃바운드 엔드포인트는 [상세설정] 탭을 설정하지 않는다. 본 예제에서는 [SSL] 탭은 설정하지 않는다.

  • 기본정보

    figure tutorial ep out basic info
    아웃바운드 엔드포인트 등록 화면 - 기본정보
    항목 설정값

    엔드포인트 아이디

    TCP_OUT_EP

    엔드포인트 이름

    TCP_OUT_EP

    엔드포인트 상태

    Running

    부팅 초기값

    Running

    통신 방향

    Outbound

    설명

    TCP 아웃바운드 엔드포인트

  • [연결정보] 탭

    figure tutorial ep out connect info
    아웃바운드 엔드포인트 등록 화면 - [연결정보]
    항목 설정값

    연결 방식

    Client

    연결 관리 여부

    No

    연결 유지 여부

    No

    IP/호스트

    192.168.15.75 (Sample TCP 서버가 구동되어 있는 장비의 장비의 IP를 지정한다.)

    포트

    38000

    연결 타임아웃

    3000

    Idle 타임아웃

    60000

    동기/비동기 여부

    동기

    최대 연결 수

    5

  • [메시지/장애처리] 탭

    figure tutorial ep out message info
    아웃바운드 엔드포인트 등록 화면 - [메시지/장애처리]
    항목 설정값

    메시지 길이지정 방식

    헤더에 길이정보 포함

    헤더 종류

    통신 헤더

    헤더 길이

    4

    오프셋

    0

    길이

    4

4. 스튜디오 리소스 생성

본 절에서는 스튜디오에서 리소스를 생성하는 방법에 대해서 설명한다.

AnyLink 스튜디오 사용법에 대한 자세한 내용은 AnyLink 스튜디오 안내서를 참고한다.

4.1. 거래그룹 생성

거래그룹 네비게이터에서 프로젝트를 선택한 다음 컨텍스트 메뉴에서 [새로만들기] > [거래 / 거래그룹]을 선택한다.

figure tutorial txgrp create
거래그룹 생성
항목 설정값

패키지 이름

manual.tcp

거래 이름

tcpCase1

거래 ID

tcpCase1

4.2. 거래 생성

거래그룹 네비게이터에서 거래그룹을 선택한 다음 컨텍스트 메뉴에서 [새로만들기] > [거래 / 거래그룹]을 선택한다.

figure tutorial tx create
거래 생성
항목 설정값

노드 타입

거래

거래 이름

tx01

거래 ID

tx01

4.3. 메시지 생성

요청 입력 헤더/바디, 요청 출력 헤더/바디, 응답 입력 헤더/바디, 응답 출력 헤더/바디 메시지를 생성한다.

메시지 생성에 관한 자세한 내용은 AnyLink 스튜디오 안내서를 참고한다.

4.4. 아웃바운드 룰 생성

거래그룹 네비게이터에서 거래를 선택한 다음 컨텍스트 메뉴에서 [새로만들기] > [아웃바운드 룰]>[TCP 아웃바운드 룰]을 선택한다.

figure tutorial outboundrule create
아웃바운드 룰 생성
항목 설정값

아웃바운드 이름

TCP아웃바운드

아웃바운드 아이디

tcpOutbound

4.5. 플로우 생성

거래그룹 네비게이터에서 거래를 선택한 다음 컨텍스트 메뉴에서 [새로만들기] > [플로우]를 선택한다.

figure tutorial flow create
플로우 룰 생성
항목 설정값

플로우 아이디

TCPFlow

플로우 이름

TCP플로우

5. 스튜디오 리소스 설정

본 절에서는 생성한 리소스를 설정하는 방법에 대해서 설명한다.

AnyLink 스튜디오 사용법에 대한 자세한 내용은 AnyLink 스튜디오 안내서를 참고한다.

다음은 리소스를 모두 설정한 후 조회되는 거래그룹 네비게이터이다.

figure tutorial navigator
거래그룹 네비게이터

5.1. 거래그룹 설정

다음은 거래그룹을 설정하는 예제 이다. [파싱 옵션] 탭은 설정하지 않는다.

  • [거래그룹 정보] 탭

    figure tutorial txgrp edit
    거래그룹 설정 - [거래그룹 정보]
    항목 설정값

    요청 메시지

    요청입력헤더

    정상 응답 메시지

    응답출력헤더

    Bypass 설정

    NO

    XA 설정

    NO

    오류 응답 방식

    NONE

  • [거래그룹 옵션] 탭

    figure tutorial txgrp edit opt
    거래그룹 설정 - [거래그룹 옵션]
    항목 설정값

    거래 플로우 타임아웃(ms)

    60000

    응답 유무

    REQUEST_RESPONSE

    거래 우선순위

    MEDIUM

  • [파싱정보] 탭

    figure tutorial txgrp edit parsing
    거래그룹 설정 - [파싱 정보]
    항목 설정값

    하위 거래 식별 방법

    MESSAGE

    메시지 ID

    ReqInHeader.umsg

    필드 ID

    tx_code

5.2. 거래 설정

다음은 거래를 설정하는 예제이다. [파싱 옵션] 탭은 설정하지 않는다.

  • [거래정보] 탭

    figure tutorial tx edit
    거래 설정 - [거래정보]
    항목 설정값

    요청 메시지

    요청입력바디

    정상 응답 메시지

    응답출력바디

    Bypass 설정

    NO

    XA 설정

    NO

    오류 응답 방식

    PARENT

    서비스 타입

    FLOW

    서비스 이름

    TCPFlow_Message_STRT_Event_69400C(랜덤으로 생성됨)

  • [거래 옵션] 탭

    figure tutorial tx edit opt
    거래 설정 - [거래 옵션]
    항목 설정값

    거래 플로우 타임아웃(ms)

    미설정

    타임아웃 설정 안함

    체크

    응답 유무

    PARENT

    거래 우선순위

    MEDIUM

  • [파싱 정보] 탭

    figure tutorial tx edit parsing
    거래 설정 - [파싱 정보]
    • 거래 식별코드

      항목 설정값

      코드값

      A001

      종류

      REQUEST

5.3. 아웃바운드 룰 설정

다음은 TCP 아웃바운드 룰 설정 예제이다.

figure tutorial outboundrule edit
아웃바운드 룰 설정
항목 설정값

요청처리 타임아웃(ms)

10000

응답 수신 방식

Sync

Endpoint

TCP_OUT_EP

요청 메시지

요청출력헤더(ReqOutHeader)

요청출력바디(ReqOutBody)

정상 응답 메시지

응답입력헤더(ResInHeader)

응답입력바디(ResInBody)

5.4. 플로우 설정

다음의 과정으로 플로우를 설정한다.

  1. 플로우 그리기

  2. 변수 설정

  3. 메시지 이벤트 설정

  4. 아웃바운드 호출 설정

  5. 응답 호출 설정

 

플로우 그리기

다음은 예제에 대한 서비스 플로우이다.

figure tutorial flow
서비스 플로우 에디터 - 기본 그림

 

변수 설정

변수 설정을 하기 위해 플로우 에디터 바탕의 컨텍스트 메뉴에서 [Property]를 선택한다.

figure tutorial flow add variable
Property Preference - 변수 설정

 

메시지 이벤트 설정

플로우 에디터의 [메시지 이벤트]의 컨텍스트 메뉴에서 [Property]를 선택한다. Event Preference 화면에서 [파라미터 설정]을 선택한다.

figure tutorial flow event param
Event Preference - 파라미터 설정

 

아웃바운드 호출 설정

다음의 과정으로 아웃바운드 호출을 설정한다.

  1. 플로우 에디터의 [아웃바운드 호출] > [아웃바운드 룰] 컨텍스트 메뉴에서 [Property]를 선택한다. Activity Preference 화면에서 [파라미터 설정]을 선택한다.

    figure tutorial flow outbound param
    아웃바운드 호출 - 파라미터 설정
  2. Activity Preference 화면에서 [아웃바운드 룰(서비스) 설정]을 선택한다.

    figure tutorial flow outbound rule
    아웃바운드 호출 - 아웃바운드 룰(서비스) 설정
  3. Activity Preference 화면에서 '요청 매핑 사용''응답 매핑 사용'을 체크하고 [Mapping] 버튼을 클릭해서 각 매핑정보를 설정한다.

    figure tutorial flow outbound rule req mapping
    아웃바운드 호출 - 아웃바운드 룰(서비스) 설정 - 요청 매핑
    figure tutorial flow outbound rule res mapping
    아웃바운드 호출 - 아웃바운드 룰(서비스) 설정 - 응답 매핑

 

응답 호출 설정

다음의 과정으로 응답 호출 설정을 설정한다.

  1. 플로우 에디터의 [응답 송신] > [Reply 메시지] 컨텍스트 메뉴에서 [Property]를 선택한다. Activity Preference 화면에서 [Reply Message]를 선택한다.

    figure tutorial flow reply reply message
    응답 송신 - Reply Message
  2. Activity Preference 화면에서 'Use Mapping'을 체크하고 [Reply Mapping] 버튼을 클릭해서 각 매핑정보를 설정한다.

    Mapping 화면의 Source 영역의 컨텍스트 메뉴에서 [Add source]를 선택하여 ReqInHeader, ResInHeader, ResInBody를 선택한 후 매핑한다.

    figure tutorial flow reply reply mapping
    응답 송신 - Reply Message - 서비스 매핑 - Reply Mapping

6. 배포

거래그룹/거래 배포정보를 설정한다.

figure tutorial deploy
거래그룹 / 거래 배포

거래 배포 설정화면에 대한 자세한 사용법은 AnyLink 스튜디오 안내서를 참고한다.

7. 거래 테스트

본 절에서는 거래 테스트를 위한 클라이언트 프로그램, 서버 프로그램과 테스트 수행 결과를 설명한다.

7.1. 클라이언트 프로그램

<TCPClient.java>

package manual.tcp;

import java.io.BufferedReader;
import java.io.BufferedWriter;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.OutputStreamWriter;
import java.net.Socket;

public class TCPClient {
    BufferedReader br;
    BufferedWriter bw;
    InputStream is;
    OutputStream os;
    int headerLength = 4;

    String ip;
    int port;
    String message;

    public TCPClient(String ip, int port, String message, int headerLength) {
        this.ip = ip;
        this.port = port;
        this.message = message;
        this.headerLength = headerLength;
    }

    public void run() {
        try {
            System.out.println("Start Client ip:" + ip + " port:" + port);
            long startTime = System.currentTimeMillis();

            Socket socket = new Socket(ip, port);
            socket.setSoTimeout(10000);
            is = socket.getInputStream();
            os = socket.getOutputStream();

            br = new BufferedReader(new InputStreamReader(is));
            bw = new BufferedWriter(new OutputStreamWriter(os));

            System.out.println("TCPSimpleClient:Connected to " + socket.getRemoteSocketAddress());
            bw.write(message);
            bw.flush();
            System.out.println("TCPSimpleClient:Send message : " + message);

            char[] headerbuf = new char[headerLength];
            br.read(headerbuf, 0, headerLength);
            System.out.println("recv length: " + new String(headerbuf));
            int bodybufLength = Integer.parseInt(new String(headerbuf));

            char[] bodybuf = new char[bodybufLength];
            br.read(bodybuf);
            System.out.println("TCPSimpleClient:recv data: " + new String(bodybuf));

            bw.flush();
            br.close();
            bw.close();

            is.close();
            os.close();

            socket.close();

            long endTime = System.currentTimeMillis();
            long lTime = endTime - startTime;
            System.out.println("TCPSimpleClient:TIME : " + lTime + "(ms)");

        } catch (Throwable t) {
            t.printStackTrace();
        }
    }

    public static void main(String[] args) {
        String sendMessage = "0106AAAAA00120160701KIMCHEOLSUB01P1034LEEYEONGSUKNIGHT      THISISSAMPLEDATA                                  ";
        TCPClient client = new TCPClient("192.168.14.106", 30000, sendMessage, 4);
        client.run();
    }
}

7.2. 서버 프로그램

<TCPServer.java>

package manual.tcp;


import java.io.BufferedReader;
import java.io.BufferedWriter;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.OutputStreamWriter;
import java.net.ServerSocket;
import java.net.Socket;


public class TCPServer extends Thread {

    BufferedReader br;
    BufferedWriter bw;
    InputStream is;
    OutputStream os;
    int port;
    int headerLength = 4;

    public TCPServer(int port, int headerLength) {
        this.port = port;
        this.headerLength = headerLength;
    }

    @Override
    public void run() {
        ServerSocket serverSocket = null;
        try {
            System.out.println("Start TCP Server");
            serverSocket = new ServerSocket(port);
            while (true) {
                Socket socket = serverSocket.accept();
                System.out.println("Accept from client:" + port);

                is = socket.getInputStream();
                os = socket.getOutputStream();
                br = new BufferedReader(new InputStreamReader(is));
                bw = new BufferedWriter(new OutputStreamWriter(os));

                System.out.println("read...");

                char[] headerbuf = new char[headerLength];
                br.read(headerbuf, 0, headerLength);
                System.out.println("recv length: " + new String(headerbuf));

                int bodybufLength = Integer.parseInt(new String(headerbuf));
                char[] bodybuf = new char[bodybufLength];

                br.read(bodybuf, 0, bodybufLength);

                System.out.println("recv data: " + new String(bodybuf));

                System.out.println("write...");
                String retMessage = "00261000KIMCHEOLSU20160720SP01";
                System.out.println("send message: " + retMessage);
                bw.write(retMessage);
                System.out.println("write done");

                bw.flush();
                br.close();
                bw.close();
            }

        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            try {
                if (serverSocket != null) {
                    serverSocket.close();
                }
            } catch (Throwable t) {
            }
        }
    }

    public static void main(String[] args) {
        TCPServer server = new TCPServer(38000, 4);
        server.start();

        try {
            Thread.sleep(600000);
        } catch (InterruptedException e) {
        }
    }
}

7.3. 테스트 수행

  • 클라이언트 결과 화면

    Start Client ip:192.168.14.106 port:30000
    TCPSimpleClient:Connected to /192.168.14.106:30000
    TCPSimpleClient:Send message : 0106AAAAA00120160701KIMCHEOLSUB01P1034LEEYEONGSUKNIGHT      THISISSAMPLEDATA
    recv length: 0034
    TCPSimpleClient:recv data: AAAAA00120160701KIMCHEOLSU1000SP01
    TCPSimpleClient:TIME : 268(ms)
  • 서버 결과 화면

    Start TCP Server
    Accept from client:38000
    read...
    recv length: 0086
    recv data: A001KIMCHEOLSULEEYEONGSUKNIGHT      THISISSAMPLEDATA
    write...
    send message: 00261000KIMCHEOLSU20160720SP01
    write done