org.aspectj.weaver.loadtime.ClassPreProcessor Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of aspectjtools Show documentation

AspectJ tools most notably contains the AspectJ compiler (AJC). AJC applies aspects to Java classes during compilation, fully replacing Javac for plain Java classes and also compiling native AspectJ or annotation-based @AspectJ syntax. Furthermore, AJC can weave aspects into existing class files in a post-compile binary weaving step. This library is a superset of AspectJ weaver and hence also of AspectJ runtime.

There is a newer version: 1.9.22.1

Show newest version

/*******************************************************************************
 * Copyright (c) 2005,2018 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
 *******************************************************************************/
package org.aspectj.weaver.loadtime;

import java.security.ProtectionDomain;

/**
 * Generic class pre processor interface that allows to separate the AspectJ 5 load time weaving from Java 5 JVMTI interfaces for
 * further use on Java 1.3 / 1.4
 *
 * @author Alexandre Vasseur
 * @author Andy Clement
 */
public interface ClassPreProcessor {

	/**
	 * Post constructor initialization, usually empty
	 */
	void initialize();

	/**
	 * @param className        the name of the class in the internal form of fully qualified class and interface names as
	 *                         defined in The Java Virtual Machine Specification. For example,
	 *                         "java/util/List".
	 * @param bytes            the input byte buffer in class file format - must not be modified
	 * @param classLoader      the defining loader of the class to be transformed, may be {@code null} if the bootstrap
	 *                         loader
	 * @param protectionDomain the protection domain of the class being defined or redefined
	 *
	 * @return a well-formed class file buffer (weaving result), or {@code null} if no weaving was performed
	 *
	 * @see java.lang.instrument.ClassFileTransformer#transform(ClassLoader, String, Class, ProtectionDomain, byte[])
	 */
	byte[] preProcess(String className, final byte[] bytes, ClassLoader classLoader, ProtectionDomain protectionDomain);

	void prepareForRedefinition(ClassLoader loader, String className);
}