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.api.common.assignee;
017    
018    import org.kuali.rice.kim.api.common.delegate.DelegateTypeContract;
019    
020    import java.util.List;
021    
022    //TODO Get a better description
023    /**
024     * This is the contract for a Permission Assignee.
025     * 
026     * Permissions are attached to roles. All authorization checks should be done against permissions,
027     * never against roles or groups.
028     *  
029     */
030    public interface AssigneeContract {
031    
032        /**
033         * The Principal ID referenced by the Permission Assignee.
034         *
035         * @return principalId
036         */
037        String getPrincipalId();
038    
039        /**
040         * The Group ID referenced by the Permission Assignee.
041         * 
042         * @return groupId
043         */
044            String getGroupId() ;
045            
046       /** 
047             * List of Delegates for a Permission Assignee 
048             * 
049             * @return delegates
050             */
051            List<? extends DelegateTypeContract> getDelegates();
052    }