plugins/org.eclipse.objectteams.otequinox/src/org/eclipse/objectteams/internal/osgi/weaving/AspectBinding.java - objectteams/org.eclipse.objectteams - Git at Google

 /**********************************************************************
  * This file is part of "Object Teams Development Tooling"-Software
  *
  * Copyright 2009, 2019 Germany and Technical University Berlin, Germany and others.
  *
  * This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License 2.0
  * which accompanies this distribution, and is available at
  * https://www.eclipse.org/legal/epl-2.0/
  *
  * SPDX-License-Identifier: EPL-2.0
  *
  * Please visit http://www.eclipse.org/objectteams for updates and contact.
  *
  * Contributors:
  * 		Technical University Berlin - Initial API and implementation
  * 		Stephan Herrmann - Initial API and implementation
  **********************************************************************/
 package org.eclipse.objectteams.internal.osgi.weaving;

 import static org.eclipse.objectteams.otequinox.TransformerPlugin.log;

 import java.io.IOException;
 import java.io.InputStream;
 import java.util.ArrayList;
 import java.util.Collection;
 import java.util.HashMap;
 import java.util.HashSet;
 import java.util.List;
 import java.util.Map;
 import java.util.Set;

 import org.eclipse.core.runtime.IConfigurationElement;
 import org.eclipse.core.runtime.IStatus;
 import org.eclipse.jdt.annotation.NonNull;
 import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.eclipse.jdt.annotation.Nullable;
 import org.eclipse.objectteams.internal.osgi.weaving.DelegatingTransformer.OTAgentNotInstalled;
 import org.eclipse.objectteams.internal.osgi.weaving.OTWeavingHook.WeavingScheme;
 import org.eclipse.objectteams.internal.osgi.weaving.Util.ProfileKind;
 import org.eclipse.objectteams.otequinox.ActivationKind;
 import org.eclipse.objectteams.otequinox.AspectPermission;
 import org.eclipse.objectteams.otequinox.TransformerPlugin;
 import org.objectteams.Team;
 import org.osgi.framework.Bundle;
 import org.osgi.framework.hooks.weaving.WovenClass;
 import org.osgi.framework.namespace.PackageNamespace;
 import org.osgi.framework.wiring.BundleRevision;
 import org.osgi.framework.wiring.BundleWiring;
 import org.osgi.resource.Capability;

 /**
  * Each instance of this class represents the information read from one extension to org.eclipse.objectteams.otequinox.aspectBindings.
  * Already during {@link AspectBindingRegistry#loadAspectBindings()} the string based information is resolved into instances
  * of {@link TeamBinding} and {@link BaseBundle}.
  * @author stephan
  * @since 1.3.0 (was a nested class before that)
  */
 @NonNullByDefault
 public class AspectBinding {

 	/**
 	 * Attribute for exports and dynamic imports making the team visible to its adapted base classes.
 	 * The bundle id of the aspect bundle is used as the attribute value to disambiguate between
 	 * multiple same-names packages from different bundles.
 	 */
 	static final String OT_ASPECT_HOST_ATTRIBUTE = "ot-aspect-host";

 	class TeamBinding {

 		String teamName;
 		@Nullable Class<? extends Team> teamClass;
 		@Nullable Team instance;

 		@Nullable String superTeamName;
 		@Nullable TeamBinding superTeam;
 		final List<TeamBinding> subTeams = new ArrayList<>();
 		Set<TeamBinding> equivalenceSet = new HashSet<>();

 		private ActivationKind activation; // clients must use accessor getActivation()!
 		boolean hasScannedBases;
 		boolean hasScannedRoles;
 		@Nullable AspectPermission checkedPermission; // null means: not yet checked

 		boolean isActivated;

 		boolean importsAdded;
 		boolean importsAddedToSuper;
 		boolean importsAddedToSub;

 		final Set<String> baseClassNames = new HashSet<>();

 		public final List<String> superBases = new ArrayList<>(); // logging / debugging only

 		public TeamBinding(String teamName, ActivationKind activationKind, @Nullable String superTeamName) {
 			this.teamName = teamName;
 			this.activation = activationKind;
 			this.superTeamName = superTeamName;
 			this.equivalenceSet.add(this);
 		}

 		AspectBinding getAspectBinding() {
 			return AspectBinding.this;
 		}

 		/** After scanning class file attributes: add the names of all bound base classes. */
 		public void addBaseClassNames(Collection<String> baseClassNames) {
 			AspectBinding.this.allBaseClassNames.addAll(baseClassNames);
 			for (String baseClassName : baseClassNames) {
 				if (this.baseClassNames.add(baseClassName)) {
 					Set<TeamBinding> teams = baseBundle.teamsPerBase.get(baseClassName);
 					if (teams == null)
 						baseBundle.teamsPerBase.put(baseClassName, teams = new HashSet<>());
 					teams.add(this);
 				}
 			}
 		}

 		void connectEquivalent(TeamBinding equivalent) {
 			if (this == equivalent)
 				return;
 			if (!this.equivalenceSet.add(equivalent))
 				return;
 			boolean locallyHaveBases = !this.baseClassNames.isEmpty();
 			if (!equivalent.baseClassNames.isEmpty())
 				this.addBaseClassNames(equivalent.baseClassNames);
 			if (locallyHaveBases)
 				equivalent.addBaseClassNames(this.baseClassNames);
 		}

 		@SuppressWarnings("unchecked")
 		public @Nullable Class<? extends Team> loadTeamClass() {
 			if (teamClass != null) return teamClass;
 			for (String candidate : TeamLoader.possibleTeamNames(teamName)) {
 				try {
 					Bundle aspectBundle = AspectBinding.this.aspectBundle;
 					if (aspectBundle != null) {
 						Class<?> result = aspectBundle.loadClass(candidate);
 						if (result != null)
 							return this.teamClass = (Class<? extends Team>) result;
 					}
 				} catch (NoClassDefFoundError|ClassNotFoundException e) {
 					e.printStackTrace();
 					// keep looking
 				}
 			}
 			return null;
 		}

 		/**
 		 * Add imports to this team's package into the bundle of the given base class.
 		 * @param baseClass
 		 * @param direction 1 means traveling to supers, -1 means traveling to subs, 0 comprises both
 		 */
 		public void addImportTo(WovenClass baseClass, int direction) {
 			importsAdded = true;
 			if (AspectBinding.this.hasBeenDenied) return;

 			String packageOfTeam = "";
 			int dot = teamName.lastIndexOf('.'); // TODO: can we detect if thats really the package (vs. Outer.Inner)?
 			if (dot != -1)
 				packageOfTeam = teamName.substring(0, dot);
 			String packageWithAttribute = packageOfTeam+";"+OT_ASPECT_HOST_ATTRIBUTE+"=\""+aspectPlugin+"\"";

 			if (!OTWeavingHook.hasImport(baseClass, packageOfTeam, packageWithAttribute)) {
 				checkExported: {
 					List<String> imports = baseClass.getDynamicImports();
 					Bundle aspectBundle = AspectBinding.this.aspectBundle;
 					@Nullable BundleRevision bundleRevision = aspectBundle != null ? aspectBundle.adapt(BundleRevision.class) : null;
 					if (bundleRevision != null) { // catch uninstalled state
 						for (Capability capability : bundleRevision.getCapabilities(PackageNamespace.PACKAGE_NAMESPACE)) {
 							Object exported = capability.getAttributes().get(PackageNamespace.PACKAGE_NAMESPACE);
 							if (exported instanceof String && exported.equals(packageOfTeam)) {
 								if (capability.getAttributes().containsKey(OT_ASPECT_HOST_ATTRIBUTE)) {
 									imports.add(packageWithAttribute);
 								} else {
 									log(IStatus.WARNING, "Package "+packageOfTeam+" for team "+teamName.substring(dot+1)+" is exported without an 'ot-aspect-host' attribute.");
 									imports.add(packageOfTeam);
 								}
 								break checkExported;
 							}
 						}
 						log(IStatus.ERROR, "Package "+packageOfTeam+" for team "+teamName.substring(dot+1)+" is not exported by its bundle "+aspectPlugin);
 					} else {
 						log(IStatus.WARNING, "Can't check exporting of "+teamName+", bundle information for "+aspectPlugin+" is not available");
 					}
 				}
 				log(IStatus.INFO, "Added dependency from base "+baseClass.getClassName()+" to package '"+packageOfTeam+"'");
 			}
 			if (direction != -1) {
 				importsAddedToSuper = true;
 				final TeamBinding superTeam2 = superTeam;
 				if (superTeam2 != null)
 					superTeam2.addImportTo(baseClass, 1);
 			}
 			if (direction != 1) {
 				importsAddedToSub = true;
 				for (TeamBinding subTeam : subTeams)
 					subTeam.addImportTo(baseClass, -1);
 			}
 		}

 		/** Has all work for this team been done? */
 		public boolean isDone() { // TODO travel up/down?
 			if (activation != ActivationKind.NONE && !isActivated)
 				return false;
 			if (!(importsAdded && importsAddedToSub && importsAddedToSuper))
 				return false;
 			return true;
 		}

 		@Override
 		public String toString() {
 			String result = "team "+teamName+"("+(this.activation)+") super "+superTeamName;
 			for (String superBase : superBases)
 				result += "\n\t\t\tsuperBase "+superBase;
 			return result;
 		}

 		/** Get the highest activation kind from this team and its equivalents. */
 		public ActivationKind getActivation() {
 			ActivationKind activation = this.activation;
 			for (TeamBinding equiv : this.equivalenceSet) {
 				if (equiv.activation.ordinal() > activation.ordinal())
 					activation = equiv.activation;
 			}
 			return activation;
 		}

 		public @Nullable TeamBinding getOtherTeamToActivate() {
 			TeamBinding superTeam = this.superTeam;
 			if (superTeam != null && superTeam.getActivation() != ActivationKind.NONE) {
 				return superTeam;
 			}
 			// sub teams?
 			return null;
 		}

 		public boolean hasBeenDenied() {
 			return this.checkedPermission == AspectPermission.DENY
 						|| AspectBinding.this.hasBeenDenied;
 		}

 		/** Precondition: teamClass is set. Create fresh or answer existing. */
 		public Team getInstance() throws InstantiationException, IllegalAccessException {
 			for (TeamBinding equalivalent : this.equivalenceSet) {
 				Team inst = equalivalent.instance;
 				if (inst != null)
 					return inst;
 			}
 			Class<? extends Team> cl = this.teamClass;
 			assert cl != null : "Precondition";
 			Team nnInst = cl.newInstance();
 			TransformerPlugin.registerTeamInstance(nnInst);
 			log(IStatus.INFO, "Instantiated team "+teamName);
 			return this.instance = nnInst;
 		}
 	}

 	/**
 	 * Represents a base bundle against which one or more aspectBindings are declared.
 	 * Used to find all teams affecting any given base class in this base bundle.
 	 */
 	static class BaseBundle {
 		String bundleName;
 		/** Team classes indexed by base classes that should trigger activating the team. */
 		final Map<String, Set<TeamBinding>> teamsPerBase = new HashMap<>();

 		public BaseBundle(String bundleName) {
 			this.bundleName = bundleName;
 		}
 	}

 	public String aspectPlugin;
 	public @Nullable Bundle aspectBundle; // null if we don't have a PackageAdmin for bundle lookup
 	public String basePluginName;
 	public BaseBundle baseBundle;
 	public @NonNull IConfigurationElement[] forcedExports;
 	public TeamBinding[]   teams;
 	public Set<String> allBaseClassNames = new HashSet<>();

 	public boolean hasScannedTeams;
 	public AspectPermission forcedExportsPermission = AspectPermission.UNDEFINED;
 	public boolean hasBeenDenied = false;
 	public WeavingScheme weavingScheme = WeavingScheme.Unknown;

 	Set<TeamBinding> teamsInProgress = new HashSet<>(); // TODO cleanup teams that are done

 	public AspectBinding(String aspectId, @Nullable Bundle aspectBundle, BaseBundle baseBundle, @NonNull IConfigurationElement[] forcedExportsConfs, int count)
 	{
 		this.aspectPlugin= aspectId;
 		this.aspectBundle= aspectBundle;
 		this.baseBundle=     baseBundle;
 		this.basePluginName= baseBundle.bundleName;
 		this.forcedExports= forcedExportsConfs;

 		this.teams = new TeamBinding[count];
 	}

 	/** Create an initial (unconnected) resolved team binding. */
 	public TeamBinding createResolvedTeam(int count, String teamName, @Nullable String activationSpecifier, @Nullable String superTeamName) throws OTAgentNotInstalled {
 		@NonNull ActivationKind kind = ActivationKind.NONE;
 		try {
 			if (activationSpecifier != null)
 				kind = ActivationKind.valueOf(activationSpecifier);
 		} catch (IllegalArgumentException iae) {
 			log(iae, "Invalid activation kind "+activationSpecifier+" for team "+teamName);
 		}
 		checkWeavingScheme(teamName);
 		return this.teams[count] = new TeamBinding(teamName, kind, superTeamName);
 	}

 	private void checkWeavingScheme(String className) throws OTAgentNotInstalled {
 		if (this.weavingScheme != WeavingScheme.Unknown)
 			return;
 		Bundle bundle = this.aspectBundle;
 		if (bundle == null)
 			return;
 		@Nullable BundleWiring wiring = bundle.adapt(BundleWiring.class);
 		ClassLoader classLoader = wiring.getClassLoader();
 		if (classLoader == null)
 			return;
 		try (InputStream classStream = classLoader.getResourceAsStream(className.replace('.', '/')+".class")) {
 			this.weavingScheme = ASMByteCodeAnalyzer.determineWeavingScheme(classStream, className);
 			if (OTWeavingHook.DEFAULT_WEAVING_SCHEME == WeavingScheme.Unknown) {
 				OTWeavingHook.DEFAULT_WEAVING_SCHEME = this.weavingScheme;
 				TransformerPlugin.doLog(IStatus.INFO, "Using weaving scheme "+this.weavingScheme+" as detected from class "+className);
 				DelegatingTransformer.checkAgentAvailability(this.weavingScheme);
 			}
 			TransformerPlugin.log(IStatus.INFO, "use weaving scheme "+this.weavingScheme+" for aspectBinding "+this.aspectPlugin+"<-"+this.basePluginName);
 		} catch (IOException e) {
 			// ignore
 		}
 	}

 	/** Connect all resolvable info in all contained TeamBindings using the given lookup table. */
 	public void connect(Map<String, Set<TeamBinding>> teamLookup) {
 		for (int i = 0; i < teams.length; i++) {
 			TeamBinding team = teams[i];

 			// do we have TeamBindings representing the same team class (from different aspect bindings)?
 			Set<TeamBinding> equivalenceSet = teamLookup.get(team.teamName);
 			if (equivalenceSet != null) {
 				for (TeamBinding equivalent : equivalenceSet)
 					team.connectEquivalent(equivalent); // TODO: nullness will be handled from Set<@NonNull TeamBinding>
 			}
 			if (team.equivalenceSet.size() > 1)
 				log(IStatus.INFO, "team "+team.teamName+" participates in "+team.equivalenceSet.size()+" aspect bindings.");

 			if (team.superTeamName != null) {
 				Set<TeamBinding> superTeams = teamLookup.get(team.superTeamName);
 				if (superTeams != null) {
 					for (TeamBinding superTeam : superTeams) {
 						team.superTeam = superTeam;
 						superTeam.subTeams.add(team);
 					}
 				} else {
 					Exception e = new Exception("No such aspect binding");
 					log(e, "Class "+team.superTeamName+" not registered (declared to be superclass of team "+team.teamName);
 				}
 			}
 		}
 	}

 	/** Answer the names of teams to load for a given base class. */
 	public synchronized @Nullable Collection<TeamBinding> getTeamsForBase(String baseClassName) {
 		Set<TeamBinding> teams = baseBundle.teamsPerBase.get(baseClassName);
 		// in case any team cannot immediately be instantiated/activated
 		// it will be added to the next queue: OTWeavingHook.deferredTeams.
 		if (teams != null) {
 			teams =  new HashSet<>(teams);
 			teams.removeAll(teamsInProgress); // no double-triggering
 			teamsInProgress.addAll(teams);
 		}
 		return teams;
 	}

 	/**
 	 * Read OT attributes of all teams in this aspectBinding
 	 * and collect affected base classes into the teamBindings.
 	 * @return the names of all base classes bound via this aspect binding
 	 */
 	public synchronized Collection<String> scanTeamClasses(Bundle bundle, DelegatingTransformer transformer) {
 		long time = 0;
 		if (Util.PROFILE) time= System.nanoTime();
 		ClassScanner scanner = new ClassScanner();
 		for (TeamBinding team : getAllTeamBindings()) {
 			if (team.hasScannedBases) { // not a surprise for members of equivalentSet or classes already processed by weave()
 				if (!team.hasScannedRoles) { // weave() only scans bases, not roles!
 					team.hasScannedRoles = true;
 					scanner.readMemberTypeAttributes(bundle, team.teamName, transformer);
 				}
 				continue;
 			}
 			team.hasScannedBases = true;
 			team.hasScannedRoles = true;
 			try {
 				String teamName = scanner.readOTAttributes(bundle, team.teamName, transformer);
 				Collection<String> baseClassNames = scanner.getCollectedBaseClassNames();
 				if (team.baseClassNames.isEmpty()) {
 					for (TeamBinding equivalent : team.equivalenceSet)
 						equivalent.addBaseClassNames(baseClassNames);
 				}
 				log(IStatus.INFO, "Scanned team class "+teamName+", found "+baseClassNames.size()+" base classes");
 			} catch (Exception e) {
 				log(e, "Failed to scan team class "+team.teamName);
 			}
 		}
 		this.hasScannedTeams = true;
 		if (Util.PROFILE) Util.profile(time, ProfileKind.Scan, bundle.getSymbolicName());
 		return this.allBaseClassNames;
 	}

 	private List<TeamBinding> getAllTeamBindings() {
 		List<TeamBinding> all = new ArrayList<>();
 		for (TeamBinding team : teams)
 			if (team != null)
 				all.add(team);
 		for (int i = 0; i < teams.length; i++) {
 			TeamBinding superTeam = teams[i].superTeam;
 			if (superTeam != null)
 				all.add(superTeam);
 			all.addAll(teams[i].subTeams);
 		}
 		return all;
 	}

 	/** Add all require imports to match the hidden reverse dependency created by any team binding to this base class. */
 	public void addImports(WovenClass baseClass) {
 		String baseClassName = baseClass.getClassName();
 		Set<TeamBinding> teams = baseBundle.teamsPerBase.get(baseClassName);
 		if (teams != null)
 			for (TeamBinding resolvedTeam : teams)
 				resolvedTeam.addImportTo(baseClass, 0); // 0 = travel both directions (sub/super)
 	}

 	public void cleanUp(String baseClass) {
 		baseBundle.teamsPerBase.remove(baseClass);
 	}

 	public boolean isDone() {
 		for (int i = 0; i < teams.length; i++)
 			if (!teams[i].isDone())
 				return false;
 		return true;
 	}

 	public String toString() {
 		String result = "\tbase plugin "+basePluginName+"\n\tadapted by aspect pluging "+aspectPlugin;
 		for (TeamBinding team : teams)
 			result += "\n\t\t "+team.toString();
 		return result;
 	}
 }
	/**********************************************************************
	* This file is part of "Object Teams Development Tooling"-Software
	*
	* Copyright 2009, 2019 Germany and Technical University Berlin, Germany and others.
	*
	* This program and the accompanying materials
	* are made available under the terms of the Eclipse Public License 2.0
	* which accompanies this distribution, and is available at
	* https://www.eclipse.org/legal/epl-2.0/
	*
	* SPDX-License-Identifier: EPL-2.0
	*
	* Please visit http://www.eclipse.org/objectteams for updates and contact.
	*
	* Contributors:
	* Technical University Berlin - Initial API and implementation
	* Stephan Herrmann - Initial API and implementation
	**********************************************************************/
	package org.eclipse.objectteams.internal.osgi.weaving;

	import static org.eclipse.objectteams.otequinox.TransformerPlugin.log;

	import java.io.IOException;
	import java.io.InputStream;
	import java.util.ArrayList;
	import java.util.Collection;
	import java.util.HashMap;
	import java.util.HashSet;
	import java.util.List;
	import java.util.Map;
	import java.util.Set;

	import org.eclipse.core.runtime.IConfigurationElement;
	import org.eclipse.core.runtime.IStatus;
	import org.eclipse.jdt.annotation.NonNull;
	import org.eclipse.jdt.annotation.NonNullByDefault;
	import org.eclipse.jdt.annotation.Nullable;
	import org.eclipse.objectteams.internal.osgi.weaving.DelegatingTransformer.OTAgentNotInstalled;
	import org.eclipse.objectteams.internal.osgi.weaving.OTWeavingHook.WeavingScheme;
	import org.eclipse.objectteams.internal.osgi.weaving.Util.ProfileKind;
	import org.eclipse.objectteams.otequinox.ActivationKind;
	import org.eclipse.objectteams.otequinox.AspectPermission;
	import org.eclipse.objectteams.otequinox.TransformerPlugin;
	import org.objectteams.Team;
	import org.osgi.framework.Bundle;
	import org.osgi.framework.hooks.weaving.WovenClass;
	import org.osgi.framework.namespace.PackageNamespace;
	import org.osgi.framework.wiring.BundleRevision;
	import org.osgi.framework.wiring.BundleWiring;
	import org.osgi.resource.Capability;

	/**
	* Each instance of this class represents the information read from one extension to org.eclipse.objectteams.otequinox.aspectBindings.
	* Already during {@link AspectBindingRegistry#loadAspectBindings()} the string based information is resolved into instances
	* of {@link TeamBinding} and {@link BaseBundle}.
	* @author stephan
	* @since 1.3.0 (was a nested class before that)
	*/
	@NonNullByDefault
	public class AspectBinding {

	/**
	* Attribute for exports and dynamic imports making the team visible to its adapted base classes.
	* The bundle id of the aspect bundle is used as the attribute value to disambiguate between
	* multiple same-names packages from different bundles.
	*/
	static final String OT_ASPECT_HOST_ATTRIBUTE = "ot-aspect-host";

	class TeamBinding {

	String teamName;
	@Nullable Class<? extends Team> teamClass;
	@Nullable Team instance;

	@Nullable String superTeamName;
	@Nullable TeamBinding superTeam;
	final List<TeamBinding> subTeams = new ArrayList<>();
	Set<TeamBinding> equivalenceSet = new HashSet<>();

	private ActivationKind activation; // clients must use accessor getActivation()!
	boolean hasScannedBases;
	boolean hasScannedRoles;
	@Nullable AspectPermission checkedPermission; // null means: not yet checked

	boolean isActivated;

	boolean importsAdded;
	boolean importsAddedToSuper;
	boolean importsAddedToSub;

	final Set<String> baseClassNames = new HashSet<>();

	public final List<String> superBases = new ArrayList<>(); // logging / debugging only

	public TeamBinding(String teamName, ActivationKind activationKind, @Nullable String superTeamName) {
	this.teamName = teamName;
	this.activation = activationKind;
	this.superTeamName = superTeamName;
	this.equivalenceSet.add(this);
	}

	AspectBinding getAspectBinding() {
	return AspectBinding.this;
	}

	/** After scanning class file attributes: add the names of all bound base classes. */
	public void addBaseClassNames(Collection<String> baseClassNames) {
	AspectBinding.this.allBaseClassNames.addAll(baseClassNames);
	for (String baseClassName : baseClassNames) {
	if (this.baseClassNames.add(baseClassName)) {
	Set<TeamBinding> teams = baseBundle.teamsPerBase.get(baseClassName);
	if (teams == null)
	baseBundle.teamsPerBase.put(baseClassName, teams = new HashSet<>());
	teams.add(this);
	}
	}
	}

	void connectEquivalent(TeamBinding equivalent) {
	if (this == equivalent)
	return;
	if (!this.equivalenceSet.add(equivalent))
	return;
	boolean locallyHaveBases = !this.baseClassNames.isEmpty();
	if (!equivalent.baseClassNames.isEmpty())
	this.addBaseClassNames(equivalent.baseClassNames);
	if (locallyHaveBases)
	equivalent.addBaseClassNames(this.baseClassNames);
	}

	@SuppressWarnings("unchecked")
	public @Nullable Class<? extends Team> loadTeamClass() {
	if (teamClass != null) return teamClass;
	for (String candidate : TeamLoader.possibleTeamNames(teamName)) {
	try {
	Bundle aspectBundle = AspectBinding.this.aspectBundle;
	if (aspectBundle != null) {
	Class<?> result = aspectBundle.loadClass(candidate);
	if (result != null)
	return this.teamClass = (Class<? extends Team>) result;
	}
	} catch (NoClassDefFoundError\|ClassNotFoundException e) {
	e.printStackTrace();
	// keep looking
	}
	}
	return null;
	}

	/**
	* Add imports to this team's package into the bundle of the given base class.
	* @param baseClass
	* @param direction 1 means traveling to supers, -1 means traveling to subs, 0 comprises both
	*/
	public void addImportTo(WovenClass baseClass, int direction) {
	importsAdded = true;
	if (AspectBinding.this.hasBeenDenied) return;

	String packageOfTeam = "";
	int dot = teamName.lastIndexOf('.'); // TODO: can we detect if thats really the package (vs. Outer.Inner)?
	if (dot != -1)
	packageOfTeam = teamName.substring(0, dot);
	String packageWithAttribute = packageOfTeam+";"+OT_ASPECT_HOST_ATTRIBUTE+"=\""+aspectPlugin+"\"";

	if (!OTWeavingHook.hasImport(baseClass, packageOfTeam, packageWithAttribute)) {
	checkExported: {
	List<String> imports = baseClass.getDynamicImports();
	Bundle aspectBundle = AspectBinding.this.aspectBundle;
	@Nullable BundleRevision bundleRevision = aspectBundle != null ? aspectBundle.adapt(BundleRevision.class) : null;
	if (bundleRevision != null) { // catch uninstalled state
	for (Capability capability : bundleRevision.getCapabilities(PackageNamespace.PACKAGE_NAMESPACE)) {
	Object exported = capability.getAttributes().get(PackageNamespace.PACKAGE_NAMESPACE);
	if (exported instanceof String && exported.equals(packageOfTeam)) {
	if (capability.getAttributes().containsKey(OT_ASPECT_HOST_ATTRIBUTE)) {
	imports.add(packageWithAttribute);
	} else {
	log(IStatus.WARNING, "Package "+packageOfTeam+" for team "+teamName.substring(dot+1)+" is exported without an 'ot-aspect-host' attribute.");
	imports.add(packageOfTeam);
	}
	break checkExported;
	}
	}
	log(IStatus.ERROR, "Package "+packageOfTeam+" for team "+teamName.substring(dot+1)+" is not exported by its bundle "+aspectPlugin);
	} else {
	log(IStatus.WARNING, "Can't check exporting of "+teamName+", bundle information for "+aspectPlugin+" is not available");
	}
	}
	log(IStatus.INFO, "Added dependency from base "+baseClass.getClassName()+" to package '"+packageOfTeam+"'");
	}
	if (direction != -1) {
	importsAddedToSuper = true;
	final TeamBinding superTeam2 = superTeam;
	if (superTeam2 != null)
	superTeam2.addImportTo(baseClass, 1);
	}
	if (direction != 1) {
	importsAddedToSub = true;
	for (TeamBinding subTeam : subTeams)
	subTeam.addImportTo(baseClass, -1);
	}
	}

	/** Has all work for this team been done? */
	public boolean isDone() { // TODO travel up/down?
	if (activation != ActivationKind.NONE && !isActivated)
	return false;
	if (!(importsAdded && importsAddedToSub && importsAddedToSuper))
	return false;
	return true;
	}

	@Override
	public String toString() {
	String result = "team "+teamName+"("+(this.activation)+") super "+superTeamName;
	for (String superBase : superBases)
	result += "\n\t\t\tsuperBase "+superBase;
	return result;
	}

	/** Get the highest activation kind from this team and its equivalents. */
	public ActivationKind getActivation() {
	ActivationKind activation = this.activation;
	for (TeamBinding equiv : this.equivalenceSet) {
	if (equiv.activation.ordinal() > activation.ordinal())
	activation = equiv.activation;
	}
	return activation;
	}

	public @Nullable TeamBinding getOtherTeamToActivate() {
	TeamBinding superTeam = this.superTeam;
	if (superTeam != null && superTeam.getActivation() != ActivationKind.NONE) {
	return superTeam;
	}
	// sub teams?
	return null;
	}

	public boolean hasBeenDenied() {
	return this.checkedPermission == AspectPermission.DENY
	\|\| AspectBinding.this.hasBeenDenied;
	}

	/** Precondition: teamClass is set. Create fresh or answer existing. */
	public Team getInstance() throws InstantiationException, IllegalAccessException {
	for (TeamBinding equalivalent : this.equivalenceSet) {
	Team inst = equalivalent.instance;
	if (inst != null)
	return inst;
	}
	Class<? extends Team> cl = this.teamClass;
	assert cl != null : "Precondition";
	Team nnInst = cl.newInstance();
	TransformerPlugin.registerTeamInstance(nnInst);
	log(IStatus.INFO, "Instantiated team "+teamName);
	return this.instance = nnInst;
	}
	}

	/**
	* Represents a base bundle against which one or more aspectBindings are declared.
	* Used to find all teams affecting any given base class in this base bundle.
	*/
	static class BaseBundle {
	String bundleName;
	/** Team classes indexed by base classes that should trigger activating the team. */
	final Map<String, Set<TeamBinding>> teamsPerBase = new HashMap<>();

	public BaseBundle(String bundleName) {
	this.bundleName = bundleName;
	}
	}

	public String aspectPlugin;
	public @Nullable Bundle aspectBundle; // null if we don't have a PackageAdmin for bundle lookup
	public String basePluginName;
	public BaseBundle baseBundle;
	public @NonNull IConfigurationElement[] forcedExports;
	public TeamBinding[] teams;
	public Set<String> allBaseClassNames = new HashSet<>();

	public boolean hasScannedTeams;
	public AspectPermission forcedExportsPermission = AspectPermission.UNDEFINED;
	public boolean hasBeenDenied = false;
	public WeavingScheme weavingScheme = WeavingScheme.Unknown;

	Set<TeamBinding> teamsInProgress = new HashSet<>(); // TODO cleanup teams that are done

	public AspectBinding(String aspectId, @Nullable Bundle aspectBundle, BaseBundle baseBundle, @NonNull IConfigurationElement[] forcedExportsConfs, int count)
	{
	this.aspectPlugin= aspectId;
	this.aspectBundle= aspectBundle;
	this.baseBundle= baseBundle;
	this.basePluginName= baseBundle.bundleName;
	this.forcedExports= forcedExportsConfs;

	this.teams = new TeamBinding[count];
	}

	/** Create an initial (unconnected) resolved team binding. */
	public TeamBinding createResolvedTeam(int count, String teamName, @Nullable String activationSpecifier, @Nullable String superTeamName) throws OTAgentNotInstalled {
	@NonNull ActivationKind kind = ActivationKind.NONE;
	try {
	if (activationSpecifier != null)
	kind = ActivationKind.valueOf(activationSpecifier);
	} catch (IllegalArgumentException iae) {
	log(iae, "Invalid activation kind "+activationSpecifier+" for team "+teamName);
	}
	checkWeavingScheme(teamName);
	return this.teams[count] = new TeamBinding(teamName, kind, superTeamName);
	}

	private void checkWeavingScheme(String className) throws OTAgentNotInstalled {
	if (this.weavingScheme != WeavingScheme.Unknown)
	return;
	Bundle bundle = this.aspectBundle;
	if (bundle == null)
	return;
	@Nullable BundleWiring wiring = bundle.adapt(BundleWiring.class);
	ClassLoader classLoader = wiring.getClassLoader();
	if (classLoader == null)
	return;
	try (InputStream classStream = classLoader.getResourceAsStream(className.replace('.', '/')+".class")) {
	this.weavingScheme = ASMByteCodeAnalyzer.determineWeavingScheme(classStream, className);
	if (OTWeavingHook.DEFAULT_WEAVING_SCHEME == WeavingScheme.Unknown) {
	OTWeavingHook.DEFAULT_WEAVING_SCHEME = this.weavingScheme;
	TransformerPlugin.doLog(IStatus.INFO, "Using weaving scheme "+this.weavingScheme+" as detected from class "+className);
	DelegatingTransformer.checkAgentAvailability(this.weavingScheme);
	}
	TransformerPlugin.log(IStatus.INFO, "use weaving scheme "+this.weavingScheme+" for aspectBinding "+this.aspectPlugin+"<-"+this.basePluginName);
	} catch (IOException e) {
	// ignore
	}
	}

	/** Connect all resolvable info in all contained TeamBindings using the given lookup table. */
	public void connect(Map<String, Set<TeamBinding>> teamLookup) {
	for (int i = 0; i < teams.length; i++) {
	TeamBinding team = teams[i];

	// do we have TeamBindings representing the same team class (from different aspect bindings)?
	Set<TeamBinding> equivalenceSet = teamLookup.get(team.teamName);
	if (equivalenceSet != null) {
	for (TeamBinding equivalent : equivalenceSet)
	team.connectEquivalent(equivalent); // TODO: nullness will be handled from Set<@NonNull TeamBinding>
	}
	if (team.equivalenceSet.size() > 1)
	log(IStatus.INFO, "team "+team.teamName+" participates in "+team.equivalenceSet.size()+" aspect bindings.");

	if (team.superTeamName != null) {
	Set<TeamBinding> superTeams = teamLookup.get(team.superTeamName);
	if (superTeams != null) {
	for (TeamBinding superTeam : superTeams) {
	team.superTeam = superTeam;
	superTeam.subTeams.add(team);
	}
	} else {
	Exception e = new Exception("No such aspect binding");
	log(e, "Class "+team.superTeamName+" not registered (declared to be superclass of team "+team.teamName);
	}
	}
	}
	}

	/** Answer the names of teams to load for a given base class. */
	public synchronized @Nullable Collection<TeamBinding> getTeamsForBase(String baseClassName) {
	Set<TeamBinding> teams = baseBundle.teamsPerBase.get(baseClassName);
	// in case any team cannot immediately be instantiated/activated
	// it will be added to the next queue: OTWeavingHook.deferredTeams.
	if (teams != null) {
	teams = new HashSet<>(teams);
	teams.removeAll(teamsInProgress); // no double-triggering
	teamsInProgress.addAll(teams);
	}
	return teams;
	}

	/**
	* Read OT attributes of all teams in this aspectBinding
	* and collect affected base classes into the teamBindings.
	* @return the names of all base classes bound via this aspect binding
	*/
	public synchronized Collection<String> scanTeamClasses(Bundle bundle, DelegatingTransformer transformer) {
	long time = 0;
	if (Util.PROFILE) time= System.nanoTime();
	ClassScanner scanner = new ClassScanner();
	for (TeamBinding team : getAllTeamBindings()) {
	if (team.hasScannedBases) { // not a surprise for members of equivalentSet or classes already processed by weave()
	if (!team.hasScannedRoles) { // weave() only scans bases, not roles!
	team.hasScannedRoles = true;
	scanner.readMemberTypeAttributes(bundle, team.teamName, transformer);
	}
	continue;
	}
	team.hasScannedBases = true;
	team.hasScannedRoles = true;
	try {
	String teamName = scanner.readOTAttributes(bundle, team.teamName, transformer);
	Collection<String> baseClassNames = scanner.getCollectedBaseClassNames();
	if (team.baseClassNames.isEmpty()) {
	for (TeamBinding equivalent : team.equivalenceSet)
	equivalent.addBaseClassNames(baseClassNames);
	}
	log(IStatus.INFO, "Scanned team class "+teamName+", found "+baseClassNames.size()+" base classes");
	} catch (Exception e) {
	log(e, "Failed to scan team class "+team.teamName);
	}
	}
	this.hasScannedTeams = true;
	if (Util.PROFILE) Util.profile(time, ProfileKind.Scan, bundle.getSymbolicName());
	return this.allBaseClassNames;
	}

	private List<TeamBinding> getAllTeamBindings() {
	List<TeamBinding> all = new ArrayList<>();
	for (TeamBinding team : teams)
	if (team != null)
	all.add(team);
	for (int i = 0; i < teams.length; i++) {
	TeamBinding superTeam = teams[i].superTeam;
	if (superTeam != null)
	all.add(superTeam);
	all.addAll(teams[i].subTeams);
	}
	return all;
	}

	/** Add all require imports to match the hidden reverse dependency created by any team binding to this base class. */
	public void addImports(WovenClass baseClass) {
	String baseClassName = baseClass.getClassName();
	Set<TeamBinding> teams = baseBundle.teamsPerBase.get(baseClassName);
	if (teams != null)
	for (TeamBinding resolvedTeam : teams)
	resolvedTeam.addImportTo(baseClass, 0); // 0 = travel both directions (sub/super)
	}

	public void cleanUp(String baseClass) {
	baseBundle.teamsPerBase.remove(baseClass);
	}

	public boolean isDone() {
	for (int i = 0; i < teams.length; i++)
	if (!teams[i].isDone())
	return false;
	return true;
	}

	public String toString() {
	String result = "\tbase plugin "+basePluginName+"\n\tadapted by aspect pluging "+aspectPlugin;
	for (TeamBinding team : teams)
	result += "\n\t\t "+team.toString();
	return result;
	}
	}