Spring MVC с JAXB, ответ списка на основе универсального класса

Один из способов, которым это может произойти в Spring, — это если у вас неправильно настроен маршаллер. Возьмем, к примеру, этот автономный:

Тестовое приложение:

public class TestApplication {
    public static void main(String[] args) throws Exception {
        AbstractApplicationContext context
                = new AnnotationConfigApplicationContext(AppConfig.class);

        Marshaller marshaller = context.getBean(Marshaller.class);
        GenericWrapper<Person> personListWrapper = new GenericWrapper<>();
        Person person = new Person();
        person.setId(1);
        personListWrapper.getItems().add(person);
        marshaller.marshal(personListWrapper, new StreamResult(System.out) );
        context.close();
    }
} 

AppConfig (обратите внимание на setClassesToBeBound)

@Configuration
public class AppConfig {
    @Bean
    public Jaxb2Marshaller marshaller() {
        Jaxb2Marshaller marshaller = new Jaxb2Marshaller();
        marshaller.setClassesToBeBound(GenericWrapper.class);
        Map<String, Object> props = new HashMap<>();
        props.put(Marshaller.JAXB_FORMATTED_OUTPUT, true);
        marshaller.setMarshallerProperties(props);
        return marshaller;
    }
}

Домен

@XmlRootElement
public class Person {

    protected Integer id;

    @XmlElement
    public Integer getId() { return id; }
    public void setId(Integer id) { this.id = id; }
}
@XmlRootElement
public class GenericWrapper<T> {

    protected List<T> items;

    public GenericWrapper() {}
    public GenericWrapper(List<T> items) {
        this.items = items;
    }

    @XmlElement(name = "item")
    public List<T> getItems() {
        if (items == null) {
            items = new ArrayList<>();
        }
        return items;
    }
}

В результате запуска вышеуказанного приложения его не удастся маршалировать по той же причине исключения.

Caused by: javax.xml.bind.JAXBException: class com.stackoverflow.Person nor any of its super class is known to this context.

Причина, если вы посмотрите на AppConfig, заключается в методе setClassesToBeBound. Он включает только класс GenericWrapper. Так почему это проблема?

Давайте посмотрим на JAXB под капотом:

Мы взаимодействуем с JAXB через файл JAXBContext. Обычно можно просто создать контекст с элементом верхнего уровня, например

JAXBContext context = JAXBContext.newInstance(GenericWrapper.class);

JAXB вытянет в контекст все классы, связанные с классом. Вот почему List<Person> работает. Person.class явно связан.

Но в случае с GenericWrapper<T> класс Person нигде не связан с GenericWrapper. Но если мы явно поместим класс Person в контекст, он будет найден, и мы сможем использовать дженерики.

JAXBContext context 
                = JAXBContext.newInstance(GenericWrapper.class, Person.class);

При этом под капотом Jaxb2Marshaller используется тот же контекст. Возвращаясь к AppConfig, вы можете увидеть marshaller.setClassesToBeBound(GenericWrapper.class);, который в конечном итоге совпадает с первым созданием JAXBContext выше. Если мы добавим Person.class, то получим ту же конфигурацию, что и второе творение JAXBContext.

marshaller.setClassesToBeBound(GenericWrapper.class, Person.class);

Теперь снова запустите тестовое приложение, и оно получит желаемый результат.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<genericWrapper>
    <item>
        <id>1</id>
    </item>
</genericWrapper>

Все сказанное...

Я не знаю, как вы настроили свою конфигурацию marshaller, и есть ли у фреймворка настройки по умолчанию. Но вам нужно заполучить маршаллер и настроить его для поиска классов одним из трех способов:

• packagesToScan.
• contextPath
• или classesToBeBound (как я сделал выше)

Это можно сделать с помощью конфигурации Java или конфигурации xml.

• Подробнее см. на Spring- Справочная документация JAXB

ОБНОВЛЕНИЕ (с использованием веб-сайта Spring)

Таким образом, кажется, что в веб-среде Spring, если вы не укажете конвертер сообщений http, Spring будет использовать Jaxb2RootElemenHttpMessageConverter и просто используйте возвращаемый тип в качестве корневого элемента для контекста. Не проверял, что происходит под капотом (в исходниках), но предполагаю, что проблема кроется где-то в том, что я описал выше, где Person.class не втягивается в контекст.

Что вы можете сделать, так это указать свой собственный MarshallingHttpMessageConverter в контексте сервлета. Чтобы заставить его работать (с конфигурацией xml), это то, что я добавил

<annotation-driven>
    <message-converters>
        <beans:bean class="org.springframework.http.converter.xml.MarshallingHttpMessageConverter">
            <beans:property name="marshaller" ref="jaxbMarshaller"/>
            <beans:property name="unmarshaller" ref="jaxbMarshaller"/>
        </beans:bean>
    </message-converters>
</annotation-driven>

<beans:bean id="jaxbMarshaller" class="org.springframework.oxm.jaxb.Jaxb2Marshaller">
    <beans:property name="classesToBeBound">
        <beans:list>
            <beans:value>com.stackoverflow.jaxb.domain.JaxbGenericList</beans:value>
            <beans:value>com.stackoverflow.jaxb.domain.Person</beans:value>
        </beans:list>
    </beans:property>
</beans:bean>

Вы можете добиться того же с конфигурацией Java, как показано в @EnableWebMcv API, в котором вы расширяете WebMvcConfigurerAdapter и переопределяете configureMessageConverters, а также добавляете туда преобразователь сообщений. Что-то вроде:

@Configuration
@EnableWebMvc
public class WebConfig extends WebMvcConfigurerAdapter {

    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
            converters.add(marshallingMessageConverter());
    }

    @Bean
    public MarshallingHttpMessageConverter marshallingMessageConverter() {
        MarshallingHttpMessageConverter converter = new MarshallingHttpMessageConverter();
        converter.setMarshaller(jaxbMarshaller());
        converter.setUnmarshaller(jaxbMarshaller());
        return converter;
    }

    @Bean 
    public Jaxb2Marshaller jaxbMarshaller() {
        Jaxb2Marshaller marshaller = new Jaxb2Marshaller();
        marshaller.setClassesToBeBound(JaxbGenericList.class, Person.class);
        Map<String, Object> props = new HashMap<>();
        props.put(javax.xml.bind.Marshaller.JAXB_FORMATTED_OUTPUT, true);
        marshaller.setMarshallerProperties(props);
        return marshaller;
    }
}

Используя аналогичный метод контроллера:

@Controller
public class TestController {

    @RequestMapping(value = "/people", 
                    method = RequestMethod.GET, 
                    produces = MediaType.APPLICATION_XML_VALUE)
    @ResponseBody
    public JaxbGenericList<Person> getXMLPersonsGeneric() {
        JaxbGenericList<Person> personsList = new JaxbGenericList<Person>();
        Person person1 = new Person();
        person1.setId(1);
        personsList.getItems().add(person1);
        return personsList;
    }
}

Мы получаем желаемый результат

: