+++ /dev/null
-/*******************************************************************************\r
- * ============LICENSE_START====================================================\r
- * * org.onap.aaf\r
- * * ===========================================================================\r
- * * Copyright © 2017 AT&T Intellectual Property. All rights reserved.\r
- * * ===========================================================================\r
- * * Licensed under the Apache License, Version 2.0 (the "License");\r
- * * you may not use this file except in compliance with the License.\r
- * * You may obtain a copy of the License at\r
- * * \r
- * * http://www.apache.org/licenses/LICENSE-2.0\r
- * * \r
- * * Unless required by applicable law or agreed to in writing, software\r
- * * distributed under the License is distributed on an "AS IS" BASIS,\r
- * * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
- * * See the License for the specific language governing permissions and\r
- * * limitations under the License.\r
- * * ============LICENSE_END====================================================\r
- * *\r
- * * ECOMP is a trademark and service mark of AT&T Intellectual Property.\r
- * *\r
- ******************************************************************************/\r
-package org.onap.aaf.cadi;\r
-\r
-import java.security.Principal;\r
-import java.util.List;\r
-\r
-\r
-\r
-/**\r
- * LUR: Local User Registry\r
- *\r
- * Concept by Robert Garskof, Implementation by Jonathan Gathman\r
- * \r
- * Where we can keep local copies of users and roles for faster Authorization when asked.\r
- * \r
- * Note: Author cannot resist the mental image of using a Fishing Lure to this LUR pattern \r
- * \r
- *\r
- */\r
-public interface Lur {\r
- /**\r
- * Allow the Lur, which has correct Permission access, to create and hand back. \r
- */\r
- public Permission createPerm(String p);\r
- \r
- /** \r
- * Fish for Principals in a Pond\r
- * \r
- * or more boringly, is the User identified within a named collection representing permission.\r
- * \r
- * @param principalName\r
- * @return\r
- */\r
- public boolean fish(Principal bait, Permission pond);\r
-\r
- /** \r
- * Fish all the Principals out a Pond\r
- * \r
- * For additional humor, pronounce the following with a Southern Drawl, "FishOil"\r
- * \r
- * or more boringly, load the List with Permissions found for Principal\r
- * \r
- * @param principalName\r
- * @return\r
- */\r
- public void fishAll(Principal bait, List<Permission> permissions);\r
-\r
- /**\r
- * Allow implementations to disconnect, or cleanup resources if unneeded\r
- */\r
- public void destroy();\r
-\r
- /**\r
- * Does this LUR handle this pond exclusively? Important for EpiLUR to determine whether \r
- * to try another (more expensive) LUR \r
- * @param pond\r
- * @return\r
- */\r
- public boolean handlesExclusively(Permission pond); \r
- \r
- /**\r
- * What domain of User does this LUR support? (used to avoid asking when not possible)\r
- * \r
- * @param bait\r
- * @return\r
- */\r
- public boolean supports(String userName);\r
- \r
- /**\r
- * Clear: Clear any Caching, if exists\r
- */\r
- public void clear(Principal p, StringBuilder report);\r
-}\r