1b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato/* 2b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * ProGuard -- shrinking, optimization, obfuscation, and preverification 3b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * of Java bytecode. 4b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * 59f606f95f03a75961498803e24bee6799a7c0885Ying Wang * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) 6b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * 7b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * This program is free software; you can redistribute it and/or modify it 8b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * under the terms of the GNU General Public License as published by the Free 9b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * Software Foundation; either version 2 of the License, or (at your option) 10b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * any later version. 11b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * 12b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * This program is distributed in the hope that it will be useful, but WITHOUT 13b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 14b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for 15b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * more details. 16b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * 17b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * You should have received a copy of the GNU General Public License along 18b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * with this program; if not, write to the Free Software Foundation, Inc., 19b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 20b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato */ 21b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onoratopackage proguard.obfuscate; 22b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato 23b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato 24b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato/** 25b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * This interface specifies methods to process name mappings between original 26b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * classes and their obfuscated versions. The mappings are typically read 27b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * from a mapping file. 28b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * 29b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * @see MappingReader 30b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * 31b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * @author Eric Lafortune 32b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato */ 33b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onoratopublic interface MappingProcessor 34b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato{ 35b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato /** 36b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * Processes the given class name mapping. 37b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * 38b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * @param className the original class name. 39b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * @param newClassName the new class name. 40b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * @return whether the processor is interested in receiving mappings of the 41b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * class members of this class. 42b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato */ 43b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato public boolean processClassMapping(String className, 44b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato String newClassName); 45b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato 46b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato /** 47b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * Processes the given field name mapping. 48b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * 49b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * @param className the original class name. 50b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * @param fieldType the original external field type. 51b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * @param fieldName the original field name. 52b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * @param newFieldName the new field name. 53b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato */ 54b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato public void processFieldMapping(String className, 55b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato String fieldType, 56b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato String fieldName, 57b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato String newFieldName); 58b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato 59b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato /** 60b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * Processes the given method name mapping. 61b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * 62b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * @param className the original class name. 63b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * @param firstLineNumber the first line number of the method, or 0 if it 64b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * is not known. 65b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * @param lastLineNumber the last line number of the method, or 0 if it 66b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * is not known. 67b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * @param methodReturnType the original external method return type. 68b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * @param methodName the original external method name. 69b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * @param methodArguments the original external method arguments. 70b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato * @param newMethodName the new method name. 71b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato */ 72b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato public void processMethodMapping(String className, 73b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato int firstLineNumber, 74b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato int lastLineNumber, 75b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato String methodReturnType, 76b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato String methodName, 77b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato String methodArguments, 78b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato String newMethodName); 79b72c5c2e5482cf10117b2b25f642f7616b2326c3Joe Onorato} 80