package org.kuali.rice.core.jaxb;

 import javax.xml.bind.annotation.adapters.XmlAdapter;

 import java.util.Arrays;

 import java.util.Collection;

 import java.util.Collections;

 /**

  * Handles JAXB mapping that ensures that any Collection created from unmarshalled XML will be immutable.

  */

 public class ImmutableCollectionAdapter extends XmlAdapter<Object[], Collection<?>> {

     /**

      * Returns an immutable Collection when a Collection is meant to be unmarshalled from XML.  This is done to ensure service

      * contracts, which are to return immutable objects, also return immutable Collections when an XML sequence is returned

      * via a remote SOAP call.

      *

      * @param objects an array of Objects collected from XML to be transformed into an immutable Collection

      * @return An immutable Collection

      * @throws Exception

      */

     @Override

     public Collection<?> unmarshal(Object[] objects) throws Exception {

         return Collections.unmodifiableCollection(Arrays.asList(objects));

     }

     /**

      * Creates an array of Object[] from a passed in List for JAXB marshalling. There is no requirement of what kind of

      * List is used when marshalling to XML.

      *

      * @param objects

      * @return The same List object that was passed in

      * @throws Exception

      */

     @Override

     public Object[] marshal(Collection<?> objects) throws Exception {

         return objects.toArray();

     }

 }