001    /**
002     * Copyright 2005-2012 The Kuali Foundation
003     *
004     * Licensed under the Educational Community License, Version 2.0 (the "License");
005     * you may not use this file except in compliance with the License.
006     * You may obtain a copy of the License at
007     *
008     * http://www.opensource.org/licenses/ecl2.php
009     *
010     * Unless required by applicable law or agreed to in writing, software
011     * distributed under the License is distributed on an "AS IS" BASIS,
012     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013     * See the License for the specific language governing permissions and
014     * limitations under the License.
015     */
016    package org.kuali.rice.kim.impl.jaxb;
017    
018    import java.io.Serializable;
019    import java.util.List;
020    
021    import javax.xml.bind.Marshaller;
022    import javax.xml.bind.UnmarshalException;
023    import javax.xml.bind.Unmarshaller;
024    import javax.xml.bind.annotation.XmlAccessType;
025    import javax.xml.bind.annotation.XmlAccessorType;
026    import javax.xml.bind.annotation.XmlElement;
027    import javax.xml.bind.annotation.XmlType;
028    
029    import org.kuali.rice.core.util.jaxb.RiceXmlExportList;
030    import org.kuali.rice.core.util.jaxb.RiceXmlImportList;
031    import org.kuali.rice.core.util.jaxb.RiceXmlListAdditionListener;
032    import org.kuali.rice.core.util.jaxb.RiceXmlListGetterListener;
033    import org.kuali.rice.kim.api.permission.PermissionContract;
034    
035    /**
036     * This class represents a <permissions> element. 
037     * 
038     * @author Kuali Rice Team (rice.collab@kuali.org)
039     */
040    @XmlAccessorType(XmlAccessType.FIELD)
041    @XmlType(name="PermissionsType", propOrder={"permissions"})
042    public class PermissionsXmlDTO implements RiceXmlListAdditionListener<PermissionXmlDTO>,
043            RiceXmlListGetterListener<PermissionXmlDTO,Object>, Serializable {
044        
045        private static final long serialVersionUID = 1L;
046        
047        @XmlElement(name="permission")
048        private List<PermissionXmlDTO> permissions;
049        
050        public PermissionsXmlDTO() {}
051        
052        public PermissionsXmlDTO(List<? extends Object> permissionsToExport) {
053            this.permissions = new RiceXmlExportList<PermissionXmlDTO,Object>(permissionsToExport, this);
054        }
055        
056        /**
057         * @return the permissions
058         */
059        public List<PermissionXmlDTO> getPermissions() {
060            return this.permissions;
061        }
062    
063        /**
064         * @param permissions the permissions to set
065         */
066        public void setPermissions(List<PermissionXmlDTO> permissions) {
067            this.permissions = permissions;
068        }
069    
070        void beforeUnmarshal(Unmarshaller unmarshaller, Object parent) {
071            permissions = new RiceXmlImportList<PermissionXmlDTO>(this);
072        }
073        
074        void afterUnmarshal(Unmarshaller unmarshaller, Object parent) {
075            permissions = null;
076        }
077        
078        public void newItemAdded(PermissionXmlDTO item) {
079            try {
080                PermissionXmlUtil.validateAndPersistNewPermission(item);
081            } catch (UnmarshalException e) {
082                throw new RuntimeException(e);
083            }
084        }
085    
086        void afterMarshal(Marshaller marshaller) {
087            permissions = null;
088        }
089        
090        public PermissionXmlDTO gettingNextItem(Object nextItem, int index) {
091            if (!(nextItem instanceof PermissionContract)) {
092                throw new IllegalStateException("Object for exportation should have been a permission");
093            }
094            return new PermissionXmlDTO((PermissionContract) nextItem);
095        }
096    }