정책 구성 사용

<AssignMessage name="GenerateGeocodingRequest">
  <AssignTo createNew="true" type="request">GeocodingRequest</AssignTo>
  <Set>
    <QueryParams>
      <QueryParam name="address">{request.queryparam.postalcode}</QueryParam>
      <QueryParam name="region">{request.queryparam.country}</QueryParam>
      <QueryParam name="sensor">false</QueryParam>
    </QueryParams>
    <Verb>GET</Verb>
  </Set>
  <!-- Set variables for use in the final response -->
  <AssignVariable>
    <Name>PostalCode</Name>
    <Ref>request.queryparam.postalcode</Ref>
  </AssignVariable>
  <AssignVariable>
    <Name>Country</Name>
    <Ref>request.queryparam.country</Ref>
  </AssignVariable>
</AssignMessage>

다음은 이 정책의 요소에 대한 간략한 설명입니다. 자세한 내용은 할당 메일 정책.

• <AssignMessage name> - 정책에 이름을 지정합니다. 이름은 흐름에서 정책이 참조될 때 사용됩니다.
• &lt;AssignTo&gt; - GeocodingRequest라는 이름이 지정된 변수를 만듭니다. 이 변수는 Service콜아웃 정책.
• &lt;QueryParams&gt; - 쿼리 매개변수에서 백엔드 API 호출 이 경우 Geocoding API는 우편번호, 국가 ID로 표현됩니다. 앱 사용자가 이 정보를 제공합니다. 여기에 추출해 보겠습니다. sensor 매개변수는 API에 필요하며 true 또는 false이며 여기서는 false로 하드코딩합니다.
• &lt;Verb&gt; - 이 경우 API에 액세스할 수 있습니다.
• &lt;AssignVariable&gt; - 이 변수는 현재 값을 저장합니다. API에 전달됩니다 이 예에서는 나중에 응답에서 변수에 액세스합니다. 클라이언트로 반환됩니다.

Service콜아웃을 사용하여 요청 전송

정책 구성 시퀀스의 다음 단계는 ServiceCallout 정책을 만드는 것입니다. 이 아래에 나와 있는 Service콜아웃 정책은 이전AssignMessage 정책을 Google 지오코딩 서비스에 추가하고 결과를 GeocodingResponse라는 변수가 추가되었습니다.

<ServiceCallout name="ExecuteGeocodingRequest">
  <Request variable="GeocodingRequest"/>
  <Response>GeocodingResponse</Response>
  <HTTPTargetConnection>
    <URL>http://maps.googleapis.com/maps/api/geocode/json</URL>
  </HTTPTargetConnection>
</ServiceCallout>

다음은 이 정책의 요소에 대한 간략한 설명입니다.

• &lt;ServiceCallout&gt; - 이전 정책과 마찬가지로 이 정책에는 있습니다.
• <Request 변수> - 이 변수가 할당 메시지 정책 백엔드 API로 전달되는 요청을 캡슐화합니다.
• &lt;Response&gt; - 이 요소는 응답의 응답을 나타내는 변수의 이름을 지정합니다. 확인할 수 있습니다 보시다시피 나중에 ExtractVariables에서 이 변수에 액세스합니다. 정책
• &lt;HTTPTargetConnection&gt; - 백엔드의 대상 URL을 지정합니다. API에 액세스할 수 있습니다. 이 경우 API가 JSON 응답을 반환하도록 지정합니다.

이제 두 가지 정책이 있습니다. 하나는 백엔드 API (Google의 Geocoding API), 그리고 실제로 요청을 백엔드 API입니다 다음으로 응답을 처리합니다.

<ExtractVariables name="ParseGeocodingResponse">
  <Source>GeocodingResponse</Source>
  <VariablePrefix>geocoderesponse</VariablePrefix>
  <JSONPayload>
    <Variable name="latitude">
       <JSONPath>$.results[0].geometry.location.lat</JSONPath>
    </Variable>
    <Variable name="longitude">
       <JSONPath>$.results[0].geometry.location.lng</JSONPath>
    </Variable>
  </JSONPayload>
</ExtractVariables>

ExtractVariable 정책의 핵심 요소는 다음과 같습니다.

• <ExtractVariables name> - 정책 이름은 정책을 참조할 수 있습니다
• &lt;Source&gt; - 앞서 만든 응답 변수를 지정합니다. Service콜아웃 정책 이 정책이 데이터를 추출하는 변수입니다.
• &lt;VariablePrefix&gt; - 변수 접두사는 이 정책에서 생성된 다른 변수입니다. 프리픽스는 예약된 이름을 제외한 모든 이름이 될 수 있습니다. Edge의 사전 정의된 변수입니다.
• &lt;JSONPayload&gt; - 이 요소는 명명된 변수에 저장합니다. 실제로 Geocoding API는 위도와 경도보다 더 많은 정보를 제공합니다. 하지만 이것들이 확인할 수 있습니다 Geocoding API에서 반환한 JSON의 전체 렌더링을 확인할 수 있습니다. API의 문서를 참조하세요. metric.location.lat 및 metric.location.lng 값은 단순히 두 개의 JSON 객체를 반환합니다.

명확하지 않을 수도 있지만 ExtractVariables가 두 개의 이름이 변수 접두사 (지오코드 응답) 및 실제 정책에서 지정된 변수 이름입니다. 이러한 변수는 API 프록시에 액세스하고 프록시 흐름 내의 다른 정책에서 사용할 수 있습니다. 볼 수 있습니다 변수는 다음과 같습니다.

• geocoderesponse.latitude
• geocoderesponse.longitude

이제 대부분의 작업이 완료되었습니다. Google은 AI 원칙 2가지를 구성하는 세 가지 정책을 백엔드 API를 호출하고 반환된 JSON 데이터를 파싱합니다. 마지막 단계에서는 흐름의 이 부분에서 다른AssignMessage 정책으로 데이터를 가져오려면 두 번째 백엔드를 호출합니다. API (Google Elevation API)를 통해 매시업된 데이터를 앱 개발자에게 반환할 수 있습니다.

<AssignMessage name="AssignElevationParameters">
<Remove>
    <QueryParams>
      <QueryParam name="country"/>
      <QueryParam name="postalcode"/>
    </QueryParams>
  </Remove>
  <Set>
    <QueryParams>
      <QueryParam name="locations">{geocoderesponse.latitude},{geocoderesponse.longitude}</QueryParam>
      <QueryParam name="sensor">false</QueryParam>
    </QueryParams>
  </Set>
</AssignMessage>

Google Elevation API를 검사하면 두 개의 쿼리 매개변수가 필요하다는 것을 알 수 있습니다. 첫 번째는 locations라고 하며 값은 위도와 경도입니다. (쉼표로 구분된 값). 다른 매개변수는 sensor입니다. 이는 필수 항목이며 true 또는 false입니다. 이 시점에서 가장 중요한 점은 요청이 메시지에는 Service콜아웃이 필요하지 않습니다. 두 번째 포드는 API를 사용할 수 있습니다. 프록시의 콜백에서 백엔드 API를 호출할 수 있기 때문입니다. TargetEndpoint를 반환합니다. 생각해보면 Google Elevations라고 부르는 데 필요한 모든 데이터가 있습니다. API 기본 요청 파이프라인에 대해 생성되므로 ProxyEndpoint를 TargetEndpoint로 연결합니다. 이 API 프록시에 구성된 RouteRule을 따릅니다. TargetEndpoint는 원격 API와의 연결을 관리합니다. ( Elevation API는 TargetEndpoint의 HTTPConnection에 정의됩니다. 고도 API 문서를 참조하세요. 이전에 저장한 QueryParams는 country 및 postalcode이(가) 더 이상 필요하지 않으므로 삭제됩니다. 여기에서 확인하세요.

짧은 일시중지: 과정으로 돌아가기

이 시점에서 또 다른 Service콜아웃 정책을 만들지 않은 이유가 궁금할 수 있습니다. 후(After) 또 다른 메시지를 만들었죠. 해당 메시지가 표적, 즉 Google Elevation API? 답은 <RouteRule>에 있습니다. 요소가 없습니다. &lt;RouteRule&gt; <Request> 일부 확인할 수 있습니다 이 <RouteRule>으로 지정된 TargetEndpoint입니다. 는 메시지를 전송하기 위한 API 프록시 http://maps.googleapis.com/maps/api/elevation/xml님에게 전송됩니다.

샘플 API 프록시를 다운로드한 경우 이 파일에서 TargetProxy XML을 찾을 수 있습니다. doc-samples/policy-mashup-cookbook/apiproxy/targets/default.xml

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <!-- This is where we define the target. For this sample we just use a simple URL. -->
    <URL>http://maps.googleapis.com/maps/api/elevation/xml</URL>
  </HTTPTargetConnection>
</TargetEndpoint>

이제 Google Elevation API의 응답을 처리하기만 하면 완료되었습니다.

$ curl "http://{myorg}-test.apigee.net/policy-mashup-cookbook?country=us&postalcode=08008"

응답에는 앱 최종 사용자의 값을 해당 지오코딩된 위치의 고도와 결합합니다. 데이터는 2개의 백엔드 API에서 검색되고 API 프록시에 연결된 정책과 매시업됩니다. 클라이언트에게 반환됩니다.

{  
   "country":"us",
   "postalcode":"08008",
   "elevation":{  
      "meters":0.5045232,
      "feet":1.6552599030345978
   },
   "location":{  
      "latitude":39.75007129999999,
      "longitude":-74.1357407
   }
}

요약

이 설명서 주제에서는 정책 구성 패턴을 사용하여 매시업을 만드는 방법을 설명했습니다. 여러 백엔드 소스의 데이터 수집을 지원합니다 정책 구성은 API에서 사용되는 일반적인 패턴 API에 광고 소재 기능을 추가하기 위한 프록시 개발입니다.