TCP 리소스

TCP 리소스 생성

목 서버에 새로운 TCP 리소스를 생성할 수 있습니다.

  1. 워크스페이스 화면에서 [Mock Server] 메뉴를 선택합니다.

  2. 리소스 영역의 목록에서 TCP 목 서버(또는 하위 폴더)에 마우스를 올리면 오른쪽 끝에 image 아이콘이 표시됩니다.

    figure tcp mock more menu icon active

  3. image 아이콘을 클릭하면 드롭다운 메뉴가 열립니다. 이때 [TCP 리소스 생성] 메뉴를 선택합니다.

  4. [new Mock Resource] 탭 화면이 열리면 TCP 리소스의 정보를 설정합니다. (*: 필수 항목)

    figure tcp mock request create

    • 기본 정보

      항목 설명

      목 파일 이름 *

      TCP 리소스의 이름입니다.

      설명

      TCP 리소스에 대한 간략한 설명입니다.

      리소스 응답 유형

      응답을 반환하는 방식입니다.

      • 동기

      • 비동기

      응답 메시지 사용 여부

      응답 메시지의 사용 여부입니다.

      • image: 사용함

      • image: 사용 안 함

    • 비동기 아웃바운드 연결 설정

      외부 시스템과 통신하기 위한 연결 정보를 설정합니다. 단, 리소스 응답 유형이 '비동기’일 경우에만 설정할 수 있습니다.

      자세한 내용은 비동기 아웃바운드 연결 설정을 참고합니다.

    • 식별 룰 설정

      요청을 구분하는 규칙을 설정합니다. 요청 메시지의 특정 패턴이나 조건을 지정하여, 해당 규칙에 따라 적절한 응답을 반환할 수 있습니다.

      자세한 내용은 식별 룰 설정을 참고합니다.

    • 응답 메시지 설정

      요청을 식별한 후 반환할 응답 메시지를 설정합니다.

      자세한 내용은 응답 메시지 설정을 참고합니다.

    • 반환 메시지 설정

      요청 처리 결과를 반환하는 메시지를 설정합니다. 단, 리소스 응답 유형이 '비동기’일 경우에만 설정할 수 있습니다.

      자세한 내용은 반환 메시지 설정을 참고합니다.

  5. 설정이 완료되면 화면 오른쪽 상단의 [저장] 버튼을 클릭합니다.

비동기 아웃바운드 연결 설정

[TCP 리소스] 탭 화면의 '비동기 아웃바운드 연결 설정' 영역에서는 외부 시스템과 통신하기 위한 연결 정보를 설정할 수 있습니다. (*: 필수 항목)

figure tcp mock resource outbound endpoint set
항목 설명

연결 방식

연결 시 수행할 역할입니다.

  • SERVER

  • CLIENT

IP *

TCP 연결에 사용할 서버의 IP 주소입니다.
※ 연결 방식이 'CLIENT’인 경우에만 설정할 수 있습니다.

포트 *

TCP 연결에 사용할 포트 번호입니다.

메시지 인코딩 방식

메시지를 송신할 때 적용할 문자 인코딩 방식입니다.

연결 유지 여부

TCP 연결을 지속적으로 유지할지 여부입니다.

  • image: 유지함

  • image: 유지 안 함

반환 메시지 사용 여부

요청 처리 결과를 반환하는 메시지의 사용 여부입니다.

  • image: 사용함

  • image: 사용 안 함

최대 연결 수

동시에 유지할 수 있는 최대 연결 수입니다.
※ 연결 방식이 'SERVER’인 경우에만 설정할 수 있습니다.

연결 타임아웃 (ms)

연결 시 허용하는 최대 대기 시간입니다. (단위: 밀리초)
※ 연결 방식이 'CLIENT’인 경우에만 설정할 수 있습니다.

유휴 타임아웃 (ms)

데이터 전송 없이 연결을 유지하는 최대 시간입니다. (단위: 밀리초)
※ 연결 방식이 'CLIENT’인 경우에만 설정할 수 있습니다.

식별 룰 설정

[TCP 리소스] 탭 화면의 '식별 룰 설정' 영역에서는 요청을 구분하는 규칙을 설정할 수 있습니다.

  1. '수신 메시지 타입' 항목에서 수신할 메시지의 타입을 설정합니다.

    figure tcp mock resource message type select

    다음은 수신 메시지 타입별 조건 비교 방식에 대한 설명입니다.

    수신 메시지 타입 조건 비교 방식

    JSON

    JSON 형식의 수신 메시지에서 지정한 필드의 값을 추출하여 조건과 비교합니다.

    FIXED_LENGTH

    수신 메시지에서 오프셋과 길이만큼의 값을 추출하여 조건과 비교합니다.

    DELIMITER

    수신 메시지를 구분 문자를 기준으로 분리한 뒤 지정한 인덱스의 값을 추출하여 조건과 비교합니다.

    ※ DELIMITER를 선택하면 '구분 문자' 항목이 추가로 표시되며, 메시지를 나누는 기준 문자를 반드시 입력해야 합니다. (예: &)

    XML

    XML 형식의 수신 메시지에서 지정한 태그의 값을 추출하여 조건과 비교합니다.

  2. '연산 방식' 항목에서 수신한 메시지의 특정 값이나 패턴을 확인하기 위한 조건을 설정합니다.

    figure tcp mock resource condition set

    이때 조건은 여러 개 추가할 수 있으며, '연산 방식' 항목의 설정에 따라 조건 검증 방식이 달라집니다. AND를 선택하면 모든 조건을 만족해야 응답이 반환되고, OR을 선택하면 조건 중 하나만 만족해도 응답이 반환됩니다.

    • 조건 추가

      [+ 행 추가] 버튼을 클릭하여 새로운 조건을 입력할 수 있는 행을 추가합니다.

      항목 설명

      필드

      검증할 값을 확인할 대상입니다.

      다음은 수신 메시지 타입별 입력 예시입니다.

      • FIXED_LENGTH: 0,5

      • JSON: a.b

      • XML: /a/b

      • DELIMITER: 2

      조건

      필드에서 추출한 값과 검증값을 비교할 때 사용할 연산자입니다.

      • = (Equal): 필드값이 검증값과 일치하는지 확인

      • != (Not Equal): 필드값이 검증값과 일치하지 않는지 확인

      • () (Contains): 필드값에 검증값이 포함되어 있는지 확인

      • !() (Not Contains): 필드값에 검증값이 포함되어 있지 않은지 확인

      검증값

      필드에서 추출한 값과 비교할 기준값입니다.

    • 조건 삭제

      삭제할 조건의 체크박스를 선택한 후 [행 삭제] 버튼을 클릭하거나, 각 행의 image 아이콘을 클릭합니다.

응답 메시지 설정

[TCP 리소스] 탭 화면의 '응답 메시지 설정' 영역에서는 요청을 식별한 후 반환할 응답 메시지를 설정할 수 있습니다.

  1. '응답 메시지 타입' 항목에서 응답할 메시지의 타입을 설정합니다.

    figure tcp mock resource response message type select

  2. '응답 메시지' 항목에서 응답할 메시지의 내용을 입력합니다.

    JSON 또는 XML 형식에서는 코드 블럭 오른쪽 상단의 image 버튼을 클릭하면 데이터가 자동으로 정렬되어 보기 쉽게 표시됩니다.

    figure tcp mock resource response message set

반환 메시지 설정

[TCP 리소스] 탭 화면의 '반환 메시지 설정' 영역에서는 요청 처리 결과를 반환하는 메시지를 설정할 수 있습니다.

  1. '반환 메시지 타입' 항목에서 반환할 메시지의 타입을 설정합니다.

    figure tcp mock resource return message type select

  2. '반환 메시지' 항목에서 반환할 메시지의 내용을 입력합니다.

    JSON 또는 XML 형식에서는 코드 블럭 오른쪽 상단의 image 버튼을 클릭하면 데이터가 자동으로 정렬되어 보기 쉽게 표시됩니다.

    figure tcp mock resource return message set