opendaylight/northbound/bundlescanner/implementation/src/main/java/org/opendaylight/controller/northbound/bundlescanner/internal/BundleInfo.java

   1 /**
   2  * Copyright (c) 2013 Cisco Systems, Inc. and others.  All rights reserved.
   3  *
   4  * This program and the accompanying materials are made available under the
   5  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
   6  * and is available at http://www.eclipse.org/legal/epl-v10.html
   7  */
   8
   9 package org.opendaylight.controller.northbound.bundlescanner.internal;
  10
  11 import java.util.ArrayList;
  12 import java.util.Collection;
  13 import java.util.Collections;
  14 import java.util.Dictionary;
  15 import java.util.HashSet;
  16 import java.util.List;
  17 import java.util.Map;
  18 import java.util.Set;
  19 import java.util.regex.Pattern;
  20
  21 import org.osgi.framework.Bundle;
  22 import org.osgi.framework.Constants;
  23 import org.slf4j.Logger;
  24 import org.slf4j.LoggerFactory;
  25
  26 /**
  27  * BundleInfo holds information related to the bundle obtained during the
  28  * bundle scan process.
  29  */
  30 /*package*/ class BundleInfo {
  31     private static final Logger LOGGER = LoggerFactory.getLogger(BundleInfo.class);
  32
  33     private final Bundle bundle;
  34     private final Map<String, Set<String>> annotatedClasses;
  35     private final Set<String> exportPkgs;
  36     private final Set<String> importPkgs;
  37
  38     public BundleInfo(Bundle bundle, Map<String, Set<String>> classes) {
  39         this.bundle = bundle;
  40         this.annotatedClasses = classes;
  41         Dictionary<String, String> dict = bundle.getHeaders();
  42         this.importPkgs = parsePackages(dict.get(Constants.IMPORT_PACKAGE));
  43         this.exportPkgs = parsePackages(dict.get(Constants.EXPORT_PACKAGE));
  44     }
  45
  46     @Override
  47     public String toString() {
  48         StringBuilder sb = new StringBuilder(super.toString());
  49         sb.append("{name:").append(bundle.getSymbolicName())
  50           .append(" id:").append(getId())
  51           .append(" annotated-classes:").append(annotatedClasses)
  52           .append(" imports:").append(importPkgs)
  53           .append(" exports:").append(exportPkgs).append("}");
  54         return sb.toString();
  55     }
  56
  57     public Bundle getBundle() {
  58         return bundle;
  59     }
  60
  61     public long getId() {
  62         return bundle.getBundleId();
  63     }
  64
  65     public List<Class<?>> getAnnotatedClasses(Pattern pattern) {
  66         List<String> result = new ArrayList<String>();
  67         for (Map.Entry<String, Set<String>> entry : annotatedClasses.entrySet()) {
  68             if (matches(pattern, entry.getValue())) {
  69                 result.add(entry.getKey());
  70             }
  71         }
  72         return BundleScanner.loadClasses(result, bundle);
  73     }
  74
  75     private boolean matches(Pattern pattern, Set<String> values) {
  76         if (pattern == null) return true;
  77         //LOGGER.debug("Matching: {} {}", pattern.toString(), values);
  78         for (String s : values) {
  79             if (pattern.matcher(s).find()) return true;
  80         }
  81         return false;
  82     }
  83
  84     /**
  85      * Get classes with annotations matching a pattern
  86      *
  87      * @param allbundles - all bundles
  88      * @param pattern - annotation pattern to match
  89      * @param initBundle - the bundle which initiated this call
  90      *
  91      * @return list of annotated classes matching the pattern
  92      */
  93     public List<Class<?>> getAnnotatedClasses(
  94             Collection<BundleInfo> allbundles,
  95             Pattern pattern, Bundle initBundle)
  96     {
  97         List<Class<?>> classes = getAnnotatedClasses(pattern);
  98         processAnnotatedClassesInternal(this, allbundles, pattern,
  99                 new HashSet<BundleInfo>(), classes, initBundle);
 100         return classes;
 101     }
 102
 103     private List<String> getExportedAnnotatedClasses(Pattern pattern) {
 104         List<String> classes = new ArrayList<String>();
 105         for (Map.Entry<String, Set<String>> entry : annotatedClasses.entrySet()) {
 106             String cls = entry.getKey();
 107             int idx = cls.lastIndexOf(".");
 108             String pkg = (idx == -1 ? "" : cls.substring(0, idx));
 109             // for a class to match, the package has to be exported and
 110             // annotations should match the given pattern
 111             if (exportPkgs.contains(pkg) && matches(pattern, entry.getValue())) {
 112                 classes.add(cls);
 113             }
 114         }
 115         if (LOGGER.isDebugEnabled()) {
 116             LOGGER.debug("Found in bundle:{} exported classes:[{}]",
 117                     getBundle().getSymbolicName(), classes);
 118         }
 119         return classes;
 120     }
 121
 122     private static void processAnnotatedClassesInternal(
 123             BundleInfo target,
 124             Collection<BundleInfo> bundlesToScan,
 125             Pattern pattern,
 126             Collection<BundleInfo> visited,
 127             List<Class<?>> classes,
 128             Bundle initBundle)
 129     {
 130         for (BundleInfo other : bundlesToScan) {
 131             if (other.getId() == target.getId()) continue;
 132             if (target.isDependantOn(other)) {
 133                 if (!visited.contains(other)) {
 134                     classes.addAll(BundleScanner.loadClasses(
 135                             other.getExportedAnnotatedClasses(pattern), initBundle));
 136                     visited.add(other);
 137                     processAnnotatedClassesInternal(other, bundlesToScan,
 138                             pattern, visited, classes, initBundle);
 139                 }
 140             }
 141         }
 142     }
 143
 144     private boolean isDependantOn(BundleInfo other) {
 145         for (String pkg : importPkgs) {
 146             if (other.exportPkgs.contains(pkg)) return true;
 147         }
 148         return false;
 149     }
 150
 151     public List<BundleInfo> getDependencies(Collection<BundleInfo> bundles) {
 152         List<BundleInfo> result = new ArrayList<BundleInfo>();
 153         for(BundleInfo bundle : bundles) {
 154             if (isDependantOn(bundle)) result.add(bundle);
 155         }
 156         return result;
 157     }
 158
 159
 160     private static Set<String> parsePackages(String packageString) {
 161         if (packageString == null) return Collections.emptySet();
 162         String[] packages = packageString.split(",");
 163         Set<String> result = new HashSet<String>();
 164         for (int i=0; i<packages.length; i++) {
 165             String[] nameAndAttrs = packages[i].split(";");
 166             String packageName = nameAndAttrs[0].trim();
 167             result.add(packageName);
 168         }
 169         return result;
 170     }
 171
 172 }