Советы и подсказки по Web-сервисам: JAX-RPC против JAX-WS, часть 2

Опции документа Опции документа, требующие включения JavaScript, не отображаются Обсудить Выскажите мнение об этой странице Помогите нам улучшить содержание

Уровень сложности: средний

Рассел Бутек, cпециалист по информационным технологиям, IBM
Николас Галлардо, штатный инженер по ПО, IBM

24.07.2007

В спецификации JAX-WS 2.0, выросшей из JAX-RPC 1.1, методы сопоставления данных получили дальнейшее развитие благодаря использованию JAXB, технологии на базе JCP. Эта статья посвящена сопоставлению данных между этими двумя спецификациями Web-сервисов.

Введение

В то время как некоторые аспекты JAX-WS 2.0 в JAX-RPC 1.1 просто претерпели эволюцию, другие изменились самым революционным образом. Например, JAX-WS не поддерживает сопоставление данных между XML schema и Java, что является главной функцией в JAX-RPC 1.1. Вместо этого в JAX-WS для такого сопоставления используется другая JCP-технология, JAXB 2.0 (Java Architecture for XML Binding, Java-архитектура для описания привязки для XML-данных) . JAX-WS просто представляет модель вызова для Web-сервисов. Данную спецификацию больше не интересуют bean-компоненты Java, представляющие данные приложения; она концентрируется только на поставке этих данных Web-сервису назначения. В этой статье мы сравниваем сопоставления в JAX-RPC 1.1 и JAXB 2.0.

В начало

Сопоставления XML schema - Java

JAX-RPC и JAXB Почему с самого начала JAX-RPC не использует JAXB? Ответ кроется в расхождении данных разработок во времени. Первая версия JAX-RPC была закончена раньше JAXB, поэтому разработчики JAX-RPC решили не ждать и разработали свою функцию сопоставления имен.

Методы сопоставления имен XML именам Java в JAX-RPC и JAX-WS/JAXB в основном аналогичны, хотя сопоставление примитивных типов в них слегка отличается. В таблице 1 перечислены эти различия; они могут показаться существенными; однако, если не считать типов для даты/времени, это наименее используемые примитивные типы данных XML.

Аспекты "pure Java" для сопоставлений примитивных типов данных почти не отличаются в JAX-RPC и JAXB, но сопоставления в JAXB, помимо этого, используют новую функцию аннотаций Java. В листингах с 1 по 3 приводится несколько примеров сопоставлений примитивных типов данных.

                  
  <xsd:sequence>
    <xsd:element name="intField" type="xsd:int"/>
    <xsd:element name="intMinField" type="xsd:int" minOccurs="0"/>
    <xsd:element name="intNilField" type="xsd:int" nillable="true"/>
    <xsd:element name="stringField" type="xsd:string"/>
    <xsd:element name="stringMinField" type="xsd:string" minOccurs="0"/>
    <xsd:element name="stringNilField" type="xsd:string" nillable="true"/>
  </xsd:sequence>
  <xsd:attribute name="intAttr" type="xsd:int"/>
  <xsd:attribute name="intAttrReq" type="xsd:int" use="required"/>

                    
	private int intField;
    private Integer intMinField;
    private Integer intNilField;
    private String stringField;
    private String stringMinField;
    private String stringNilField;
    private Integer intAtt;
    private int intAttReq;

                    
  protected int intField;
  protected Integer intMinField;

    @XmlElement(required = true, type = Integer.class, nillable = true)
    protected Integer intNilField;

    @XmlElement(required = true)
    protected String stringField;

    protected String stringMinField;

    @XmlElement(required = true, nillable = true)
    protected String stringNilField;

    @XmlAttribute
    protected Integer intAtt;

    @XmlAttribute(required = true)
    protected int intAttReq;

В bean-компоненте, сгенерированном в JAX-RPC 1.1, вы не сможете определить разницу между:

• Полем элемента и полем атрибута;
• Полем, преобразованным в результате сопоставления из minOccurs="0" type="xsd:int", и полем, преобразованным из nillable="true" type="xsd:int";
• Полями, преобразованными в результате сопоставления из type="xsd:string" и type="xsd:string" minOccurs="0".

Но теперь это можно сделать благодаря тому, что JAXB использует новые аннотации Java. Аннотации @XmlElement и @XmlAttribute имеют несколько параметров. Ниже перечислены те из них, которые имеют отношение к теме данной статьи:

• Required: Должен ли существовать этот элемент? Например, может ли minOccurs принимать другие значения помимо 1?
• Nillable: Содержит ли поле атрибут nillable="true"?

Сопоставление массивов

Сопоставление массивов XML в Java в моделях JAX-RPC и JAXB различно, потому что JAXB использует новую родовую функцию Java, как показано в листингах 4-6.

                    
  <xsd:element name="intArrayField" type="xsd:int" minOccurs="0" maxOccurs="unbounded"/>

                    
  private int[] intArrayField;
    public int[] getIntArrayField() {..}
    public void setIntArrayField(int[] intArrayField) {..}
    public int getIntArrayField(int i) {..}
    public void setIntArrayField(int i, int value) {..}

                    
  @XmlElement(type = Integer.class)
    protected List<Integer> intArrayField;
    public List<Integer> getIntArrayField() {..}

Обратите внимание на различия в методах доступа. Сопоставление в JAX-RPC следует строгому определению методов доступа к массиву bean-компонента Java. Сопоставление в JAXB не отображает данные в массив, поэтому оно несколько отличается. Метод getIntArrayField возвращает в активный список не только моментальный снимок, но и ссылку. Следовательно, любое изменение, которое вы внесете в возвращаемый список, будет представлено в рамках свойства. Именно поэтому для свойств массива не существует метод set.

Отображение составных типов

Сопоставление complexType почти не отличается в JAX-RPC и JAXB, за исключением полей с атрибутом " private" в JAX-RPC и "protected" в JAXB, а сопоставление JAXB добавляет аннотации, описывающие порядок сортировки в поле. В листингах 7-9 приведены пример и сравнение этих двух сопоставлений.

                  
  <xsd:element name="Phone" type="tns:Phone"/>
  <xsd:complexType name="Phone">
    <xsd:sequence>
      <xsd:element name="areaCode" type="xsd:string"/>
      <xsd:element name="exchange" type="xsd:string"/>
      <xsd:element name="number" type="xsd:string"/>
    </xsd:sequence>
  </xsd:complexType>

                
  public class Phone {
    private String areaCode;
    private String exchange;
    private String number;

    ..
}

                
  @XmlType(name = "Phone", propOrder = {
    "areaCode",
    "exchange",
    "number"
})
public class Phone {

    @XmlElement(required = true)
    protected String areaCode;
    @XmlElement(required = true)
    protected String exchange;
    @XmlElement(required = true)
    protected String number;

    ..
}

Обратите внимание на то, что в схеме из листинга 7 используется xsd:sequence. Если бы вместо этого стояло xsd:all, то комментарий propOrder был бы пустым: @XmlType(name = "Phone", propOrder = {}).

Новый класс ObjectFactory

JAXB генерирует один файл, который отсутствует в JAX-RPC: ObjectFactory. Каждый каталог, содержащий bean-компоненты Java, будет включать один файл ObjectFactory. Для каждого типа, определенного в пространстве имен, соответствующем данной схеме, класс ObjectFactory будет иметь метод create. Для каждого элемента класс ObjectFactory будет иметь метод create element, возвращающий экземпляр javax.xml.bind.JAXBElement<Type>. Например, в листинге 10 показан класс ObjectFactory, сгенерированный для схемы Phone из листинга 7 с методом, возвращающим экземпляр Phone, и методом, возвращающим экземпляр JAXBElement<Phone>. По-прежнему допускается создание экземпляров bean-компонентов в этом каталоге, но лучше воспользоваться фабрикой.

                
import javax.xml.bind.JAXBElement;
import javax.xml.bind.annotation.XmlElementDecl;
import javax.xml.namespace.QName;

public class ObjectFactory {

    private final static QName _Phone_QNAME = new QName
    ("urn:types.MyServiceSample.ibm.com", "Phone");

    public ObjectFactory() {..}

    public Phone createPhone() {..}

    @XmlElementDecl(namespace = "urn:types.MyServiceSample.ibm.com", name = "Phone")
    public JAXBElement<Phone> createPhone(Phone value) {..}
}

В начало

Сопоставления Java - XML schema

Благодаря рациональной вставке описанных выше новых определенных в JAXB-аннотаций, можно точно сопоставить Java и XML, особенно в направлении, обратном сопоставлению XML-Java, о котором мы говорили. А как быть с Java без аннотаций?

Сопоставления имен в Java именам в XML по спецификациям JAX-RPC и JAXB, в основном, аналогичны. То есть, примитивные типы Java сопоставляются таким же типам XML schema, независимо от того, используется ли сопоставление по модели JAX-RPC или по модели JAXB. Спецификация JAX-RPC определяет небольшой набор стандартных классов Java, сопоставляемых XML. Сопоставления всех классов, кроме одного, в JAXB практически одинаково, но при этом JAXB добавляет еще несколько сопоставимых классов, как показано в таблице 2.

Примечания к таблице 2:
1. Некоторые производители сопоставляют класс java.lang.Object классу xsd:anyType.
2. В JAX-RPC этот класс сопоставляется типу mime binding - тип XML не определен.

В начало

Заключение

Мы сравнили сопоставления в JAX-RPC 1.1 и JAXB 2.0. В целом, они аналогичны, за небольшими исключениями:

• XML - Java:
• Есть отличия в сопоставлении небольшой части примитивных типов;
• В JAXB добавлен класс ObjectFactory;
• В JAXB используются новая функция аннотирования и новая родовая функция языка Java.
• Java - XML:
• Сопоставления примитивных типов идентичны;
• Сопоставления стандартных классов Java почти идентичны.

Мы можем рассказать о спецификации JAXB 2.0 гораздо больше, особенно об использовании в ней аннотаций Java, но эта тема в данной статье не рассматривается. Дополнительную информацию о JAXB 2.0 можно найти в разделе Ресурсы.

Ресурсы

• Примите участие в обсуждении материала на форуме.
  
  
• Оригинал статьи: Web services hints and tips: JAX-RPC vs. JAX-WS, Part 2;
  
  
• Ищите в магазине технической книги книги по этой и другим техническим темам;
  
  
• Спецификации, классы API и документация Javadocs по JAX-RPC 1.1;
  
  
• Спецификации, классы API и документация Javadocs по JAX-WS 2.0;
  
  
• Спецификации, классы API и документация Javadocs по JAXB 2.0;
  
  
• Узнайте обо всех новых функциях и особенностях Java 5;
  
  
• Спецификация WSDL 1.1;
  
  
• Учебник для начинающих по SOAP версии 1.2.;
  
  
• Мы предлагаем приступить к оценке функций JAX-WS в альфа-версии в пакете дополнений для работы с Web-сервисами IBM WebSphere Application Server Version 6.1 Feature Pack for Web Services;
  
  
• Web-сайт WS-I.

Об авторах

		Рассел Бутек (Russell Butek) - консультант IBM по SOA и Web-сервисам. Он является одним из разработчиков механизма Web-сервисов WebSphere IBM. Кроме того, Рассел - член группы экспертов по JAX-RPC Java Specification Request (JSR). Его пригласили для работы над механизмом AXIS SOAP для Apache с целью приведения AXIS 1.0 в соответствие с JAX-RPC.

		Ник Галлардо (Nick Gallardo) работает инженером по программному обеспечению на базе платформы IBM WebSphere и занимается различными аспектами поддержки веб-служб. Его предыдущая работа в IBM включала другие виды заданий на платформах WebSphere и Tivoli. Ник пришел в IBM в 2001 году после работы над усовершенствованием двух различных технологий запуска в Остине, штат Техас.

Выскажите мнение об этой странице

Пожалуйста, найдите минутку и заполните форму, чтобы повысить уровень сервиса. Помогла ли данная информация достичь Вашей цели? Да Нет Не знаю   Пожалуйста, напишите комментарий, чтобы мы могли улучшить данную страницу:   Насколько полезна эта информация? (1 = Бесполезна, 5 = Очень полезна) 1 2 3 4 5

В начало