/* * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. * The ASF licenses this file to You under the Apache License, Version 2.0 * (the "License"); you may not use this file except in compliance with * the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package org.apache.jackrabbit.jcr2spi.security.authorization; import java.io.IOException; import java.io.InputStream; import java.util.Properties; import javax.jcr.RepositoryException; import javax.jcr.UnsupportedRepositoryOperationException; import org.apache.jackrabbit.jcr2spi.config.RepositoryConfig; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Stub class that provide clients with access to a concrete * AccessControlProvider implementation. TODO: Explain the way the concrete * provider is located, loaded and instantiated. * */ public class AccessControlProviderStub { private static Logger log = LoggerFactory.getLogger(AccessControlProviderStub.class); /** * The class property parameter determines the {@link AccessControlProvider} * to load and instantiate. This is a fall-back parameter if the * SYS_PROP_AC_PROVIDER_IMPL is not set. */ private static final String ACCESS_CONTROL_PROVIDER_PROPERTIES = "accessControlProvider.properties"; /** * Key look-up. */ private static final String PROPERTY_ACCESSCONTROL_PROVIDER_CLASS = "org.apache.jackrabbit.jcr2spi.AccessControlProvider.class"; /** * Avoid instantiation. */ private AccessControlProviderStub() { } /** * Instantiates and returns a concrete AccessControlProvider implementation. * * @param config * The RepositoryConfig to read configuration parameters. * @return * @throws RepositoryException */ public static AccessControlProvider newInstance(RepositoryConfig config) throws RepositoryException { String className = getProviderClass(config); if (className != null) { try { Class<?> acProviderClass = Class.forName(className); if (AccessControlProvider.class.isAssignableFrom(acProviderClass)) { AccessControlProvider acProvider = (AccessControlProvider) acProviderClass.newInstance(); acProvider.init(config); return acProvider; } else { throw new RepositoryException("Fail to create AccessControlProvider from configuration."); } } catch (Exception e) { throw new RepositoryException("Fail to create AccessControlProvider from configuration."); } } // ac not supported in this setup. throw new UnsupportedRepositoryOperationException("Access control is not supported"); } private static String getProviderClass(RepositoryConfig config) throws RepositoryException { String implClass = config.getConfiguration(PROPERTY_ACCESSCONTROL_PROVIDER_CLASS, null); if (implClass != null) { return implClass; } else { try { // not configured try to load as resource Properties prop = new Properties(); InputStream is = AccessControlProviderStub.class.getClassLoader().getResourceAsStream(ACCESS_CONTROL_PROVIDER_PROPERTIES); if (is != null) { prop.load(is); // loads the concrete class to instantiate. if (prop.containsKey(PROPERTY_ACCESSCONTROL_PROVIDER_CLASS)) { return prop.getProperty(PROPERTY_ACCESSCONTROL_PROVIDER_CLASS); } else { log.debug("Missing AccessControlProvider configuration."); } } else { log.debug("Fail to locate the access control provider properties file."); } } catch (IOException e) { throw new RepositoryException("Fail to load AccessControlProvider configuration."); } } return null; } }