MetaAnnotationBindingRegistry.java

/*
 * 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.felix.ipojo.manipulator.metadata.annotation.registry;

import static java.util.Collections.emptyList;
import static java.util.Collections.unmodifiableList;
import static org.apache.felix.ipojo.manipulator.spi.helper.Predicates.alwaysTrue;

import java.io.IOException;
import java.util.ArrayList;
import java.util.List;

import org.apache.felix.ipojo.annotations.HandlerBinding;
import org.apache.felix.ipojo.annotations.Ignore;
import org.apache.felix.ipojo.annotations.Stereotype;
import org.apache.felix.ipojo.manipulator.Reporter;
import org.apache.felix.ipojo.manipulator.ResourceStore;
import org.apache.felix.ipojo.manipulator.metadata.annotation.model.AnnotationType;
import org.apache.felix.ipojo.manipulator.metadata.annotation.model.discovery.ChainedAnnotationDiscovery;
import org.apache.felix.ipojo.manipulator.metadata.annotation.model.discovery.HandlerBindingDiscovery;
import org.apache.felix.ipojo.manipulator.metadata.annotation.model.discovery.IgnoredDiscovery;
import org.apache.felix.ipojo.manipulator.metadata.annotation.model.discovery.StereotypeDiscovery;
import org.apache.felix.ipojo.manipulator.metadata.annotation.model.parser.AnnotationParser;
import org.apache.felix.ipojo.manipulator.metadata.annotation.visitor.generic.GenericVisitorFactory;
import org.apache.felix.ipojo.manipulator.metadata.annotation.visitor.ignore.NullBinding;
import org.apache.felix.ipojo.manipulator.metadata.annotation.visitor.stereotype.StereotypeVisitorFactory;
import org.apache.felix.ipojo.manipulator.metadata.annotation.visitor.util.Elements;
import org.apache.felix.ipojo.metadata.Element;
import org.objectweb.asm.Type;

/**
 * The {@link MetaAnnotationBindingRegistry} is a registry that tries to complete its list
 * of bindings when an unknown one is detected.
 * It uses the given {@link ResourceStore} to parse the annotation's type and find if
 * it's annotated with @{@link org.apache.felix.ipojo.annotations.Stereotype},
 * @{@link org.apache.felix.ipojo.annotations.HandlerBinding} or @{@link org.apache.felix.ipojo.annotations.Ignore}
 */
public class MetaAnnotationBindingRegistry extends CompletableBindingRegistry {

    private ResourceStore m_store;
    private Reporter m_reporter;

    public MetaAnnotationBindingRegistry(final BindingRegistry delegate, final Reporter reporter, final ResourceStore store) {
        super(delegate, reporter);
        this.m_reporter = reporter;
        this.m_store = store;
        addBindings(nullBindingsForMetaAnnotations());
    }

    protected Iterable<Binding> nullBindingsForMetaAnnotations() {
        // Do not re-apply meta-annotations
        ArrayList<Binding> bindings = new ArrayList<Binding>();
        bindings.add(new NullBinding(Type.getType(Stereotype.class)));
        bindings.add(new NullBinding(Type.getType(HandlerBinding.class)));
        bindings.add(new NullBinding(Type.getType(Ignore.class)));
        return bindings;
    }

    @Override
    protected List<Binding> createBindings(final Type type) {

        // Parse the annotation
        byte[] bytes;
        try {
            bytes = m_store.read(type.getInternalName().concat(".class"));
        } catch (IOException e) {
            // Annotation type cannot be read
            m_reporter.trace("Could not read bytecode for @%s.", type.getClassName());
            return emptyList();
        } catch (IllegalStateException e) {
            m_reporter.trace("Could not read bytecode for @%s because the bundle is not in a state allowing read " +
                            "operations.",
                    type.getClassName());
            return emptyList();
        }
        AnnotationParser parser = new AnnotationParser();
        AnnotationType annotationType = parser.read(bytes);

        // Search meta-annotations
        ChainedAnnotationDiscovery chain = new ChainedAnnotationDiscovery();
        StereotypeDiscovery stereotypeDiscovery = new StereotypeDiscovery();
        HandlerBindingDiscovery handlerBindingDiscovery = new HandlerBindingDiscovery();
        IgnoredDiscovery ignoredDiscovery = new IgnoredDiscovery();
        chain.getDiscoveries().add(stereotypeDiscovery);
        chain.getDiscoveries().add(handlerBindingDiscovery);
        chain.getDiscoveries().add(ignoredDiscovery);

        annotationType.traverse(chain);

        // Produced Bindings
        List<Binding> bindings = new ArrayList<Binding>();

        // @Stereotype support
        if (stereotypeDiscovery.isStereotype()) {
            m_reporter.trace("@Stereotype detected: @%s", type.getClassName());
            Binding binding = new Binding();
            binding.setAnnotationType(type);
            binding.setPredicate(alwaysTrue());
            binding.setFactory(new StereotypeVisitorFactory(annotationType));

            bindings.add(binding);
        }

        // @HandlerBinding support
        if (handlerBindingDiscovery.isHandlerBinding()) {

            m_reporter.trace("@HandlerBinding detected: @%s", type.getClassName());
            Binding binding = new Binding();
            binding.setAnnotationType(type);
            binding.setPredicate(alwaysTrue());
            final Element element = buildElement(handlerBindingDiscovery, type);
            binding.setFactory(new GenericVisitorFactory(element.getName(), element.getNameSpace()));

            bindings.add(binding);
        }

        // Its IMPORTANT that the @Ignore is processed last since it removes existing bindings
        if (ignoredDiscovery.isIgnore()) {
            m_reporter.trace("@Ignore detected: @%s", type.getClassName());
            Binding binding = new NullBinding(type);

            bindings.clear();
            bindings.add(binding);
            bindings = unmodifiableList(bindings); // just in case of ...
        }

        return bindings;

    }

    private Element buildElement(final HandlerBindingDiscovery handler, final Type type) {
        Element element;
        if ((handler.getNamespace() == null) &&
                (handler.getValue() == null)) {
            // No attributes specified, use annotation type as element's source
            element = Elements.buildElement(type);
        } else if ((handler.getNamespace() == null)) {
            // Namespace attribute is omitted
            element = Elements.buildElement(handler.getValue());
        } else {
            element = Elements.buildElement(handler.getNamespace(),
                                            handler.getValue());
        }
        return element;
    }

}