37.3. 小部件供应商示例

37.3.1. 小部件排序接口

本节展示了 Apache CXF 中用于解决实际应用程序的替换组示例。服务和消费者使用例 37.2 “使用复杂类型替换组” 中定义的小部件替换组开发。该服务提供了两个操作： checkWidgets 和 placeWidgetOrder。例 37.12 “小部件排序接口” 显示排序服务的接口。

例 37.12. 小部件排序接口

<message name="widgetOrder">
  <part name="widgetOrderForm" type="xsd1:widgetOrderInfo"/>
</message>
<message name="widgetOrderBill">
  <part name="widgetOrderConformation"
        type="xsd1:widgetOrderBillInfo"/>
</message>
<message name="widgetMessage">
  <part name="widgetPart" element="xsd1:widget" />
</message>
<message name="numWidgets">
  <part name="numInventory" type="xsd:int" />
</message>
<portType name="orderWidgets">
  <operation name="placeWidgetOrder">
    <input message="tns:widgetOrder" name="order"/>
    <output message="tns:widgetOrderBill" name="bill"/>
  </operation>
  <operation name="checkWidgets">
    <input message="tns:widgetMessage" name="request" />
    <output message="tns:numWidgets" name="response" />
  </operation>
</portType>

例 37.13 “小部件排序 SEI” 显示为接口生成的 Java SEI。

例 37.13. 小部件排序 SEI

@WebService(targetNamespace = "http://widgetVendor.com/widgetOrderForm", name = "orderWidgets")
@XmlSeeAlso({com.widgetvendor.types.widgettypes.ObjectFactory.class})
public interface OrderWidgets {

    @SOAPBinding(parameterStyle = SOAPBinding.ParameterStyle.BARE)
    @WebResult(name = "numInventory", targetNamespace = "", partName = "numInventory")
    @WebMethod
    public int checkWidgets(
        @WebParam(partName = "widgetPart", name = "widget", targetNamespace = "http://widgetVendor.com/types/widgetTypes")
        com.widgetvendor.types.widgettypes.WidgetType widgetPart
    );

    @SOAPBinding(parameterStyle = SOAPBinding.ParameterStyle.BARE)
    @WebResult(name = "widgetOrderConformation", targetNamespace = "", partName = "widgetOrderConformation")
    @WebMethod
    public com.widgetvendor.types.widgettypes.WidgetOrderBillInfo placeWidgetOrder(
        @WebParam(partName = "widgetOrderForm", name = "widgetOrderForm", targetNamespace = "")
        com.widgetvendor.types.widgettypes.WidgetOrderInfo widgetOrderForm
    ) throws BadSize;
}

注意

因为该示例仅显示使用替换组，因此不会显示一些业务逻辑。

37.3.2. checkWidgets Operation

概述

checkWidgets 是一个简单操作，它有一个参数，它是替换组的头成员。此操作演示了如何处理作为替换组成员的单个参数。消费者必须确保该参数是替换组的有效成员。该服务必须正确确定在请求中发送了替换组的成员。

消费者实施

生成的方法签名使用 Java 类，支持替换组的 head 元素的类型。由于替换组的 member 元素与 head 元素或从 head 元素类型派生的类型相同，因此生成的 Java 类支持从生成的 Java 类继承的 Java 类，以支持为支持 head 元素而继承的 Java 类。Java 类型层次结构原生支持使用子类代替父类。

由于 Apache CXF 如何为替换组和 Java 类型层次结构生成类型，客户端可以在不使用任何特殊代码的情况下调用 checkWidgets （）。在开发调用 checkWidgets （） 的逻辑时，您可以传递一个生成的类的对象，以支持小部件替换组。

例 37.14 “consumer Invoking checkWidgets （）” 显示调用 checkWidgets （） 的使用者。

例 37.14. consumer Invoking checkWidgets （）

System.out.println("What type of widgets do you want to order?");
System.out.println("1 - Normal");
System.out.println("2 - Wood");
System.out.println("3 - Plastic");
System.out.println("Selection [1-3]");
String selection = reader.readLine();
String trimmed = selection.trim();
char widgetType = trimmed.charAt(0);
switch (widgetType)
{
  case '1':
  {
    WidgetType widget = new WidgetType();
    ...
    break;
  }
  case '2':
  {
    WoodWidgetType widget = new WoodWidgetType();
    ...
    break;
  }
  case '3':
  {
    PlasticWidgetType widget = new PlasticWidgetType();
    ...
    break;
  }
  default :
    System.out.println("Invaid Widget Selection!!");
}

proxy.checkWidgets(widgets);

服务实现

服务 checkWidgets （） 的实现获得小部件描述，作为 WidgetType 对象，检查小部件清单，并返回库存中的小部件数量。由于用于实施替换组从同一基础类继承的所有类，因此您可以实施 checkWidgets （），而无需使用任何特定于 JAXB 的 API。

生成的所有类都支持为 widget 的替换组成员扩展 WidgetType 类。由于此事实，您可以使用 instanceof 来确定传递的小部件类型，并只需将 widgetPart 对象转换为更严格的类型（如果适用）。正确类型的对象后，您可以检查右侧小部件类型的清单。

例 37.15 “checkWidgets （）的服务实现” 显示了可能的实现。

例 37.15. checkWidgets （）的服务实现

public int checkWidgets(WidgetType widgetPart)
{
  if (widgetPart instanceof WidgetType)
  {
    return checkWidgetInventory(widgetType);
  }
  else if (widgetPart instanceof WoodWidgetType)
  {
    WoodWidgetType widget = (WoodWidgetType)widgetPart;
    return checkWoodWidgetInventory(widget);
  }
  else if (widgetPart instanceof PlasticWidgetType)
  {
    PlasticWidgetType widget = (PlasticWidgetType)widgetPart;
    return checkPlasticWidgetInventory(widget);
  }
}

37.3.3. placeWidgetOrder Operation

概述

placeWidgetOrder 使用两个包含替换组的复杂类型。此操作演示了如何在 Java 实施中使用这样的结构。消费者和服务必须获取和设置替换组的成员。

消费者实施

要调用 placeWidgetOrder （），消费者必须构建包含 widget 替换组的一个元素的小部件顺序。将小部件添加到顺序时，消费者应使用为替换组的每个元素生成的对象工厂方法。这样可确保运行时和服务可以正确处理顺序。例如，如果为 plastic 小部件放置了一个顺序，则 ObjectFactory.createPlasticWidget （） 方法用于在将其添加到顺序之前创建元素。

例 37.16 “设置替换组成员” 显示用于设置 WidgetOrderInfo 对象的 widget 属性的消费者代码。

例 37.16. 设置替换组成员

ObjectFactory of = new ObjectFactory();

WidgetOrderInfo order = new of.createWidgetOrderInfo();
...
System.out.println();
System.out.println("What color widgets do you want to order?");
String color = reader.readLine();
System.out.println();
System.out.println("What shape widgets do you want to order?");
String shape = reader.readLine();
System.out.println();
System.out.println("What type of widgets do you want to order?");
System.out.println("1 - Normal");
System.out.println("2 - Wood");
System.out.println("3 - Plastic");
System.out.println("Selection [1-3]");
String selection = reader.readLine();
String trimmed = selection.trim();
char widgetType = trimmed.charAt(0);
switch (widgetType)
{
  case '1':
  {
    WidgetType widget = of.createWidgetType();
    widget.setColor(color);
    widget.setShape(shape);
    JAXB<WidgetType> widgetElement = of.createWidget(widget); order.setWidget(widgetElement);
    break;
  }
  case '2':
  {
    WoodWidgetType woodWidget = of.createWoodWidgetType();
    woodWidget.setColor(color);
    woodWidget.setShape(shape);
    System.out.println();
    System.out.println("What type of wood are your widgets?");
    String wood = reader.readLine();
    woodWidget.setWoodType(wood);
    JAXB<WoodWidgetType> widgetElement = of.createWoodWidget(woodWidget); order.setWoodWidget(widgetElement);
    break;
  }
  case '3':
  {
    PlasticWidgetType plasticWidget = of.createPlasticWidgetType();
    plasticWidget.setColor(color);
    plasticWidget.setShape(shape);
    System.out.println();
    System.out.println("What type of mold to use for your
                        widgets?");
    String mold = reader.readLine();
    plasticWidget.setMoldProcess(mold);
    JAXB<WidgetType> widgetElement = of.createPlasticWidget(plasticWidget); order.setPlasticWidget(widgetElement);
    break;
  }
  default :
    System.out.println("Invaid Widget Selection!!");
    }

服务实现

placeWidgetOrder （） 方法以 WidgetOrderInfo 对象的形式收到一个顺序，处理顺序，并以 WidgetOrderBillInfo 对象的形式向消费者返回 bill。顺序可以是普通小部件、plastic widget 或 wooden 小部件。排序的小部件类型由将哪些类型的对象存储在 widget OrderForm 对象的小部件属性中。widget 属性是一个替换组，可以包含 widget 元素、woodWidget 元素或 plasticWidget 元素。

该实施必须确定按顺序存储哪些元素。这可以通过 JAXBElement<? extends T&gt; 对象的 getName （） 方法来实现，以确定元素的 QName。然后，可以使用 QName 来确定替换组中的哪个元素是按顺序的。当已知包含的元素后，您可以将其值提取到正确的对象类型。

例 37.17 “实现 placeWidgetOrder （）” 显示了可能的实现。

例 37.17. 实现 placeWidgetOrder （）

public com.widgetvendor.types.widgettypes.WidgetOrderBillInfo placeWidgetOrder(WidgetOrderInfo widgetOrderForm)
{
  ObjectFactory of = new ObjectFactory();

  WidgetOrderBillInfo bill = new WidgetOrderBillInfo()

   // Copy the shipping address and the number of widgets
   // ordered from widgetOrderForm to bill
   ...

  int numOrdered = widgetOrderForm.getAmount();

  String elementName = widgetOrderForm.getWidget().getName().getLocalPart();
  if (elementName.equals("woodWidget")
  {
    WoodWidgetType widget=order.getWidget().getValue();
    buildWoodWidget(widget, numOrdered);

    // Add the widget info to bill
    JAXBElement<WoodWidgetType> widgetElement = of.createWoodWidget(widget);
    bill.setWidget(widgetElement);

    float amtDue = numOrdered * 0.75;
    bill.setAmountDue(amtDue);
  }
  else if (elementName.equals("plasticWidget")
  {
    PlasticWidgetType widget=order.getWidget().getValue();
    buildPlasticWidget(widget, numOrdered);

    // Add the widget info to bill
    JAXBElement<PlasticWidgetType> widgetElement = of.createPlasticWidget(widget);
    bill.setWidget(widgetElement);

    float amtDue = numOrdered * 0.90;
    bill.setAmountDue(amtDue);
  }
  else
  {
    WidgetType widget=order.getWidget().getValue();
    buildWidget(widget, numOrdered);

    // Add the widget info to bill
    JAXBElement<WidgetType> widgetElement = of.createWidget(widget);
    bill.setWidget(widgetElement);

    float amtDue = numOrdered * 0.30;
    bill.setAmountDue(amtDue);
  }

  return(bill);
}

例 37.17 “实现 placeWidgetOrder （）” 中的代码执行以下操作：

实例化对象工厂以创建元素。

实例化 WidgetOrderBillInfo 对象来容纳 bill。

获取排序的小部件数量。

获取以顺序存储元素的本地名称。

检查该元素是否为 woodWidget 元素。

将元素的值从顺序提取到正确类型的对象。

创建一个位于 bill 中的 JAXBElement<T > 对象。

设置 bill 对象 的小部件 属性。

设置 bill 对象的 amountDue 属性。

37.3. 小部件供应商示例

37.3.1. 小部件排序接口

37.3.2. checkWidgets Operation

概述

消费者实施

服务实现

37.3.3. placeWidgetOrder Operation

概述

消费者实施

服务实现

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Red Hat legal and privacy links

Red Hat legal and privacy links