001    /*
002     * Licensed to the Apache Software Foundation (ASF) under one
003     * or more contributor license agreements.  See the NOTICE file
004     * distributed with this work for additional information
005     * regarding copyright ownership.  The ASF licenses this file
006     * to you under the Apache License, Version 2.0 (the
007     * "License"); you may not use this file except in compliance
008     * with the License.  You may obtain a copy of the License at
009     *
010     *  http://www.apache.org/licenses/LICENSE-2.0
011     *
012     * Unless required by applicable law or agreed to in writing,
013     * software distributed under the License is distributed on an
014     * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
015     * KIND, either express or implied.  See the License for the
016     * specific language governing permissions and limitations
017     * under the License.
018     */
019    
020    //
021    // This source code implements specifications defined by the Java
022    // Community Process. In order to remain compliant with the specification
023    // DO NOT add / change / or delete method signatures!
024    //
025    
026    package javax.security.jacc;
027    
028    import java.security.Permission;
029    import java.security.PermissionCollection;
030    
031    /**
032     * @version $Rev: 467553 $ $Date: 2006-10-25 06:01:51 +0200 (Mi, 25. Okt 2006) $
033     */
034    public interface PolicyConfiguration {
035    
036        public String getContextID() throws PolicyContextException;
037        
038        public void addToRole(String roleName, PermissionCollection permissions) throws PolicyContextException;
039        
040        public void addToRole(String roleName, Permission permission) throws PolicyContextException;
041        
042        public void addToUncheckedPolicy(PermissionCollection permissions) throws PolicyContextException;
043        
044        public void addToUncheckedPolicy(Permission permission) throws PolicyContextException;
045        
046        public void addToExcludedPolicy(PermissionCollection permissions) throws PolicyContextException;
047        
048        public void addToExcludedPolicy(Permission permission) throws PolicyContextException;
049        
050        public void removeRole(String roleName) throws PolicyContextException;
051        
052        public void removeUncheckedPolicy() throws PolicyContextException;
053        
054        public void removeExcludedPolicy() throws PolicyContextException;
055        
056        public void linkConfiguration(PolicyConfiguration link) throws PolicyContextException;
057        
058        public void delete() throws PolicyContextException;
059        
060        public void commit() throws PolicyContextException;
061        
062        public boolean inService() throws PolicyContextException;
063    }