org.apache.sling.engine.servlets.AbstractServiceReferenceConfig Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of uber-jar Show documentation
There is a newer version: 6.5.21
/*
 * 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.sling.engine.servlets;

import static org.apache.sling.engine.EngineConstants.SLING_SERLVET_NAME;
import static org.osgi.framework.Constants.SERVICE_ID;
import static org.osgi.framework.Constants.SERVICE_PID;
import static org.osgi.service.component.ComponentConstants.COMPONENT_NAME;

import java.util.Arrays;
import java.util.Collections;
import java.util.Enumeration;
import java.util.List;

import javax.servlet.ServletContext;

import org.osgi.annotation.versioning.ConsumerType;
import org.osgi.framework.ServiceReference;


/**
 * The AbstractServiceReferenceConfig may be used as a base class
 * to define ServletConfig and FilterConfig
 * instances from OSGi ServiceReference objects. The properties
 * of this service reference are used as the initialization parameters of the
 * configuration object.
 * 
 * The name of the servlet or filter may be retrieved from the service reference
 * by calling the static {@link #getName(ServiceReference)} method. This method
 * looks for the following service reference properties, assuming the first non-null
 * value found:
 * 

 * sling.core.servletName - A service registration property
 * which may be set to define an independent servlet name.
 * 
component.name - The name of the Declarative Services
 * component if the OSGi service is registered using Declarative Services.
 * 
service.pid - The Service PID of the service.
 * 
service.id - The ID of the service as set by the OSGi
 * framework service registry. This property is guaranteed to always be set by
 * the OSGi specification.
 * 
 *
 * @deprecated
 */
@Deprecated
@ConsumerType
public abstract class AbstractServiceReferenceConfig {

    /** The list of property names checked by {@link #getName(ServiceReference)} */
    private static final String[] NAME_PROPERTIES = { SLING_SERLVET_NAME,
        COMPONENT_NAME, SERVICE_PID, SERVICE_ID };

    /** The ServletContext of this configuration object */
    private ServletContext servletContext;

    /** The ServiceReference providing the properties */
    private ServiceReference reference;

    /** The name of this configuration object */
    private String name;

    /**
     * Sets up this base configuration object.
     *
     * @param servletContext The ServletContext attached to this
     *            configuration.
     * @param reference The service reference providing the initialization
     *            parameter values.
     * @param name The name of this configuration.
     * @see #getName()
     */
    public AbstractServiceReferenceConfig(ServletContext servletContext,
            ServiceReference reference, String name) {
        this.servletContext = servletContext;
        this.reference = reference;
        this.name = name;
    }

    public String getInitParameter(String name) {
        Object prop = reference.getProperty(name);
        return (prop == null) ? null : String.valueOf(prop);
    }

    public Enumeration getInitParameterNames() {
        List keys = Arrays.asList(reference.getPropertyKeys());
        return Collections.enumeration(keys);
    }

    public ServletContext getServletContext() {
        return servletContext;
    }

    /**
     * Returns the name of this configuration object. Implementations may use
     * this value to implement the ServletConfig.getServletName()
     * or FilterConfig.getFilterName() methods.
     * @return The name
     */
    protected String getName() {
        return name;
    }

    /**
     * Looks for a name value in the service reference properties. See the
     * class comment at the top for the list of properties checked by this
     * method.
     * @param reference The service reference
     * @return The name
     */
    public static String getName(ServiceReference reference) {
        String servletName = null;
        for (int i = 0; i < NAME_PROPERTIES.length
            && (servletName == null || servletName.length() == 0); i++) {
            Object prop = reference.getProperty(NAME_PROPERTIES[i]);
            if (prop != null) {
                servletName = String.valueOf(prop);
            }
        }
        return servletName;
    }

}