org.aspectj.weaver.CustomMungerFactory Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of org.apache.servicemix.bundles.aspectj

This OSGi bundle wraps aspectjrt and aspectjweaver ${pkgVersion} jar files.

There is a newer version: 1.9.21.1_1

/* *******************************************************************
 * Copyright (c) 2007 Contributors
 * All rights reserved.
 * This program and the accompanying materials are made available
 * under the terms of the Eclipse Public License v 2.0
 * which accompanies this distribution and is available at
 * https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.txt
 *
 * Contributors:
 *     Linton Ye https://bugs.eclipse.org/bugs/show_bug.cgi?id=193065
 * ******************************************************************/

package org.aspectj.weaver;

import java.util.Collection;

/**
 * 
 * This interface is introduced to support tools like PointcutDoctor.
 * 
 * 
 * A CustomMungerFactory is used to create ShadowMungers and/or ConcreteTypeMungers so that an extender can extract extra
 * information during the weaving process.
 * 
 * 
 * A CustomMungerFactory is assigned to a weaver through its AjCompiler in extenders' code, and gets invoked by the weaver right
 * before the weaving starts. The custom shadow/type mungers being created will be added into the shadow/type munger list in the
 * weaver and participate the weaving process. For example, the match method of each custom shadow munger will be called against
 * each shadow.
 * 
 *
 * @author lintonye
 *
 */
public interface CustomMungerFactory {

	/**
	 * @param aspectType
	 * @return a Collection<ShadowMunger> of custom shadow mungers for the given aspect
	 */
	Collection createCustomShadowMungers(ResolvedType aspectType);

	/**
	 * @param aspectType
	 * @return a Collection<ConcreteTypeMunger> of custom type mungers for the given aspect
	 */
	Collection createCustomTypeMungers(ResolvedType aspectType);

	Collection getAllCreatedCustomShadowMungers();

	Collection getAllCreatedCustomTypeMungers();
}