EGL 라이브러리 serviceLib

serviceLib 함수는 서비스 변수 정보를 가져오고 설정합니다.

다음 표에서 serviceLib 라이브러리의 시스템 함수에 대해 설명합니다. variable 매개변수는 서비스 파트 또는 인터페이스 파트를 기반으로 하는 변수를 나타냅니다. 두 파트 모두 서비스에 대한 액세스를 제공합니다.

표 1. serviceLib 시스템 함수
시스템 함수 및 호출 설명
result = bindService (string) EGL 배치 디스크립터 파일의 요소를 가리키는 바인딩 이름을 지정합니다.
convertFromJSON (json, variable) JSON 문자열을 레코드 또는 사전으로 변환합니다.
result = convertFromURLEncoded (url) 디코딩된 URL(Universe Resource Locator)의 버전을 리턴합니다. 예를 들어, 리턴되는 문자열에 %20 조합이 아닌 공백이 있습니다.
result = convertToJSON (variable) 레코드 또는 사전을 JSON 문자열로 변환합니다.
result = convertToURLEncoded (input) 문자열을 서비스 호출에 사용할 수 있도록 인코딩된 URL(Universe Resource Locator)의 버전을 리턴합니다.
endStatefulServiceSession (interface, exceptionHandler) Stateful IBM i 프로그램에 대한 액세스를 제공하는 EGL REST-RPC 서비스의 액세스를 지원하는 데 사용된 런타임 자원을 해제합니다.
result = getCurrentCallbackResponse() 서비스 호출 후 콜백 함수 또는 onException 함수가 수신하는 HTTP 응답의 세부사항에 대한 액세스를 제공합니다.
result = getOriginalRequest() HTTP 요청에 대한 액세스를 제공합니다. 함수가 콜백 또는 onException 함수에서 호출된 경우에는 서비스가 콜백 또는 onException 함수를 호출하도록 한 특정 호출 중에 HTTP 요청이 서비스에 전송된 것입니다. serviceLib.getOriginalRequest()가 다른 위치에서 호출된 경우에는 최근 서비스 호출 중에 HTTP 요청이 제공된 것입니다.
result =getRestRequestHeaders (interface) REST 서비스에 액세스하는 데 사용되는 인터페이스 변수에서 사용 가능한 HTTP 요청 헤더를 리턴합니다. 리턴값은 EGL 사전입니다.
result = getRestServiceLocation (interface) REST 서비스에 액세스하는 데 사용되는 기본 URI를 리턴합니다. 리턴값은 문자열입니다.
getSOAPRequestHeaders (headerRecord) 서비스 요청자가 제공하는 SOAP 요청 헤더에 대한 액세스를 제공합니다. 이 함수는 EGL 생성 서비스와 Java 기반 SOAP 서비스에서만, 서비스가 JAX-RPC가 아니라 JAX-WS에 의존하는 경우에만 올바릅니다.
getSOAPResponseHeaders (interface, headerRecord) 서비스 요청자에 제공되는 SOAP 응답 헤더에 대한 액세스를 제공합니다. 이 함수는 JAX-RPC가 아니라 JAX-WS에 의존하는 Java 기반 또는 JavaScript 기반 요청자에서만 사용 가능합니다.
result = getTCPIPLocation (variable) EGL 서비스에 대한 TCP/IP 액세스를 제공하는 호스트 이름과 포트 번호를 리턴합니다.
result = getWebServiceLocation (variable) SOAP 서비스에 대한 액세스를 제공하는 URL을 리턴합니다.
setHTTPBasicAuthentication (userID, password) JEE 기본 인증으로 액세스가 보호되는 경우 웹 애플리케이션에 대한 사용자 액세스를 제공합니다. 이 함수를 사용하면 HTTP 헤더에 포함할 수 있도록 자동으로 암호화되는 사용자 ID와 비밀번호를 제공할 수 있습니다.
setProxyBasicAuthentication (userID, password) JEE 기본 인증으로 액세스가 보호되는 경우 EGL Rich UI 프록시에 대한 사용자 액세스를 제공합니다. 이 함수를 사용하면 HTTP 헤더에 포함할 수 있도록 자동으로 암호화되는 사용자 ID와 비밀번호를 제공할 수 있습니다.
setRestRequestHeaders (interface, headers) REST 서비스에 전송되는 HTTP 헤더를 설정합니다. 헤더는 EGL 사전에 있습니다.
setRestServiceLocation (interface, baseURI) REST 서비스에 액세스하는 데 사용되는 기본 URI를 설정합니다.
setSOAPRequestHeaders (interface, headerRecord) SOAP 서비스에 전송할 요청 헤더를 설정합니다. 이 함수는 JAX-RPC가 아니라 JAX-WS에 의존하는 Java 기반 또는 JavaScript 기반 요청자에서만 사용 가능합니다.
setSOAPResponseHeaders (headerRecord) 서비스 요청자에 리턴할 응답 헤더를 설정합니다. 이 함수는 EGL 생성 서비스와 Java 기반 SOAP 서비스에서만, 서비스가 JAX-RPC가 아니라 JAX-WS에 의존하는 경우에만 사용 가능합니다.
setTCPIPLocation (variable, string) EGL 서비스에 대한 TCP/IP 액세스를 제공하는 호스트 이름과 포트 번호를 설정합니다.
setWebServiceLocation (variable, string) SOAP 서비스에 대한 액세스를 제공하는 URL을 설정합니다.

호환성

표 2. serviceLib의 호환성 고려사항
플랫폼 문제
IMS/VS, IMS™ BMP serviceLib가 지원되지 않습니다.
VSE serviceLib가 지원되지 않습니다.