REST API에서 JSON이 아닌 데이터 핸들링

REST API는 JSON 데이터를 처리하기 위해 기본적으로 설정되지만 다른 데이터 형식도 핸들링할 수 있습니다.

시작하기 전에

다음 태스크를 완료해야 합니다.

IBM® App Connect Enterprise Toolkit 에서 REST API를 생성해야 합니다. 자세한 내용은 ‘REST API 생성’을 참조하십시오.
REST API에서 하나 이상의 조작을 구현해야 합니다. Swagger 2문서에 대해 REST API 편집기를 사용하여 REST API에서 조작 구현을 참조하십시오.

태스크 정보

메시지가 구현된 조작에 대한 서브플로우의 Input 노드에 도착하면 해당 메시지의 메시지 도메인이 JSON으로 설정됩니다. 구현된 작업에 대해 하위 흐름에서 다른 유형의 데이터를 처리할 수 있습니다. ResetContentDescriptor 메시지 구문 분석이 수행되기 전에 메시지의 메시지 도메인을 변경하려면 노드를 사용하세요.

Route 노드를 사용하여 동일한 서브플로우에서 여러 유형의 데이터를 핸들링할 수도 있습니다. 다음을 구성할 수 있습니다. 노선 데이터를 라우팅하는 노드 ResetContentDescriptor 요청 메시지의 Content-Type 헤더를 기반으로 하는 노드입니다. Content-Type 헤더는 HTTP 클라이언트의 요청에 추가할 수 있으며 이는 요청에서 데이터 유형을 설명하는 데 사용됩니다.

프로시저

REST API에서 JSON이 아닌 데이터를 핸들링하려면 다음 단계를 완료하십시오.

REST API Description를 열고 수정하려는 구현된 오퍼레이션에 대해 오퍼레이션 열기 링크를 클릭하십시오.
선택사항: 이 서브플로우에서 여러 유형의 데이터를 처리하려면 다음 단계를 완료하십시오.
1. 캔버스에 Route 노드를 추가하십시오.
2. 서브플로우 입력 노드의 Out 터미널을 Route 노드의 In 터미널에 연결하십시오.
3. 라우트 노드를 마우스 오른쪽 단추로 클릭하고 출력 터미널 추가를 클릭하여 처리할 각 메시지 도메인 및 데이터 유형에 대한 라우트 노드에 출력 터미널을 추가하십시오.
4. 필터 테이블에 항목을 추가하여 라우트 노드의 새 터미널로 라우트합니다.
5. Content-Type에서 라우트하려면 다음 XPath 표현식을 XMLNSC 도메인을 사용하는 XML 요청 메시지 핸들링 예로 사용하십시오.
```
starts-with($Root/HTTPInputHeader/Content-Type,'application/xml')
```
  HTTP 클라이언트는 유형 및 하위 유형 다음에 선택적 문자 세트 매개변수로 송신할 수도 있기 때문에 XPath 표현식에 starts-with 함수를 사용하십시오.
을 추가하다 ResetContentDescriptor 캔버스에 노드를 추가합니다.
- 추가한 경우 노선 이전 단계에서 노드를 추가해야 합니다. ResetContentDescriptor 처리하려는 각 메시지 도메인 및 데이터 유형에 대한 노드입니다. JSON 데이터를 처리하는 경우에는 ResetContentDescriptor 마디.
- 추가하지 않은 경우 노선 이전 단계의 노드를 연결합니다. 밖으로 서브플로우의 터미널 입력 노드에 ~ 안에 터미널 ResetContentDescriptor 마디.
- 추가한 경우 노선 이전 단계에서 추가한 터미널을 해당 노드에 연결하세요. ResetContentDescriptor 해당 메시지 도메인 및 데이터 유형에 대한 노드입니다.
각각 ResetContentDescriptor 이전 단계에서 추가한 노드를 구성합니다. ResetContentDescriptor 노드의 값을 지정하여 메시지 도메인 재산. 메시지 도메인 재설정도 선택해야 합니다.
이제 IBM App Connect Enterprise 에 포함된 표준 메시지 흐름 노드 중 하나를 사용하여 작업을 계속 진행할 수 있습니다. 이전 단계에서 추가한 ‘ IBM App Connect Enterprise ’ 노드의 ‘Out’ 단자에 새로운 메시지 흐름 노드를 연결하십시오.

결과

JSON이 아닌 데이터를 핸들링하도록 REST API가 설정됩니다.

다음 수행할 사항

REST API를 통합 서버에 패키징하고 배치해야 합니다. REST API 패키징 및 배치를 참조하십시오.

다음의 선택적 태스크를 완료할 수도 있습니다.

서브플로우 세트로 REST API에 대한 오류 처리를 구현하십시오. REST API에서 오류 핸들러 구현을 참조하십시오.
클라이언트와 서버 간 통신을 암호화하기 위해 HTTPS 사용하여 REST API를 보호하세요. HTTPS 사용하여 REST API 보안을 참조하세요.
HTTP 의 기본 인증을 통해 사용자를 인증하여 REST API를 보호하는 방법은 HTTP 의 기본 인증을 사용하여 REST API를 보호하는 방법을 참고하세요.
웹 브라우저에서 실행 중인 클라이언트 측 코드에서 REST API를 사용하려는 경우 CORS (Cross-Origin Resource Sharing)를 구성해야 할 수 있습니다. CORS (Cross-Origin Resource Sharing) 를 사용하여 REST API에 액세스하도록 웹 브라우저 허용을 참조하십시오.