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 项目。

样本用法

• 使用 Maven、MobileFirst CLI 或您所选的 IDE 来构建和部署 JavaScriptHTTP 适配器。
• 要测试或调试适配器，请参阅测试和调试适配器教程。