Difference between revisions of "EclipseLink/Examples/MOXy/MOXy JSON Provider"

From Eclipsepedia

Jump to: navigation, search
 
(9 intermediate revisions by one user not shown)
Line 3: Line 3:
 
=MOXy JSON Provider=
 
=MOXy JSON Provider=
  
MOXy now includes an implementation ('''MOXyJsonProvider''') that can be used directly or extended to make the integration even easier.
+
MOXy now includes an implementation of MessageBodyReader / MessageBodyWriter, called '''MOXyJsonProvider''', that can be used directly or extended to make JAX-RS integration even easier.
  
==Using MOXyJsonProvider==
 
  
===Default Behaviour===
+
==Default Behaviour==
  
 
You can use a JAX-RS Application class to specify that '''MOXyJsonProvider''' should be used with your JAX-RS application.
 
You can use a JAX-RS Application class to specify that '''MOXyJsonProvider''' should be used with your JAX-RS application.
Line 19: Line 18:
 
import org.eclipse.persistence.jaxb.rs.MOXyJsonProvider;
 
import org.eclipse.persistence.jaxb.rs.MOXyJsonProvider;
 
   
 
   
public class CustomerApplication extends Application {
+
public class CustomerApplication extends Application {
 
   
 
   
 
     @Override
 
     @Override
Line 33: Line 32:
 
</div>
 
</div>
  
===Configuration Options===
+
 
 +
==Configuration Options==
 
    
 
    
 
You can also use a JAX-RS Application class to specify an instance of MOXyJsonProvider to be used with your JAX-RS application.  This approach allows you customize the different configuration options offered by the MOXyJsonProvider.
 
You can also use a JAX-RS Application class to specify an instance of MOXyJsonProvider to be used with your JAX-RS application.  This approach allows you customize the different configuration options offered by the MOXyJsonProvider.
Line 45: Line 45:
 
import org.eclipse.persistence.jaxb.rs.MOXyJsonProvider;
 
import org.eclipse.persistence.jaxb.rs.MOXyJsonProvider;
 
   
 
   
public class CustomerApplication extends Application {
+
public class CustomerApplication extends Application {
 
   
 
   
 
     @Override
 
     @Override
Line 78: Line 78:
 
</div>
 
</div>
  
===WEB-INF/web.xml===
+
 
 +
==WEB-INF/web.xml==
  
 
A web.xml file is used to configure the Application class:
 
A web.xml file is used to configure the Application class:
Line 106: Line 107:
 
     </persistence-context-ref>
 
     </persistence-context-ref>
 
</web-app>
 
</web-app>
 +
</source>
 +
</div>
 +
 +
 +
==Extending MOXyJsonProvider==
 +
 
 +
You can also extend MOXyJsonProvider to create your own '''MessageBodyReader/MessageBodyWriter'''.  The <tt>preReadFrom</tt> and <tt>preWriteTo</tt> methods can be overridden to customize the Unmarshaller/Marshaller that will be used by MOXy.
 +
 +
<div style="width:850px">
 +
<source lang="java">
 +
package org.example;
 +
 +
import java.lang.annotation.Annotation;
 +
import java.lang.reflect.Type;
 +
 +
import javax.ws.rs.*;
 +
import javax.ws.rs.core.*;
 +
import javax.ws.rs.ext.Provider;
 +
import javax.xml.bind.*;
 +
 +
import org.eclipse.persistence.jaxb.MarshallerProperties;
 +
import org.eclipse.persistence.jaxb.rs.MOXyJsonProvider;
 +
 +
@Provider
 +
@Produces(MediaType.APPLICATION_JSON)
 +
@Consumes(MediaType.APPLICATION_JSON)
 +
public class CustomerJSONProvider extends MOXyJsonProvider {
 +
 +
    @Override
 +
    public boolean isReadable(Class<?> type, Type genericType,
 +
            Annotation[] annotations, MediaType mediaType) {
 +
        return getDomainClass(genericType) == Customer.class;
 +
    }
 +
 +
    @Override
 +
    public boolean isWriteable(Class<?> type, Type genericType,
 +
            Annotation[] annotations, MediaType mediaType) {
 +
        return isReadable(type, genericType, annotations, mediaType);
 +
    }
 +
 +
    @Override
 +
    protected void preReadFrom(Class<Object> type, Type genericType,
 +
            Annotation[] annotations, MediaType mediaType,
 +
            MultivaluedMap<String, String> httpHeaders,
 +
            Unmarshaller unmarshaller) throws JAXBException {
 +
        unmarshaller.setProperty(MarshallerProperties.JSON_VALUE_WRAPPER, "$");
 +
    }
 +
 +
    @Override
 +
    protected void preWriteTo(Object object, Class<?> type, Type genericType,
 +
            Annotation[] annotations, MediaType mediaType,
 +
            MultivaluedMap<String, Object> httpHeaders, Marshaller marshaller)
 +
            throws JAXBException {
 +
        marshaller.setProperty(MarshallerProperties.JSON_VALUE_WRAPPER, "$");
 +
    }
 +
 +
}
 
</source>
 
</source>
 
</div>
 
</div>

Latest revision as of 14:17, 18 June 2012

[edit] MOXy JSON Provider

MOXy now includes an implementation of MessageBodyReader / MessageBodyWriter, called MOXyJsonProvider, that can be used directly or extended to make JAX-RS integration even easier.


[edit] Default Behaviour

You can use a JAX-RS Application class to specify that MOXyJsonProvider should be used with your JAX-RS application.

package org.example;
 
import java.util.*;
import javax.ws.rs.core.Application;
import org.eclipse.persistence.jaxb.rs.MOXyJsonProvider;
 
public class CustomerApplication extends Application {
 
    @Override
    public Set<Class<?>> getClasses() {
        HashSet<Class<?>> set = new HashSet<Class<?>>(2);
        set.add(MOXyJsonProvider.class);
        set.add(CustomerService.class);
        return set;
    }
 
}


[edit] Configuration Options

You can also use a JAX-RS Application class to specify an instance of MOXyJsonProvider to be used with your JAX-RS application. This approach allows you customize the different configuration options offered by the MOXyJsonProvider.

package org.example;
 
import java.util.*;
import javax.ws.rs.core.Application;
import org.eclipse.persistence.jaxb.rs.MOXyJsonProvider;
 
public class CustomerApplication extends Application {
 
    @Override
    public Set<Class<?>> getClasses() {
        HashSet<Class<?>> set = new HashSet<Class<?>>(1);
        set.add(ExampleService.class);
        return set;
    }
 
    @Override
    public Set<Object> getSingletons() {
        MOXyJsonProvider moxyJsonProvider = new MOXyJsonProvider();
 
        moxyJsonProvider.setAttributePrefix("@");
        moxyJsonProvider.setFormattedOutput(true);
        moxyJsonProvider.setIncludeRoot(true);
        moxyJsonProvider.setMarshalEmptyCollections(false);
        moxyJsonProvider.setValueWrapper("$");
 
        Map<String, String> namespacePrefixMapper = new HashMap<String, String>(1);
        namespacePrefixMapper.put("http://www.example.org/customer", "cust");
        moxyJsonProvider.setNamespacePrefixMapper(namespacePrefixMapper);
        moxyJsonProvider.setNamespaceSeparator(':');
 
        HashSet<Object> set = new HashSet<Object>(1);
        set.add(moxyJsonProvider);
        return set;
    }
 
}


[edit] WEB-INF/web.xml

A web.xml file is used to configure the Application class:

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
    <servlet>
        <servlet-name>Jersey Web Application</servlet-name>
        <servlet-class>com.sun.jersey.spi.container.servlet.ServletContainer
        </servlet-class>
        <load-on-startup>1</load-on-startup>
        <init-param>
            <param-name>javax.ws.rs.Application</param-name>
            <param-value>org.example.CustomerApplication</param-value>
        </init-param>
    </servlet>
    <servlet-mapping>
        <servlet-name>Jersey Web Application</servlet-name>
        <url-pattern>/rest/*</url-pattern>
    </servlet-mapping>
    <persistence-context-ref>
        <persistence-context-ref-name>persistence/em</persistence-context-ref-name>
        <persistence-unit-name>CustomerService</persistence-unit-name>
    </persistence-context-ref>
</web-app>


[edit] Extending MOXyJsonProvider

You can also extend MOXyJsonProvider to create your own MessageBodyReader/MessageBodyWriter. The preReadFrom and preWriteTo methods can be overridden to customize the Unmarshaller/Marshaller that will be used by MOXy.

package org.example;
 
import java.lang.annotation.Annotation;
import java.lang.reflect.Type;
 
import javax.ws.rs.*;
import javax.ws.rs.core.*;
import javax.ws.rs.ext.Provider;
import javax.xml.bind.*;
 
import org.eclipse.persistence.jaxb.MarshallerProperties;
import org.eclipse.persistence.jaxb.rs.MOXyJsonProvider;
 
@Provider
@Produces(MediaType.APPLICATION_JSON)
@Consumes(MediaType.APPLICATION_JSON)
public class CustomerJSONProvider extends MOXyJsonProvider {
 
    @Override
    public boolean isReadable(Class<?> type, Type genericType,
            Annotation[] annotations, MediaType mediaType) {
        return getDomainClass(genericType) == Customer.class;
    }
 
    @Override
    public boolean isWriteable(Class<?> type, Type genericType,
            Annotation[] annotations, MediaType mediaType) {
        return isReadable(type, genericType, annotations, mediaType);
    }
 
    @Override
    protected void preReadFrom(Class<Object> type, Type genericType,
            Annotation[] annotations, MediaType mediaType,
            MultivaluedMap<String, String> httpHeaders,
            Unmarshaller unmarshaller) throws JAXBException {
        unmarshaller.setProperty(MarshallerProperties.JSON_VALUE_WRAPPER, "$");
    }
 
    @Override
    protected void preWriteTo(Object object, Class<?> type, Type genericType,
            Annotation[] annotations, MediaType mediaType,
            MultivaluedMap<String, Object> httpHeaders, Marshaller marshaller)
            throws JAXBException {
        marshaller.setProperty(MarshallerProperties.JSON_VALUE_WRAPPER, "$");
    }
 
}