JavaScript HTTP 어댑터

개요

HTTP 어댑터를 사용하여 GET 또는 POST HTTP 요청을 보내고 데이터를 응답 헤더와 본문에서 검색할 수 있습니다. HTTP 어댑터는 RESTful 및 SOAP 기반 서비스에서 작동하며 구조화된 HTTP 소스(예: RSS 피드)를 읽을 수 있습니다.

단순한 서버 측 JavaScript 코드를 사용하여 HTTP 어댑터를 쉽게 사용자 정의할 수 있습니다. 예를 들어, 필요한 경우 서버 측 필터링을 설정할 수 있습니다. 검색된 데이터는 XML, HTML, JSON 또는 일반 텍스트 형식으로 되어 있습니다.

어댑터는 어댑터 특성과 프로시저를 정의하기 위해 XML으로 구성됩니다.
선택적으로 수신한 레코드와 필드를 필터링하기 위해 XSL을 사용할 수도 있습니다.

전제조건: JavaScript 어댑터 학습서를 먼저 읽으십시오.

XML 파일

XML 파일은 설정과 메타데이터를 포함합니다.
어댑터 XML 파일을 편집하려면 다음을 수행해야 합니다.

• 프로토콜을 HTTP 또는 HTTPS로 설정하십시오.
• HTTP 도메인을 HTTP URL의 도메인 파트로 설정하십시오.
• TCP 포트를 설정하십시오.

connectivity 요소 아래에 필수 프로시저를 선언하십시오.

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<mfp:adapter name="JavaScriptHTTP"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:mfp="http://www.ibm.com/mfp/integration"
	xmlns:http="http://www.ibm.com/mfp/integration/http">

	<displayName>JavaScriptHTTP</displayName>
	<description>JavaScriptHTTP</description>
	<connectivity>
		<connectionPolicy xsi:type="http:HTTPConnectionPolicyType">
			<protocol>https</protocol>
			<domain>mobilefirstplatform.ibmcloud.com</domain>
			<port>443</port>
			<connectionTimeoutInMilliseconds>30000</connectionTimeoutInMilliseconds>
			<socketTimeoutInMilliseconds>30000</socketTimeoutInMilliseconds>
			<maxConcurrentConnectionsPerNode>50</maxConcurrentConnectionsPerNode>
		</connectionPolicy>
	</connectivity>

	<procedure name="getFeed"/>
	<procedure name="getFeedFiltered"/>
</mfp:adapter>

JavaScript 구현

서비스 URL이 프로시저 호출에 사용됩니다. URL의 일부 파트는 상수입니다(예: http://example.com/).
URL의 다른 파트는 매개변수화될 수 있습니다. 즉, 프로시저에 제공되는 매개변수값에 의해 런타임 시 대체될 수 있습니다.

다음 URL 파트는 매개변수화될 수 있습니다.

• 경로 요소
• 조회 문자열 매개변수
• 단편

HTTP 요청을 호출하려면 MFP.Server.invokeHttp 메소드를 사용하십시오.
지정할 입력 매개변수 오브젝트를 제공하십시오.

• HTTP 메소드: GET, POST, PUT, DELETE
• 리턴되는 컨텐츠 유형: XML, JSON, HTML 또는 plain
• 서비스 path
• 조회 매개변수(선택사항)
• 요청 본문(선택사항)
• 변환 유형(선택사항)

function getFeed() {
  var input = {
      method : 'get',
      returnedContentType : 'xml',
      path : "feed.xml"
  };


  return MFP.Server.invokeHttp(input);
}

옵션의 전체 목록은 사용자 문서의 “MFP.Server.invokeHttp”에 대한 API 참조를 참조하십시오.

XSL

변환 필터링

또한 예를 들어 데이터를 필터링하기 위해 XSL 변환을 수신 데이터에 적용할 수 있습니다.
XSL 변환을 적용하려면 JavaScript 구현 파일의 옆에 filtered.xsl 파일을 작성하십시오.

그런 다음 프로시저 호출의 입력 매개변수에서 변환 옵션을 지정할 수 있습니다. 예:

function getFeedFiltered() {

  var input = {
      method : 'get',
      returnedContentType : 'xml',
      path : "feed.xml",
      transformation : {
        type : 'xslFile',
        xslFile : 'filtered.xsl'
      }
  };

  return MFP.Server.invokeHttp(input);
}

SOAP 기반 서비스 요청 작성

MFP.Server.invokeHttp API 메소드를 사용하여 SOAP 엔벨로프를 작성할 수 있습니다.
참고: JavaScript HTTP 어댑터에서 SOAP 기반 서비스를 호출하기 위해 E4X를 사용하여 요청 본문 내 SOAP XML 엔벨로프를 암호화할 수 있습니다.

var request =
		<soap:Envelope
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xmlns:xsd="http://www.w3.org/2001/XMLSchema"
      xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
			<soap:Body>
				<GetCitiesByCountry xmlns="http://www.webserviceX.NET">
					<CountryName>{countryName}</CountryName>
				</GetCitiesByCountry>
			</soap:Body>
		</soap:Envelope>;

그런 다음 MFP.Server.invokeHttp(options) 메소드는 SOAP 서비스에 대한 요청을 호출하는 데 사용됩니다.
Options 오브젝트는 다음 특성을 포함해야 합니다.

• method 특성: 일반적으로 POST
• returnedContentType 특성: 일반적으로 XML
• path 특성: 서비스 경로
• body 특성: content(문자열로서의 SOAP XML) 및 contentType

var input = {
	method: 'post',
	returnedContentType: 'xml',
	path: '/globalweather.asmx',
	body: {
		content: request.toString(),
		contentType: 'text/xml; charset=utf-8'
	}
};

var result = MFP.Server.invokeHttp(input);

SOAP 기반 서비스의 호출 결과

결과는 JSON 오브젝트로 랩핑됩니다.

{
	"statusCode" : 200,
	"errors" : [],
	"isSuccessful" : true,
	"statusReason" : "OK",
	"Envelope" : {
		"Body" : {
			"GetWeatherResponse" : {
				"xmlns" : "http://www.webserviceX.NET",
				"GetWeatherResult" : "<?xml version=\"1.0\" encoding=\"utf-16\"?>\n<CurrentWeather>\n  <Location>Shanghai / Hongqiao, China (ZSSS) 31-10N 121-26E 3M</Location>\n  <Time>Mar 07, 2016 - 01:30 AM EST / 2016.03.07 0630 UTC</Time>\n  <Wind> from the W (270 degrees) at 4 MPH (4 KT) (direction variable):0</Wind>\n  <Visibility> 4 mile(s):0</Visibility>\n  <Temperature> 69 F (21 C)</Temperature>\n  <DewPoint> 53 F (12 C)</DewPoint>\n  <RelativeHumidity> 56%</RelativeHumidity>\n  <Pressure> 29.94 in. Hg (1014 hPa)</Pressure>\n  <Status>Success</Status>\n</CurrentWeather>"
			}
		},
		"xsd" : "http://www.w3.org/2001/XMLSchema",
		"soap" : "http://schemas.xmlsoap.org/soap/envelope/",
		"xsi" : "http://www.w3.org/2001/XMLSchema-instance"
	},
	"responseHeaders" : {
		"X-AspNet-Version" : "4.0.30319",
		"Date" : "Mon, 07 Mar 2016 06:46:08 GMT",
		"Content-Length" : "1027",
		"Content-Type" : "text/xml; charset=utf-8",
		"Server" : "Microsoft-IIS/7.0",
		"X-Powered-By" : "ASP.NET",
		"Cache-Control" : "private, max-age=0",
		"X-RBT-Optimized-By" : "e8i-wx-sh4 (RiOS 8.6.2d-ibm1) SC"
	},
	"warnings" : [],
	"totalTime" : 654,
	"responseTime" : 651,
	"info" : []
}

Envelope 특성을 참고하십시오. 이 특성은 SOAP 기반 요청에 특정합니다.
Envelope 특성은 SOAP 기반 요청의 결과 컨텐츠를 포함합니다.

XML 컨텐츠에 액세스하려면 다음을 수행하십시오.

• 클라이언트 측에서 jQuery는 결과 문자열을 랩핑하는 데 사용될 수 있으며 DOM 노드를 따를 수 있습니다.

var resourceRequest = new WLResourceRequest(
    "/adapters/JavaScriptSOAP/getWeatherInfo",
    WLResourceRequest.GET
);

resourceRequest.setQueryParameter("params", "['Washington', 'United States']");

resourceRequest.send().then(
    function(response) {
        var $result = $(response.invocationResult.Envelope.Body.GetWeatherResponse.GetWeatherResult);
		var weatherInfo = {
			location: $result.find('Location').text(),
			time: $result.find('Time').text(),
			wind: $result.find('Wind').text(),
			temperature: $result.find('Temperature').text(),
		};
    },
    function() {
        // ...
    }
)

• 서버 측에서 결과 문자열로 XML 오브젝트를 작성하십시오. 그런 다음 노드는 특성으로 액세스될 수 있습니다.

var xmlDoc = new XML(result.Envelope.Body.GetWeatherResponse.GetWeatherResult);
var weatherInfo = {
	Location: xmlDoc.Location.toString(),
	Time: xmlDoc.Time.toString(),
	Wind: xmlDoc.Wind.toString(),
	Temperature: xmlDoc.Temperature.toString()
};

샘플 어댑터

어댑터 Maven 프로젝트를 다운로드하려면 클릭하십시오.

샘플 사용법

• JavaScriptHTTP 어댑터를 빌드 및 배치하기 위해 Maven, MobileFirst CLI 또는 선택한 IDE를 사용하십시오.
• 어댑터를 테스트하거나 디버깅하려면 어댑터 테스트 및 디버깅 학습서를 참조하십시오.