Creating a new proxy service configuration

您可以將 Web 服務閘道設成純粹是服務的 Proxy,然後利用 JAX-RPC 處理程式清單來設定服務的送入要求訊息端點。

Before you begin

如需在具有匯流排功能之 Web 服務的整體配置中,如何配置 Web 服務閘道的高階作業視圖,請參閱Enabling web services through the service integration bus

You configure each proxy service for a specific gateway instance, so you must create the gateway instance before you can configure any proxy services for it.

決定要用哪個方法來配置這些資源。 You can create a new proxy service by using the administrative console as described in this task, or by using the createWSGWProxyService command.

About this task

當您建立新的 Proxy 服務配置時,除了呼叫這個服務之外,閘道不會採取任何動作。 當您配置 Proxy 服務時,您也會配置一份利用 javax.xml.rpc.service.endpoint.address 來設定服務目標端點的 JAX-RPC 處理程式清單。 然後您再將處理程式清單附加到 Proxy 服務的入埠連接埠。

Proxy 服務配置沒有實際的目標服務,因此,閘道無法利用任何 WSDL 來配置服務呼叫。 呼叫的基本參數是以通用的 Proxy WSDL 檔來配置的(比方說,要用哪個連結),不過,您也可以將預設值,換成自己的對等通用 Proxy WSDL 檔。 如果沒有部署 JAX-RPC 處理程式清單,閘道會嘗試將所有要求傳送到 Proxy WSDL 檔的 <soap:target address> 標籤所指定的假網址。

For more detailed information, see JAX-RPC handlers and proxy operation.

To create a new proxy service configuration by using the administrative console, complete the following steps:

Procedure

  1. Create a JAX-RPC handler that uses the javax.xml.rpc.service.endpoint.address to set the target endpoint for the service. It is up to you to decide how you want to establish the target endpoint, and to create and configure the javax.xml.rpc.service.endpoint.address JAX-RPC handler.
  2. Create a new JAX-RPC handler configuration for the handler that sets the target endpoint for this service.
  3. Create a new JAX-RPC handler list, select the handler that sets the target endpoint for this service and add it to the handler list.
  4. Start the administrative console.
  5. In the navigation pane, click 服務整合 -> 匯流排 -> bus_name -> [其他內容] Web 服務閘道實例 -> instance_name -> Proxy 服務. The proxy services collection form is displayed.
  6. Click New. The New proxy service wizard is displayed.
  7. Use the wizard to create the new proxy service configuration by completing the following steps. For more information about the properties that you set with the wizard, see Proxy services settings.
    1. Specify the proxy service name, proxy port point, service destinations and mediations.
      Note:
      • Choose a proxy service name that is unique across all gateway and proxy services within the current gateway instance. If you enter a name that is not unique, an error message is displayed.
      • The proxy port point is the point at which the proxy port destination is to be located.
      • You need not provide proxy destination names. If you leave either of these fields blank, a default name is generated for you when the wizard completes its operation. The default names are not displayed in the panel. They are constructed as follows:
        • The request destination name is the same as the proxy service name. For example: myProxyService.
        • The reply destination name is the same as the request destination name, followed by "Reply". For example: myProxyServiceReply.
      • The lists of available mediations contain all mediations that are currently deployed to this service integration bus. If you have created a mediation and deployed it to the bus, then it is available for selection in both these lists. If you do not want to use a mediation with this proxy service, select none from either or both selection lists.
      • Bus members are application servers or clusters that are added to this bus. The Request mediation bus member and the Response mediation bus member properties define the bus members to which the corresponding mediation is assigned. If you select a mediation, then you must assign it to a bus member; If you set the Request mediation or the Response mediation property value to (none), you must also change the corresponding bus member property value to (none).

        If you do not do this, the administrative console displays an error message.

      • A generic proxy WSDL file is used to configure the basic parameters for the invocation call (for example which binding to use), but you can override the default by typing the location of your replacement generic WSDL file in the Proxy WSDL override URL field.
    2. Select endpoint listeners for the inbound configuration of this proxy service.
  8. Click Finish.

Results

If the processing completes successfully, the list of proxy services for this gateway instance is updated to include the new proxy service. Otherwise, an error message is displayed.

What to do next

請確定所有服務要求者都在 Proxy 服務的位址中,附加了 operationMode 查詢字串參數。這個參數值是 onewayrequestResponse,預設值是 requestResponse。 例如:
  • 對於 HTTP 作業,如果 Proxy 服務的網址是
    http://host_name:port_number/wsgwsoaphttp1/soaphttpengine
    /your_bus/ProxyService/ProxyServiceInboundPort
    發出要求的用戶端就會利用下列 URL 來指示它們是在傳送單向要求:
    http://host_name:port_number/wsgwsoaphttp1/soaphttpengine
    /your_bus/ProxyService/ProxyServiceInboundPort?operationMode=oneway
  • 對於 JMS 作業,如果 Proxy 服務的 JMS 位址是
    jms:/queue?destination=jndi_queue&connectionFactory=
    jndi_factory&targetService=your_bus/ProxyService/ProxyServiceInboundPort
    發出要求的用戶端就會利用下列 URL 來指示它們是在傳送單向要求:
    jms:/queue?destination=jndi_queue&connectionFactory=
    jndi_factory&targetService=
    your_bus/ProxyService/ProxyServiceInboundPort&operationMode=oneway

指出主題類型的圖示 作業主題



時間戳記圖示 前次更新: July 9, 2016 11:18
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twsg_proxy_new
檔名:twsg_proxy_new.html