- MOXy как ваш JAX-RS JSON-провайдер — на стороне сервера
- MOXy как ваш JAX-RS JSON-провайдер — на стороне клиента
Почему EclipseLink JAXB (MOXy)?
Ниже приведены некоторые преимущества использования MOXy в качестве поставщика JSON-связывания:
- Самая широкая поддержка аннотаций JAXB среди провайдеров связывания JSON.
- Поддержка как XML, так и JSON: привязка к JSON и XML — пример геокода .
- MOXy содержит расширения, такие как @XmlInverseReference для отображения сущностей JPA в JSON и XML: Часть 3. Отображение сущностей JPA в XML (с использованием JAXB) .
- Внешний картографический документ как альтернатива аннотациям: XML-метаданные MOXy в сервисе JAX-RS .
Обслуживание клиентов
Типы сообщений, которые понимает служба JAX-RS, контролируются с помощью аннотаций @Produces и @Consumes. В этом посте я указал, что все операции теперь поддерживают «application / json» в дополнение к «application / xml». Более подробное описание этого сервиса доступно в следующем посте: Создание веб-сервиса RESTful — часть 4/5 .
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
|
package org.example; import java.util.List; import javax.ejb.*; import javax.persistence.*; import javax.ws.rs.*; import javax.ws.rs.core.MediaType; @Stateless @LocalBean @Path ( "/customers" ) public class CustomerService { @PersistenceContext (unitName= "CustomerService" , type=PersistenceContextType.TRANSACTION) EntityManager entityManager; @POST @Consumes ({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON}) public void create(Customer customer) { entityManager.persist(customer); } @GET @Produces ({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON}) @Path ( "{id}" ) public Customer read( @PathParam ( "id" ) long id) { return entityManager.find(Customer. class , id); } @PUT @Consumes ({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON}) public void update(Customer customer) { entityManager.merge(customer); } @DELETE @Path ( "{id}" ) public void delete( @PathParam ( "id" ) long id) { Customer customer = read(id); if ( null != customer) { entityManager.remove(customer); } } @GET @Produces ({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON}) @Path ( "findCustomersByCity/{city}" ) public List<Customer> findCustomersByCity( @PathParam ( "city" ) String city) { Query query = entityManager.createNamedQuery( "findCustomersByCity" ); query.setParameter( "city" , city); return query.getResultList(); } } |
MOXyJSONProvider
Мы реализуем JAX-RS MessageBodyReader / MessageBodyWriter, чтобы подключить поддержку для привязки JSON MOXy. Эта реализация является достаточно общей, чтобы ее можно было использовать как есть, чтобы включить JSON-привязку для любой службы JAX-RS, использующей MOXy в качестве поставщика JAXB. Некоторые интересные вещи, чтобы отметить:
- На MOXy нет зависимости времени компиляции.
- Свойство eclipselink.media-type используется для включения привязки JSON для демаршаллера (строка 34) и маршаллера (строка 55).
- Свойство eclipselink.json.include-root используется для указания того, что аннотация @XmlRootElement должна игнорироваться в привязке JSON (строки 35 и 56).
- При создании JAXBContext код сначала проверяет, зарегистрирован ли JAXBContext для этого типа (строки 70 и 71). Это полезно, если вы хотите использовать внешний документ сопоставления MOXy: XML-метаданные MOXy в службе JAX-RS .
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
package org.example; import java.io.*; import java.lang.annotation.Annotation; import java.lang.reflect.*; import javax.xml.transform.stream.StreamSource; import javax.ws.rs.*; import javax.ws.rs.core.*; import javax.ws.rs.ext.*; import javax.xml.bind.*; @Provider @Produces (MediaType.APPLICATION_JSON) @Consumes (MediaType.APPLICATION_JSON) public class MOXyJSONProvider implements MessageBodyReader<Object>, MessageBodyWriter<Object>{ @Context protected Providers providers; public boolean isReadable(Class<?> type, Type genericType, Annotation[] annotations, MediaType mediaType) { return true ; } public Object readFrom(Class<Object> type, Type genericType, Annotation[] annotations, MediaType mediaType, MultivaluedMap<String, String> httpHeaders, InputStream entityStream) throws IOException, WebApplicationException { try { Class<?> domainClass = getDomainClass(genericType); Unmarshaller u = getJAXBContext(domainClass, mediaType).createUnmarshaller(); u.setProperty( "eclipselink.media-type" , mediaType.toString()); u.setProperty( "eclipselink.json.include-root" , false ); return u.unmarshal( new StreamSource(entityStream), domainClass).getValue(); } catch (JAXBException jaxbException) { throw new WebApplicationException(jaxbException); } } public boolean isWriteable(Class<?> type, Type genericType, Annotation[] annotations, MediaType mediaType) { return true ; } public void writeTo(Object object, Class<?> type, Type genericType, Annotation[] annotations, MediaType mediaType, MultivaluedMap<String, Object> httpHeaders, OutputStream entityStream) throws IOException, WebApplicationException { try { Class<?> domainClass = getDomainClass(genericType); Marshaller m = getJAXBContext(domainClass, mediaType).createMarshaller(); m.setProperty( "eclipselink.media-type" , mediaType.toString()); m.setProperty( "eclipselink.json.include-root" , false ); m.marshal(object, entityStream); } catch (JAXBException jaxbException) { throw new WebApplicationException(jaxbException); } } public long getSize(Object t, Class<?> type, Type genericType, Annotation[] annotations, MediaType mediaType) { return - 1 ; } private JAXBContext getJAXBContext(Class<?> type, MediaType mediaType) throws JAXBException { ContextResolver<JAXBContext> resolver = providers.getContextResolver(JAXBContext. class , mediaType); JAXBContext jaxbContext; if ( null == resolver || null == (jaxbContext = resolver.getContext(type))) { return JAXBContext.newInstance(type); } else { return jaxbContext; } } private Class<?> getDomainClass(Type genericType) { if (genericType instanceof Class) { return (Class<?>) genericType; } else if (genericType instanceof ParameterizedType) { return (Class<?>) ((ParameterizedType) genericType).getActualTypeArguments()[ 0 ]; } else { return null ; } } } |
Настройка сервера
Если вы используете GlassFish в качестве сервера приложений, вам необходимо заменить следующие комплекты EclipseLink на их аналоги из установки EclipseLink 2.4 .
- org.eclipse.persistence.antlr.jar
- org.eclipse.persistence.asm.jar
- org.eclipse.persistence.core.jar
- org.eclipse.persistence.jpa.jar
- org.eclipse.persistence.jpa-modelgen.jar
- org.eclipse.persistence.moxy.jar
- org.eclipse.persistence.oracle.jar
Дальнейшее чтение
Если вам понравился этот пост, то вы также можете быть заинтересованы в:
- RESTful Услуги
- MOXy как ваш JAX-RS JSON-провайдер — на стороне клиента
- Создание сервиса RESTful
- Часть 1 — База данных
- Часть 2 — Отображение базы данных на объекты JPA
- Часть 3. Отображение сущностей JPA в XML (с использованием JAXB)
- Часть 4 — RESTful Service
- Часть 5 — Клиент
- XML-метаданные MOXy в службе JAX-RS
- JSON Binding
- Интеграция сервера приложений
Ссылка: MOXy — ваш JAX-RS JSON-провайдер — серверная сторона от нашего партнера по JCG Блэза Дафана из блога Java XML & JSON Binding .