1674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen/* 2674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * Copyright 2003 The Apache Software Foundation 3674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * 4674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * Licensed under the Apache License, Version 2.0 (the "License"); 5674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * you may not use this file except in compliance with the License. 6674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * You may obtain a copy of the License at 7674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * 8674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * http://www.apache.org/licenses/LICENSE-2.0 9674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * 10674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * Unless required by applicable law or agreed to in writing, software 11674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * distributed under the License is distributed on an "AS IS" BASIS, 12674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * See the License for the specific language governing permissions and 14674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * limitations under the License. 15674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen */ 16674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogenpackage org.mockito.cglib.core; 17674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen 18674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen/** 19674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * The <code>GeneratorStrategy</code. is responsible for taking a 20674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * {@link ClassGenerator} and producing a byte array containing the 21674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * data for the generated <code>Class</code>. By providing your 22674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * own strategy you may examine or modify the generated class before 23674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * it is loaded. Typically this will be accomplished by subclassing 24674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * {@link DefaultGeneratorStrategy} and overriding the appropriate 25674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * protected method. 26674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * @see AbstractClassGenerator#setStrategy 27674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen */ 28674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogenpublic interface GeneratorStrategy { 29674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen /** 30674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * Generate the class. 31674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * @param cg a class generator on which you can call {@link ClassGenerator#generateClass} 32674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * @return a byte array containing the bits of a valid Class 33674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen */ 34674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen byte[] generate(ClassGenerator cg) throws Exception; 35674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen 36674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen /** 37674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * The <code>GeneratorStrategy</code> in use does not currently, but may 38674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * in the future, affect the caching of classes generated by {@link 39674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * AbstractClassGenerator}, so this is a reminder that you should 40674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * correctly implement <code>equals</code> and <code>hashCode</code> 41674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen * to avoid generating too many classes. 42674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen */ 43674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen boolean equals(Object o); 44674060f01e9090cd21b3c5656cc3204912ad17a6Jon Boekenoogen} 45